Conectar um cliente MCP

O Gateway é um servidor MCP sobre Streamable HTTP.

Entrar com uma chave

Crie uma chave em Agentes, Conectar agente, e envie a chave como bearer token. Funciona com qualquer cliente MCP que permita definir um cabeçalho.

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

Entrar com OAuth

Um cliente que tem OAuth para MCP (por exemplo, um conector personalizado no Claude) só precisa do endereço. Informe https://mcp.basement.chat/mcp. O cliente abre o Basement no navegador, você escolhe a organização e dá um nome à conexão, e o Basement entrega ao cliente uma chave própria.

Uma conexão feita assim lê o Basement e não escreve nada. Para ela fazer mais, selecione um nível de acesso para ela em Agentes, Conectados.

O Gateway implementa OAuth 2.1 com descoberta, registro dinâmico de cliente e PKCE:

• GET /.well-known/oauth-protected-resource
• GET /.well-known/oauth-authorization-server
• POST /oauth/register
• POST /oauth/token

Uma conexão feita com OAuth aparece em Agentes, Conectados como qualquer outra chave, e você revoga do mesmo jeito.

Confira a conexão

Chame whoami. A resposta traz a organização, o nome e o prefixo da chave, e os escopos dela. Funciona com qualquer chave.

{
  "orgId": "…",
  "orgName": "Acme Robotics",
  "keyName": "Claude para preparar reuniões",
  "keyPrefix": "bsmt_4UMl",
  "scopes": ["gateway:read", "tools:use"],
  "expiresAt": null
}

O que o agente vê

tools/list responde só as ferramentas que o nível de acesso da chave permite. Uma ferramenta fora da lista responde erro se o agente chamar. Veja Ferramentas.