Skip to main content
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 ClickHouse 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.
Última modificação em 24 de julho de 2026