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

# Outro servidor MCP

Muitos sistemas oferecem um servidor [MCP](https://modelcontextprotocol.io) próprio: um gerenciador de projetos, um CRM, uma base de dados. Se a sua empresa usa um sistema assim, você conecta o servidor dele ao Gateway. Os seus agentes usam as ferramentas desse servidor pelo mesmo conector, com o mesmo registro de atividade e o mesmo nível de acesso.

## Conectar

Em **Conexões**, toque em **Servidor MCP personalizado**.

1. **Nome do serviço**: o nome que os agentes e o registro mostram (por exemplo `Linear`).
2. **URL do servidor MCP**: o endereço que o sistema informa na documentação dele.
3. **Autenticação**: como o servidor espera a entrada.

| Opção                         | Quando usar                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| **Entrar (OAuth)**            | O servidor tem login próprio. O Gateway abre a página de login do sistema. Entre e autorize. |
| **Token de API**              | O sistema deu um token. O Gateway envia o token como `Authorization: Bearer`.                |
| **Cabeçalhos personalizados** | O servidor espera um cabeçalho com outro nome. Informe o nome e o valor de cada cabeçalho.   |
| **Sem autenticação**          | Só para servidores em rede privada, sem login.                                               |

Toque em **Conectar**. O Gateway chama o servidor e lista as ferramentas dele. Se o servidor não responder, o Gateway salva a conexão e mostra o erro. Corrija o endereço ou a autenticação e tente de novo.

## Leitura e escrita

O Gateway classifica cada ferramenta do servidor como leitura ou escrita, com o que o servidor declara. Se o servidor não declara, o Gateway classifica pelo nome da ferramenta. Um nível de acesso com **só leitura** no serviço chama só as ferramentas de leitura.

## Conta privada ou compartilhada

A conexão é sua. Só os seus agentes a usam. Você pode marcar **Compartilhar com a organização**: aí os agentes de todos os membros a usam, com a mesma conta.

## Se não funcionar

| Mensagem                                  | O que fazer                                                                                                 |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| "Salvo, mas o servidor não respondeu"     | Confira a URL e a autenticação. Alguns servidores exigem um caminho no fim do endereço, por exemplo `/mcp`. |
| O login (OAuth) não abre                  | O servidor não oferece OAuth nesse endereço. Use um token de API.                                           |
| As ferramentas não aparecem no assistente | O nível de acesso do agente não inclui esse serviço. Peça ao administrador.                                 |