Base de Conhecimento

MCP no n8n: conecte agentes de IA aos seus fluxos

  • mcp, n8n, automação, agentes de ia, mcp server trigger, claude desktop
  • Usuários acharam útil: 0

Entenda o MCP no n8n: o n8n como servidor e como cliente, a autenticação, a ligação com o Claude Desktop, o proxy reverso, o queue mode e o aviso de segurança.

Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: MCP no n8n: conecte agentes de IA aos seus fluxos

Capa da Redação Eleven Host para o tutorial: MCP no n8n: conecte agentes de IA aos seus fluxos Arte: Eleven Host

O mcp no n8n funciona em dois sentidos: o n8n pode ser servidor MCP, oferecendo ferramentas e fluxos a um assistente de IA, ou cliente MCP, usando as ferramentas de outro servidor dentro de um agente.

Atualizado em 15/11/2026. Em 15/11/2026, a versão estável do n8n é a 2.47.7, publicada em 13/11/2026. O OAuth2 do MCP Server Trigger vale a partir da versão 2 do nó, e a opção de incluir o usuário na saída, a partir da 2.1.

O que é MCP e o que ele resolve no n8n

MCP, sigla de Model Context Protocol, é um padrão aberto para ligar aplicações de IA a sistemas externos. A Anthropic abriu o protocolo em 25/11/2024, e o site oficial do MCP o apresenta com uma comparação: ele seria como uma porta USB-C para aplicações de IA. Com ele, aplicações de IA se conectam a fontes de dados, ferramentas e fluxos de trabalho.

No n8n, isso aparece em dois nós:

  • MCP Server Trigger: o n8n age como servidor MCP e deixa ferramentas e fluxos disponíveis para clientes MCP, como o Claude Desktop;
  • MCP Client Tool: o n8n age como cliente, e o agente de IA (AI Agent) usa as ferramentas de um servidor MCP externo.

Para quem serve

O mcp no n8n interessa a quem já mantém um n8n em servidor próprio e quer que um assistente de IA chame fluxos da empresa, como consultar um cadastro ou disparar uma rotina que já existe. Quem ainda vai escolher onde instalar o n8n pode começar pelo guia de servidor VPS, que explica o que é, quanto custa e como escolher um plano.

Se a ideia é ter uma IA que responde com base nos documentos da empresa, o artigo AnythingLLM na VPS mostra outro caminho.

Planos mensais de VPS, com preços em reais, estão na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Passo 1: o n8n como servidor com o MCP Server Trigger

O MCP Server Trigger não é um gatilho comum. Ele só se liga a nós de ferramenta e os executa. O cliente de IA lista as ferramentas disponíveis e chama cada uma. Para transformar um fluxo inteiro em ferramenta, ligue-o ao nó Custom n8n Workflow Tool.

O nó tem duas URLs MCP, uma de teste e outra de produção:

  • Teste: o n8n registra essa URL quando você usa Listen for Test Event ou Execute workflow com o fluxo inativo, e as chamadas aparecem no editor;
  • Produção: o n8n registra essa URL quando você publica o fluxo. As chamadas não aparecem no editor; confira-as na aba Executions.

O path da URL é gerado de forma aleatória por padrão, para evitar conflito, e pode ser personalizado, inclusive com parâmetros de rota. Há ainda o campo Instructions, opcional, com orientações que o n8n envia ao cliente quando ele se conecta.

Sobre transporte, o nó aceita SSE (Server-Sent Events) e HTTP com streaming (streamable HTTP). Ele não aceita entrada e saída padrão (stdio).

Sem autenticação, o endereço do MCP Server Trigger dá a quem o tiver o poder de acionar as ferramentas expostas. Recomendamos manter a autenticação ligada e expor só as ferramentas necessárias.

Autenticação do servidor MCP

A documentação permite exigir autenticação de quem se conecta à URL MCP. As opções são estas:

  • None: sem autenticação;
  • Bearer auth: token no cabeçalho de autorização;
  • Header auth: credencial em um cabeçalho próprio;
  • n8n User Auth (OAuth2): login de usuário do n8n.

No OAuth2, a opção Require Workflow Execute Permission vem ligada por padrão e exige permissão para executar o fluxo. Há também Trusted Source Name or ID e Include User in Output, que vem ligada por padrão e leva à saída o ID, o e-mail e o nome de quem fez a chamada.

Recomendamos não deixar Authentication em None numa URL de produção acessível pela internet.

Passo 2: conectar o Claude Desktop pelo mcp-remote

Para o Claude Desktop falar com o MCP Server Trigger, a documentação do n8n usa o mcp-remote, que faz a ponte para o SSE. Antes, deixe o nó com autenticação Bearer e tenha em mãos a URL MCP (a de produção só existe depois de publicar o fluxo) e o token Bearer. Depois, no arquivo de configuração do Claude Desktop, use a estrutura que a documentação mostra, trocando os marcadores pela URL MCP e pelo token Bearer:

{

"mcpServers": {

"n8n": {

"command": "npx",

"args": [

"mcp-remote",

"<MCP_URL>",

"--header",

"Authorization: Bearer ${AUTH_TOKEN}"

],

"env": {

"AUTH_TOKEN": "<MCP_BEARER_TOKEN>"

}

}

}

}

