# ChatGPT

Crie um app com o servidor MCP no modo desenvolvedor e entre com o ByDomu.

Guia Somente leitura OAuth

**Antes de começar.** Quem conecta precisa poder administrar as chaves de API da imobiliária, um plano Business ou superior (ou acesso aprovado pelo suporte), estar fora do teste grátis e ter o e-mail verificado.

## Ative o modo desenvolvedor

Servidores MCP próprios são adicionados no modo desenvolvedor do ChatGPT, na web, com os planos Plus, Pro, Business, Enterprise e Education. Vá em **Settings › Security and login › Developer mode** e ative. No Business, Enterprise e Education, se não aparecer, um administrador do espaço de trabalho precisa habilitar.

## Crie o app do ByDomu

- Abra Plugins e toque em + para criar um app de modo desenvolvedor para um servidor MCP.
- Nome ByDomu, URL `https://mcp.bydomu.com/mcp` e autenticação OAuth, sem ID de cliente: o ChatGPT se registra sozinho.
- Ao criar, o ChatGPT abre o ByDomu: revise a imobiliária e as permissões e toque em Permitir.

Os nomes são os da documentação da OpenAI em inglês e podem aparecer traduzidos. Se algo do servidor mudar, use Refresh no app.

## Use num chat

No chat, + › Developer mode › ByDomu. As nove ferramentas são declaradas somente leitura (readOnlyHint), então o ChatGPT não pede para confirmar cada consulta como faria com uma escrita. Pergunte, por exemplo, «Quais negócios estão em negociação e quanto somam?».

## O que não dá

- O ChatGPT não permite chaves nem cabeçalhos próprios: com o ByDomu conecta só com login (OAuth).
- A pesquisa aprofundada (deep research) só usa servidores com ferramentas chamadas search e fetch; o ByDomu não as tem, então é usado no modo desenvolvedor, não ali.
- Não cria nem muda nada no ByDomu: para isso, use a API no seu próprio código.

## O que pode fazer, como revogar e boas práticas

O servidor é somente leitura: a IA pode consultar, mas não cria, muda nem apaga nada, e nunca envia mensagens aos seus clientes. Ela só vê o que estas permissões permitem, com o limite de uma chave secreta (60 requisições por minuto).

Pode Permissão

Buscar e ver imóveis publicados `portal:read`

Buscar e ver contatos `contacts:read`

Agenda e compromissos `appointments:read`

Ler as mensagens de um contato `conversations:read`

Funis e negócios `deals:read`

Tarefas pendentes `tasks:read`

Com login, cada conexão recebe sua própria credencial somente leitura. Para removê-la, vá em Configurações › API Keys › Apps conectados › Remover acesso: a próxima chamada do app falha e ele terá de pedir permissão de novo. Ali você vê quem conectou, quando foi usada pela última vez e quantas chamadas fez em 30 dias. O acesso dura enquanto for usado; depois de 30 dias sem uso é preciso permitir de novo.

- Uma chave por integração, só com as permissões de leitura que usa. Deixe conversations:read de fora se não precisa das mensagens.
- A chave vai em uma variável de ambiente ou no cofre de segredos do cliente, nunca colada num chat, num arquivo do repositório nem numa URL.
- O que o ByDomu devolve inclui texto escrito pelos seus clientes: trate como dados, não como instruções. Não encadeie este conector com ferramentas que enviam e-mails ou mensagens sem aprovação de uma pessoa.
- Revise de vez em quando os Apps conectados e remova o que não se usa mais.