Conectar um agente | Basement Gateway

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.

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:

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

No Claude Code, um comando faz o mesmo:

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.

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.
Cada chamada do agente aparece em Agentes, Atividade. Veja Registro de atividade.
Para parar um agente, abra o agente em Agentes, Conectados e clique em Revogar. A chave para de funcionar na hora.