MCP
Dar ao agente acesso às ferramentas de um servidor MCP externo. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.
Dar ao agente acesso às ferramentas de um servidor MCP externo.
Onde configurar
Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.
Campos necessários
Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
| Campo | Requisito para o fluxo |
|---|---|
Name | Nome do conector. |
Url | Endpoint HTTPS absoluto, sem usuário/senha embutidos e sem fragmento #. |
McpSettings | Transport: StreamableHttp ou Sse; Authentication: None, Bearer ou ApiKeyHeader; TimeoutSeconds entre 1 e 300 (padrão 60). |
ApiKey | Obrigatória para Bearer ou ApiKeyHeader no formulário e na conexão ao servidor; dispensada em None. |
McpSettings.ApiKeyHeaderName | Obrigatório em ApiKeyHeader; use um nome de header permitido, como X-API-Key. |
Como obter as credenciais
- Obtenha o endpoint e a credencial no serviço que hospeda o servidor MCP. Não existe uma chave MCP universal.
- Escolha None para servidor sem autenticação, Bearer para token ou ApiKeyHeader para chave em header personalizado.
- Cole somente a credencial em ApiKey, sem o prefixo Bearer. Em ApiKeyHeader, informe também o nome do header solicitado pelo provedor.
- Associe o conector ao agente, descubra as ferramentas e selecione explicitamente as ferramentas permitidas.
Como funciona na Zild
A API valida Name, Url e McpSettings. O conector deve pertencer à área de trabalho e não pode ser um padrão global. Headers reservados (como Authorization, Host e Content-Type) e nomes iniciados em Mcp- são recusados no modo ApiKeyHeader. A implementação suporta credenciais estáticas, sem fluxo interativo de OAuth. Descobrir ferramentas não as autoriza; uma lista AllowedTools vazia não libera ferramentas.
Como conferir a configuração
Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.
Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.