Claude: claude.ai, Desktop e Code
Conector personalizado com login (sem colar chaves) e Claude Code pelo terminal.
Adicione o conector no claude.ai
Funciona no Free (um conector personalizado), Pro e Max, e fica na web, no Claude Desktop e no celular. Você não cola nenhuma chave: entra com sua conta do ByDomu.
- No Claude, Customize › Connectors › Add custom connector.
- Nome ByDomu e a URL
https://mcp.bydomu.com/mcp. Deixe vazios o ID e o segredo do cliente: o Claude se registra sozinho. - Add e depois Connect: o ByDomu abre. Entre se precisar, revise a imobiliária e as permissões (somente leitura) e toque em Permitir.
- Em cada chat, ative em + › Connectors. Em Customize › Connectors você pode bloquear ferramentas que não quer usar.
Os nomes do menu são os da documentação da Anthropic em inglês; em outro idioma aparecem traduzidos. O Claude Desktop usa os mesmos conectores da sua conta: não precisa configurar mais nada. Se preferir uma chave no Desktop, use mcp-remote (um pacote da comunidade):
// claude_desktop_config.json: solo si necesitas una clave en vez de iniciar sesión
{
"mcpServers": {
"bydomu": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.bydomu.com/mcp", "--header", "Authorization:${BYDOMU_AUTH}"],
"env": { "BYDOMU_AUTH": "Bearer domu_sk_live_XXXXXXXX" }
}
}
}No Team e Enterprise
Um Owner adiciona para a organização toda em Organization settings › Connectors › Add › Custom › Web, com a mesma URL. Depois cada pessoa conecta em Customize › Connectors › Connect e entra com a conta do ByDomu; só quem administra as chaves de API da imobiliária pode permitir. Cada conexão lê a imobiliária inteira em somente leitura, não só o que está atribuído a essa pessoa.
Claude Code
Adicione sem chave e autentique com /mcp (abre o navegador para permitir o acesso no ByDomu), ou passe uma chave secreta somente leitura por cabeçalho. Para compartilhar com a equipe, .mcp.json aceita variáveis de ambiente: a chave nunca fica no repositório.
# Con inicio de sesión (sin clave)
claude mcp add --transport http bydomu https://mcp.bydomu.com/mcp
# luego, dentro de Claude Code:
/mcp # elige bydomu → Authenticate → Permitir en ByDomuTeste
Pergunte «Me dê um resumo da imobiliária»: deve usar get_summary e responder com o plano, as permissões e as contagens. Depois algo como «Que compromissos tenho amanhã?» ou «Busque apartamentos para alugar em Medellín abaixo de 4 milhões».
- 403Na tela do ByDomu: seu plano não inclui conectar apps, você está no teste grátis, falta verificar o e-mail ou você não administra as chaves de API.
- 401Alguém removeu o acesso em Apps conectados ou passaram 30 dias sem uso: conecte de novo.
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).
portal:readcontacts:readappointments:readconversations:readdeals:readtasks:readCom 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.