Conecte ferramentas MCP externas ao agente

O MCP Client Tool conecta seu AI Agent às ferramentas de um servidor MCP externo. Você fornece o endpoint e a autenticação. O agente recebe as ferramentas disponibilizadas pela conexão e escolhe quais chamar durante a resposta.

Conecte o servidor ao agente

Abra um workflow com Chat Trigger, AI Agent e modelo de chat. Pelo conector de ferramentas do agente, adicione MCP Client Tool. Esse Node funciona como ferramenta do agente, com configuração diferente do MCP Client usado como etapa regular do workflow.

A documentação do Client Tool apresenta o campo SSE Endpoint para o endereço do servidor. Copie o endpoint fornecido pelo serviço. Se estiver usando outro workflow do n8n como servidor de exercício, utilize a URL exibida no respectivo MCP Server Trigger.

Configure a autenticação

Em Authentication, selecione o método exigido pelo servidor. O Client Tool documenta autenticação Bearer, cabeçalho genérico, múltiplos cabeçalhos e OAuth2. None tenta conectar sem autenticação.

Use Multiple Headers Auth quando o servidor exigir mais de um cabeçalho. Cada entrada da credencial recebe Name e Value. Configure os valores conforme a documentação do serviço, sem colocá-los na mensagem enviada ao modelo.

Escolha as ferramentas disponíveis

O parâmetro Tools to Include define o conjunto apresentado ao agente:

Opção	Ferramentas disponíveis
All	Todas as ferramentas fornecidas pelo servidor
Selected	Apenas as ferramentas selecionadas
All Except	Todas, exceto as selecionadas em Tools to Exclude

Para o exercício, escolha Selected e disponibilize uma ferramenta de consulta. Você consegue examinar uma chamada específica antes de acrescentar ferramentas que alteram registros ou enviam mensagens.

Confira a chamada externa

No Tools Agent, ative Return Intermediate Steps. Envie pelo chat uma mensagem que precise da ferramenta escolhida. Compare o nome da ferramenta, os argumentos enviados e a resposta do servidor com o texto final apresentado no chat.

Se o servidor não fornecer a ferramenta esperada, confira endpoint, autenticação e seleção no Client Tool. Se a ferramenta estiver disponível, mas não for chamada, reveja a instrução do agente e a finalidade descrita pelo servidor.

No exercício com MCP Server Trigger, confirme também a URL usada: a de teste exige escuta de teste. A de produção depende do workflow publicado. Uma resposta de texto do modelo, sem chamada externa registrada, não confirma a conexão MCP.