# Claude: claude.ai, Desktop e Code

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

Guia Somente leitura Login

**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_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.

Login:

```
# 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
```

Chave:

```
# Con una clave secreta de solo lectura, leída de una variable de entorno
claude mcp add --transport http bydomu https://mcp.bydomu.com/mcp \
  --header "Authorization: Bearer $BYDOMU_API_KEY"

# --scope local (por defecto, este proyecto) · project (.mcp.json) · user (todos)
```

.mcp.json:

```
// .mcp.json en la raíz del proyecto (--scope project). Sin la clave escrita:
{
  "mcpServers": {
    "bydomu": {
      "type": "http",
      "url": "https://mcp.bydomu.com/mcp",
      "headers": { "Authorization": "Bearer ${BYDOMU_API_KEY}" }
    }
  }
}
```

## 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».

- **403** Na 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.
- **401** Algué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).

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.