> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.basement.chat/pt-br/connect-an-agent/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.basement.chat/_mcp/server.

# Conectar um agente

Um agente se conecta ao Gateway pelo Model Context Protocol (MCP). Você cria uma chave para o agente no Basement e cola essa chave na configuração MCP do agente.

### Crie uma chave

No Basement, abra **Agentes** e clique em **Conectar agente**. Deixe **Agente de IA** selecionado, dê um nome ao agente e selecione o nível de acesso dele.

O nível de acesso decide o que o agente pode ler, escrever e usar. Na dúvida, comece com **Pesquisador**: ele lê tudo no Basement e não escreve nada. Veja [Chaves e níveis de acesso](/pt-br/concepts/keys-and-access-levels).

O Basement mostra a chave uma única vez. Copie a chave agora.

### Adicione o Gateway ao seu agente

Cole a chave na configuração MCP do seu agente. A maioria dos clientes MCP lê um arquivo JSON como este:

```json
{
  "mcpServers": {
    "basement": {
      "url": "https://mcp.basement.chat/mcp",
      "headers": { "Authorization": "Bearer bsmt_sua_chave" }
    }
  }
}
```

No Claude Code, um comando faz o mesmo:

```bash
claude mcp add --transport http basement https://mcp.basement.chat/mcp \
  --header "Authorization: Bearer bsmt_sua_chave"
```

Para outros clientes, e para clientes que entram com OAuth, veja [Conectar um cliente MCP](/pt-br/mcp/connect-an-mcp-client).

### Confira a conexão

Peça ao agente para chamar a ferramenta `whoami`. A resposta traz o nome da sua organização e da chave. Depois, peça para ele listar seus documentos.

## O que acontece depois

* O agente vê só as ferramentas que o nível de acesso dele permite. Veja [Ferramentas](/pt-br/mcp/tools).
* Cada chamada do agente aparece em **Agentes**, **Atividade**. Veja [Registro de atividade](/pt-br/concepts/activity-log).
* Para parar um agente, abra o agente em **Agentes**, **Conectados** e clique em **Revogar**. A chave para de funcionar na hora.

> Dê a um agente de IA acesso à sua organização pelo MCP.