n8n MCP Server Trigger: URL, configuração do Claude e exemplos

O n8n MCP Server Trigger transforma um fluxo de trabalho comum em um servidor MCP que o Claude pode chamar. Você adiciona o nó, conecta alguns nós de ferramenta, copia uma URL, e o Claude passa a ler uma planilha, publicar no Slack, executar um subfluxo de trabalho ou iniciar um job de geração de imagem, sem nenhum código de servidor do seu lado. Três detalhes decidem se isso funciona ou falha silenciosamente: qual URL você copia, como você a protege e como o Claude se conecta a ela.

Este artigo esclarece os três. Você recebe um arquivo de configuração para colar, quatro exemplos de fluxos de trabalho, uma tabela com as falhas que aparecem com mais frequência e os nomes exatos das opções que o n8n usa no editor, retirados da documentação do nó.

O que o Trigger realmente faz

A maioria dos triggers do n8n inicia um fluxo de trabalho e passa dados para o nó seguinte. O MCP Server Trigger funciona de outro jeito. Ele não passa dados adiante. Ele só se conecta a nós de ferramenta e expõe essas ferramentas a qualquer cliente MCP que conheça sua URL. Quando o Claude pergunta o que o servidor pode fazer, o n8n responde com a lista de ferramentas conectadas. Quando o Claude escolhe uma delas, o n8n a executa e devolve o resultado.

Isso faz o canvas parecer mais uma definição de API do que uma automação. Cada ferramenta é uma capacidade, e o nome da ferramenta somado à sua descrição é o que o Claude lê para decidir quando usá-la. O nó fala Server-Sent Events (SSE) e streamable HTTP. Ele não oferece suporte a stdio, e é por isso que o Claude Desktop precisa de uma pequena ponte, mostrada mais adiante.

Um nó, muitas ferramentas

Conecte quantos nós de ferramenta precisar: Google Sheets Tool, Gmail Tool, HTTP Request Tool, Code Tool, Calculator ou o Custom n8n Workflow Tool, que chama outro fluxo de trabalho. Esse último é o mais importante na prática. Ele permite manter a lógica pesada em fluxos de trabalho normais e expor apenas um ponto de entrada enxuto e bem nomeado.

💡 Dê às ferramentas nomes de verbos e descreva cada uma em uma frase simples. "find_order: busca um pedido pelo número e retorna o status e a data de envio" é sempre melhor que "orders_tool", porque o Claude escolhe as ferramentas apenas com base nesse texto.

Server Trigger ou Client Tool

O n8n traz dois nós MCP que as pessoas confundem. Eles apontam em direções opostas.

Se você quer que o Claude use o n8n, precisa do trigger. Se você quer que um agente do n8n use as ferramentas de outra pessoa, precisa do client tool.

Encontrando a URL MCP certa

Abra o trigger e você verá duas URLs no topo do painel do nó. Copiar a errada é o erro mais comum no início, e ele produz o sintoma mais confuso: tudo funciona enquanto o editor está aberto e para no momento em que você o fecha.

URL de teste ou URL de produção

Se você aponta o Claude para a URL de teste, a demonstração funciona e depois quebra assim que você sai da aba. Se aponta para a URL de produção, o fluxo de trabalho responde o tempo todo, com cada chamada registrada em Executions, onde você pode inspecionar entradas e saídas.

💡 Copie a URL diretamente do nó, em vez de digitá-la. Na maioria das instalações, o endereço de produção tem a forma https://n8n.example.com/mcp/your-path, e o endereço de teste troca /mcp/ por /mcp-test/. Trate esse formato como uma pista e confie no que o nó mostra.

Escolha um caminho estável

O parâmetro Path vem preenchido com uma string aleatória para que dois fluxos de trabalho nunca entrem em conflito. Você pode substituí-lo por algo legível, incluindo parâmetros de rota, para que a configuração do Claude sobreviva a uma reconstrução do fluxo de trabalho. Use um caminho por assistente: orders-assistant, support-lookup, image-studio.

Outra regra que costuma pegar as pessoas de surpresa: um fluxo de trabalho inativo não atende requisições MCP. Se o Claude conecta mas não vê nenhuma ferramenta, verifique antes de tudo se o fluxo de trabalho está publicado.

Proteja tudo com autenticação Bearer

O trigger oferece três opções de Authentication: None, Bearer auth e Header auth. None serve para um teste descartável no seu notebook. Qualquer coisa acessível de fora de uma rede confiável precisa de uma das outras duas, porque uma URL MCP pública sem autenticação é um botão público que executa seus fluxos de trabalho.

Bearer ou Header auth

