Ir para o conteúdo
Promovaweb

Publique ferramentas com MCP Server Trigger

Revisado em

Antes de começar

Disponibilizar uma ferramenta de exercício em um endpoint MCP de workflow.

  • Editor do n8n e um cliente MCP com suporte a SSE ou streamable HTTP.
  • Conexão de rede entre o cliente e a instância.

O MCP Server Trigger transforma um workflow em um servidor MCP. Você escolhe as ferramentas conectadas e o cliente externo chama cada uma pelo endpoint publicado. Esse recurso permite montar um conjunto específico de consultas ou ações sem habilitar o servidor MCP da instância.

Adicione uma ferramenta de exercício

Crie um workflow com MCP Server Trigger. No conector de ferramentas, adicione Calculator para exercitar uma chamada matemática. O trigger conecta e executa ferramentas. Ele não encaminha uma mensagem por uma sequência convencional de Nodes.

Para disponibilizar uma automação maior, conecte a ferramenta de workflow indicada na documentação do trigger. O workflow chamado concentra os passos da automação, enquanto o cliente MCP recebe a interface da ferramenta.

Configure URL e autenticação

O painel do trigger mostra Test URL e Production URL. O campo Path recebe um caminho gerado para evitar conflito com outros triggers. Mantenha esse caminho no exercício. Altere-o apenas se precisar de um endereço específico.

Em Authentication, o Node oferece None, Bearer auth e Header auth. Configure uma credencial compatível e informe ao cliente a URL e a autenticação escolhidas. A autenticação desse trigger pertence ao próprio endpoint. Ela tem configuração separada do acesso MCP da instância.

Faça a chamada de teste

Selecione Listen for Test Event e configure o cliente com a Test URL exibida. Liste as ferramentas e faça uma chamada ao Calculator. Compare os argumentos e o resultado na execução.

Para usar a Production URL, publique o workflow. Depois, atualize a URL no cliente e repita a chamada. As execuções de produção ficam em Executions, sem exibição automática no canvas.

Transporte e múltiplas réplicas

O trigger aceita SSE e streamable HTTP. Ele não oferece transporte stdio diretamente. Use um cliente compatível com os transportes documentados para o endpoint.

Em queue mode com múltiplas réplicas de webhook, a documentação exige direcionar todas as chamadas /mcp* para uma única réplica dedicada. As conexões persistentes precisam chegar à mesma instância. Sem esse direcionamento, as conexões podem cair ou falhar no recebimento de eventos.

Atrás de proxy reverso, confira também o buffering do endpoint. A documentação orienta desativá-lo para tráfego MCP e apresenta uma configuração de referência para nginx. Valide a chamada pelo endereço público antes de considerar concluída a configuração.

Confira o resultado

O cliente lista a ferramenta conectada e uma chamada retorna o resultado visível na execução do workflow.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.