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

Source: https://zild.ai/pt-BR/docs/apps/zild-admin/connector-mcp

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.



<table class="api-params"><thead><tr><th>Campo</th><th>Requisito para o fluxo</th></tr></thead><tbody><tr><td><code>Name</code></td><td>Nome do conector.</td></tr><tr><td><code>Url</code></td><td>Endpoint HTTPS absoluto, sem usuário/senha embutidos e sem fragmento #.</td></tr><tr><td><code>McpSettings</code></td><td>Transport: StreamableHttp ou Sse; Authentication: None, Bearer ou ApiKeyHeader; TimeoutSeconds entre 1 e 300 (padrão 60).</td></tr><tr><td><code>ApiKey</code></td><td>Obrigatória para Bearer ou ApiKeyHeader no formulário e na conexão ao servidor; dispensada em None.</td></tr><tr><td><code>McpSettings.ApiKeyHeaderName</code></td><td>Obrigatório em ApiKeyHeader; use um nome de header permitido, como X-API-Key.</td></tr></tbody></table>



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

## Documentação oficial

- [MCP: authorization specification](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization)

[Voltar a Conectores](/pt-BR/docs/apps/zild-admin/integration)