Com Bearer auth, o cliente envia um cabeçalho Authorization: Bearer <token>. Com Header auth, você escolhe o nome e o valor do cabeçalho, por exemplo X-MCP-Token. Escolha Bearer, a menos que um gateway na frente do n8n já espere um cabeçalho personalizado.

1. Abra o trigger e defina Authentication como Bearer auth.
2. Crie uma credencial e cole um token aleatório e longo. openssl rand -hex 32 gera um bom token.
3. Guarde o token em um gerenciador de senhas. Você vai precisar dele de novo para a configuração do Claude.
4. Salve e publique o fluxo de trabalho novamente para que a mudança entre em vigor.

Mantenha a lista de ferramentas curta

Cada ferramenta conectada é algo que um prompt pode disparar. Um modelo que pode ler linhas e também apagá-las vai, cedo ou tarde, apagar uma quando o pedido for ambíguo. Dê a cada assistente um conjunto restrito de ferramentas, somente leitura sempre que possível, e fixe parâmetros arriscados, como o canal do Slack ou o ID da planilha, em vez de deixar o Claude escolhê-los.

O modelo do outro lado também importa. Modelos fortes para chamadas de ferramenta, como Claude Sonnet 5 e Claude Fable 5, são bons parceiros de teste no PicassoIA: cole as descrições das suas ferramentas em um chat, envie dez pedidos de exemplo e verifique qual ferramenta o modelo escolheria em cada caso. Reescreva qualquer descrição que cause uma escolha errada antes de mexer no fluxo de trabalho.

Conecte o Claude ao seu servidor

O Claude alcança um servidor MCP por três caminhos diferentes, e cada uma pede a mesma URL de produção, em um envoltório um pouco diferente.

Claude Desktop com mcp-remote

O Claude Desktop inicia servidores stdio locais, e o trigger não fala stdio. O pacote mcp-remote fica no meio e faz a tradução. Abra o arquivo de configuração (no Windows, %APPDATA%\Claude\claude_desktop_config.json; no macOS, ~/Library/Application Support/Claude/claude_desktop_config.json) e adicione esta entrada:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://n8n.example.com/mcp/orders-assistant",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "paste-your-bearer-token-here"
      }
    }
  }
}

Copiar prompt

O token fica em env e o argumento de cabeçalho faz referência a ele, de modo que o argumento continua sendo uma única string limpa. Você precisa ter o Node.js instalado, porque npx baixa a ponte na primeira execução. Feche totalmente o Claude Desktop, abra-o de novo, e as ferramentas aparecerão no menu de ferramentas de um novo chat.

Claude Code pelo terminal

O Claude Code consegue falar diretamente com servidores remotos, então não é preciso nenhuma ponte:

claude mcp add --transport http n8n https://n8n.example.com/mcp/orders-assistant \
  --header "Authorization: Bearer YOUR_TOKEN"

Copiar prompt

Use --transport http para streamable HTTP. Se a sua versão do n8n expõe apenas o endpoint SSE mais antigo, troque a flag por --transport sse. Execute claude mcp list para confirmar que o servidor aparece como conectado e, como primeiro teste, peça ao Claude Code que "liste as ferramentas do n8n".

Conectores personalizados no claude.ai

No claude.ai, abra as configurações de conectores e adicione um conector personalizado com a URL de produção. As requisições partem do lado da Anthropic, não do seu notebook, então o endereço precisa ser acessível pela internet via HTTPS. Um endereço localhost ou um IP privado não vai funcionar. Coloque o n8n atrás de um proxy reverso ou de um túnel antes.

💡 A documentação do n8n registra uma peculiaridade: o claude.ai pede login mesmo quando a autenticação do trigger está desativada, porque presume que todo endpoint MCP usa autenticação de usuário. Um pedido de login não significa que o trigger está mal configurado.

Quatro exemplos que valem a pena construir

Cada exemplo abaixo é um nó de ferramenta conectado ao mesmo trigger. Comece pelo primeiro, confirme que o Claude consegue chamá-lo e depois adicione os demais, um de cada vez.

Buscar linhas no Sheets

Conecte um Google Sheets Tool, defina a operação como obter linhas e filtre a coluna de número do pedido com uma expressão que permita ao Claude preencher o valor:

{{ $fromAI('order_number', 'The order number the customer gave', 'string') }}

Copiar prompt

Agora "Onde está o pedido 48213?" se torna uma busca real. Descrição da ferramenta: Busca um pedido pelo número e retorna o status e a data de envio. Ela é somente leitura, então é a primeira ferramenta mais segura para expor.

Publicar um resumo no Slack