O arquivo guarda o token, então recomendamos protegê-lo como se fosse uma senha. Quanto ao conector personalizado do claude.ai, a documentação avisa que ele pede login mesmo com Authentication em None, e que esse é o único cliente conhecido que faz isso.

Passo 3: o n8n como cliente com o MCP Client Tool

O MCP Client Tool fica dentro do AI Agent e liga o modelo às ferramentas de um servidor MCP externo. Ele serve para servidores que não estão no registro de MCP do n8n, porque os que estão lá podem ser ligados pelo painel do nó, sem credencial.

Os campos principais são:

  • SSE Endpoint: o endereço SSE do servidor MCP ao qual você quer se conectar;
  • Authentication: Bearer, cabeçalho genérico, vários cabeçalhos (pares de nome e valor) ou OAuth2. Com None, o nó tenta se conectar sem autenticação;
  • Tools to Include: All inclui as ferramentas do servidor, Selected deixa você escolher quais usar, e All Except usa as ferramentas do servidor menos as listadas em Tools to Exclude.

Escolha só as ferramentas de que o agente precisa

O filtro de ferramentas do MCP Client Tool limita o que o agente enxerga. Recomendamos preferir Selected e listar apenas as ferramentas que o fluxo usa, em vez de liberar o servidor inteiro.

Proxy reverso e queue mode

Duas situações de instalação pedem atenção, segundo a documentação do MCP Server Trigger.

Proxy reverso, como o nginx. O endpoint MCP pode dar problema se o proxy não estiver configurado para SSE e HTTP com streaming. Em especial, é preciso desligar o buffering do proxy para esse endpoint. O exemplo da documentação usa um bloco location /mcp/ com proxy_http_version 1.1 e proxy_buffering off, e desliga também o gzip e o chunked transfer encoding, além de deixar vazio o cabeçalho Connection. O bloco completo está na página do nó MCP Server Trigger, em docs.n8n.io; confira-o lá.

Queue mode. Com uma única réplica de webhook, o MCP funciona. Com várias, é preciso direcionar todas as requisições /mcp* para uma só réplica dedicada de webhook. Sem isso, as conexões SSE e HTTP com streaming vão cair com frequência ou falhar na entrega de eventos.

Versão do n8n e o aviso de segurança sobre o MCP

O n8n publicou o aviso de segurança GHSA-rc3w-8jc8-7x3w, de severidade Moderate (CVSS v4 5.1, sem CVE), em 28/10/2026. Ele trata de um redirecionamento aberto no registro dinâmico de clientes do OAuth do MCP. A descrição oficial diz que os endpoints de registro e de autorização do OAuth do MCP vêm ativados por padrão e não exigem autenticação.

As versões corrigidas são 1.123.89, 2.45.5, 2.46.1 e 3.0.1. Em 15/11/2026, a estável é a 2.47.7, posterior à 2.46.1. O boletim de segurança do n8n de 28/10/2026 recomenda atualizar as instâncias próprias para a versão corrigida do seu ramo, e informa que o n8n Cloud é corrigido automaticamente. Recomendamos conferir a versão estável de novo antes de atualizar, porque ela muda.

Não confunda esse aviso com os do n8n-mcp, um projeto de terceiros que não é o nó MCP do n8n.

Licença do n8n

O n8n usa a Sustainable Use License, na versão 1.0. O texto permite usar ou modificar o software apenas para fins internos do próprio negócio ou para uso não comercial ou pessoal. Arquivos com .ee no nome ou na pasta ficam fora dessa licença e pedem a licença n8n Enterprise. Para usos diferentes dos descritos, leia o texto completo da licença no repositório do n8n no GitHub.

Mais automações na base de conhecimento

Quem monta fluxos com IA também pode se interessar pelo artigo Windmill na VPS, sobre automações e scripts da equipe.

VPS com preço mensal em reais ficam na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O que é o mcp no n8n?

É o uso do Model Context Protocol dentro do n8n. O MCP Server Trigger faz o n8n oferecer ferramentas e fluxos a clientes MCP, e o MCP Client Tool deixa o agente do n8n usar as ferramentas de um servidor MCP externo.

O MCP Server Trigger aceita stdio?

Não. A documentação informa que o nó aceita SSE e HTTP com streaming, e que o transporte de entrada e saída padrão (stdio) não é suportado.

Como conectar o Claude Desktop ao n8n?

A documentação do n8n usa o mcp-remote, com a URL MCP e um token Bearer no arquivo de configuração do Claude Desktop, como na estrutura mostrada no Passo 2.

O MCP Client Tool usa HTTP com streaming?

Neste nó, o campo de endereço é o SSE Endpoint, que recebe o endereço SSE do servidor MCP.

Existe um aviso de segurança sobre o MCP no n8n?

Sim. O GHSA-rc3w-8jc8-7x3w, de severidade Moderate, publicado em 28/10/2026, foi corrigido nas versões 1.123.89, 2.45.5, 2.46.1 e 3.0.1.

Esta resposta lhe foi útil?

Artigos Relacionados