> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidores MCP

> Conectando servidores MCP de terceiros a um ClickHouse Agent

[Recurso beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

O Model Context Protocol (MCP) é o padrão aberto para expor ferramentas e fontes de dados a um modelo de IA. Anexar um servidor MCP a um ClickHouse Agent dá ao agente acesso aos recursos expostos por esse servidor — rastreadores de issues, backends de observabilidade, APIs internas, SaaS de terceiros ou qualquer outro recurso com um endpoint MCP.

## Conectar um servidor MCP

No Agent Builder, abra a seção **servidores MCP** e clique em **Adicionar servidor**. Insira a URL do servidor e as configurações de autenticação e, em seguida, escolha quais ferramentas desse servidor você quer que este agente específico use. Salve o agente.

Você pode conectar vários servidores a um único agente. Cada ferramenta que o agente aciona é registrada na conversa para que os usuários possam ver o que ele fez.

## Transporte

O ClickHouse Agents usa Streamable HTTP — o transporte MCP pronto para produção. O servidor ao qual você se conecta deve estar acessível via HTTP(S) a partir do ClickHouse Cloud.

## Autenticação

Os servidores MCP podem exigir credenciais. O Agents oferece suporte a:

* **Bearer tokens** e outros cabeçalhos estáticos - valores fixos que você fornece ao configurar o servidor.
* **OAuth 2.0** - fluxo interativo. Na primeira vez que você (ou qualquer usuário com acesso) chamar uma ferramenta no servidor, o navegador abrirá uma janela de login; os tokens serão gerenciados e renovados automaticamente.
* **Credenciais por usuário** - variáveis na config do servidor substituídas com base no perfil do usuário que fez a chamada, para que cada usuário se autentique com sua própria identidade, em vez de usar uma conta de serviço compartilhada.

As credenciais fornecidas pelo usuário são armazenadas de forma criptografada e ficam restritas ao usuário que as inseriu. As credenciais de um usuário nunca ficam visíveis para as execuções do agente de outro usuário.

## Limites

Uma única execução de agente pode fazer referência a, no máximo, 50 destinos distintos de servidor MCP e até 100 configurações de ferramentas expandidas por solicitação. Agentes que precisarem de mais devem ser decompostos usando [subagentes](https://clickhouse.com/docs/pt-BR/agents/builder/subagents.md).