Adicione um Slack Tool com a operação de enviar mensagem. Fixe o canal e deixe o Claude preencher apenas o texto:

{{ $fromAI('summary', 'A two sentence summary to post', 'string') }}

Copiar prompt

Como o canal está fixo no nó, um prompt confuso não consegue publicar em nenhum outro lugar. Essa única decisão elimina a maior parte do risco de dar a um assistente acesso de escrita.

Chamar um subfluxo de trabalho

O Custom n8n Workflow Tool executa outro fluxo de trabalho que começa com um Execute Workflow Trigger. É aqui que ficam os trabalhos de várias etapas: enriquecer um lead, consultar o CRM, criar uma página no Notion, devolver um resultado curto. O Claude vê uma ferramenta com uma descrição, e toda a lógica de ramificação fica em um fluxo de trabalho que você pode testar sozinho.

Gerar imagens por uma API

Uma HTTP Request Tool permite que o Claude inicie jobs de imagem a partir de um chat. A API do PicassoIA segue um desenho no estilo Replicate: você cria uma previsão e depois consulta até o resultado ficar pronto. O endereço base é https://api.picassoia.com/v1, e as chamadas usam um token Bearer que começa com pia_sk_, criado na página da API do PicassoIA.

1. Adicione uma HTTP Request Tool chamada create_image com a descrição Cria uma imagem fotorrealista com proporção 16:9 a partir de um prompt de texto e retorna o id da previsão.
2. Defina o método como POST e a URL como https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions.
3. Defina a autenticação como Bearer e cole seu token pia_sk_.
4. Envie um corpo JSON com um objeto input cujo prompt vem de $fromAI.
5. Adicione uma segunda HTTP Request Tool chamada get_image que envia um GET para https://api.picassoia.com/v1/predictions/ seguido do id da previsão que o Claude passar.

O Claude cria o job, espera alguns segundos, consulta get_image e mostra a URL final. O modelo por trás da primeira chamada é o PicassoIA Image, e o PicassoIA Image Editor Pro cuida das edições com o mesmo padrão. As contas executam até 5 previsões ao mesmo tempo, e os prompts podem chegar a 4.000 caracteres, então escreva a descrição da ferramenta para dizer ao Claude que envie uma requisição por vez. Verifique a página da API para ver os campos de resposta e os requisitos de cada plano antes de depender disso em produção.

Corrigindo falhas comuns

A maioria dos problemas do MCP Server Trigger vem de uma pequena lista de causas. Antes de mudar qualquer coisa, abra a aba Executions. Uma chamada que nunca aparece ali nunca chegou ao n8n, o que aponta para a URL, o proxy ou a configuração do Claude. Uma chamada que aparece com erro aponta para o próprio nó de ferramenta.

Conexão cai atrás do nginx

SSE e streamable HTTP são conexões de longa duração. Um proxy reverso que faz buffer das respostas segura o stream até enchê-lo, e o Claude vê um travamento. O n8n recomenda desativar o buffer do proxy, a compressão gzip e a transferência em partes (chunked) no caminho MCP, e remover o cabeçalho Connection:

location /mcp/ {
    proxy_pass http://n8n:5678;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    proxy_buffering off;
    gzip off;
    chunked_transfer_encoding off;
}

Copiar prompt

Roteamento no modo de fila

No modo de fila com várias réplicas de webhook, cada conexão persistente precisa permanecer na instância que a abriu. O n8n documenta o roteamento de todas as requisições /mcp* para uma única réplica de webhook dedicada. Adicione uma regra no seu load balancer para esse caminho e as falhas aleatórias param.

Experimente com as suas próprias imagens

Agora você tem o ciclo completo: um nó de trigger, uma URL de produção, autenticação Bearer, uma configuração do Claude que aponta para ela e ferramentas que realizam trabalho de verdade. O fluxo de geração de imagens é o mais divertido para testar primeiro, porque o resultado aparece direto no seu chat e você pode avaliá-lo em segundos.

Abra o Picasso IA e rode alguns prompts à mão antes de conectar a API. Compare GPT Image 2, Seedream 4.5 e Nano Banana 2 Lite com o mesmo prompt e depois fique com o estilo que se encaixa no seu projeto. Quando você souber quais formatos de prompt funcionam, coloque-os na descrição da ferramenta para que o Claude escreva prompts melhores por conta própria.

Construa a primeira ferramenta hoje: um trigger, uma ferramenta somente leitura, uma conexão com o Claude. Adicione uma segunda ferramenta só depois que a primeira rodar sem problemas, e seu assistente vai crescer sem nunca surpreender você.