ByDomuDevelopers

Claude: claude.ai, Desktop e Code

Conector personalizado com login (sem colar chaves) e Claude Code pelo terminal.

GuiaSomente leituraLogin
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.

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
// 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 ByDomu

Teste

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).

PodePermissão
Buscar e ver imóveis publicadosportal:read
Buscar e ver contatoscontacts:read
Agenda e compromissosappointments:read
Ler as mensagens de um contatoconversations:read
Funis e negóciosdeals:read
Tarefas pendentestasks: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.