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.
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.
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.
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.
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
