Conecte o ByDomu ao Claude (MCP)

Deixe o Claude ou outro cliente MCP consultar sua imobiliária, somente leitura.

GuiaSomente leituraChave secreta

Antes de começar. Você precisa de um plano Business ou Enterprise (no Individual e no Profissional, com acesso aprovado), o e-mail verificado e estar fora do teste grátis.

Crie uma chave secreta somente leitura

No ByDomu, vá em Configurações › API Keys › Nova chave, escolha Sob medida e marque só estas permissões de leitura. Copie a chave: a completa aparece uma só vez.

Para quêPermissão

Buscar e ver imóveisportal:read

Buscar e ver contatoscontacts:read

Agenda e próximos compromissosappointments:read

Funis e negóciosdeals:read

Tarefas pendentestasks:read

Mensagens de um contato (opcional)conversations:read

Conecte seu cliente

Cole o endereço do servidor e a chave no seu cliente. No Claude Code é um único comando:

claude mcp add --transport http bydomu https://mcp.bydomu.com/mcp \
  --header "Authorization: Bearer domu_sk_live_XXXXXXXX"

O Claude Desktop usa mcp-remote; Cursor e VS Code, a URL e o cabeçalho na configuração. No claude.ai ou no ChatGPT, adicione um conector com o endereço do servidor e entre com sua conta do ByDomu.

Teste a conexão

Peça um resumo ao seu assistente. Ele deve usar a ferramenta get_summary e responder com o plano, as permissões da chave e as contagens da sua conta.

Ou teste sem assistente, com cURL:

cURL

curl -s https://mcp.bydomu.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer domu_sk_live_XXXXXXXX' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_summary","arguments":{}}}'

Se algo falhar

A ferramenta devolve o erro da API em palavras:

401A chave falta ou não é válida. Confira se o cabeçalho diz «Bearer» e a chave completa.
403Você usou uma chave publicável (domu_pk_) ou falta à chave a permissão dessa ferramenta.
429Você passou do limite por minuto. O erro diz em quantos segundos tentar de novo.