O que é n8n-MCP?
O n8n-MCP, de Romuald Członkowski, dá a assistentes de IA um conhecimento estruturado da plataforma de automação de workflows n8n. Ele traz um banco de dados pronto que cobre 3.143 nós do n8n (841 nativos e 2.302 da comunidade), suas propriedades e documentação, além de 2.352 templates de workflow. Ele não é feito pelo n8n. O repositório tem cerca de 23.100 estrelas no GitHub, e a versão 2.96.1 saiu em 22 de outubro de 2026.
Sete ferramentas principais buscam nós e templates e validam configurações de nós e workflows inteiros sem tocar em nenhuma instância do n8n. Adicione uma URL e uma chave da API do n8n e aparecem 21 ferramentas de gerenciamento: criar, atualizar, apagar e corrigir workflows automaticamente, rodar testes e gerenciar execuções, pastas, tabelas de dados e credenciais. Várias ferramentas mais novas também chamam o próprio servidor MCP em nível de instância do n8n por meio de um token de acesso separado.
Rode-o localmente com npx n8n-mcp (stdio), com Docker, ou use o serviço hospedado do autor em dashboard.n8n-mcp.com: gratuito para 100 chamadas de ferramenta por dia, ou €19 por mês no plano Supporter, com um limite de uso justo de 5.000 chamadas por dia.
Como instalar n8n-MCP
npx n8n-mcpn8n-MCP vale a pena?
O n8n-MCP conquista seu lugar pelos dados de referência, não pelo acesso de escrita. Modelos costumam inventar parâmetros do n8n ou se apoiar em padrões que falham em tempo de execução. Ter as propriedades exatas de 3.143 nós, 2.352 templates para copiar e um validador que confere conexões e expressões elimina boa parte dessa tentativa e erro. O modo apenas documentação não toca em nenhuma instância do n8n, o que faz dele o ponto de partida sensato.
Adicione uma chave de API e o que está em jogo muda. O modelo passa a poder apagar workflows, sobrescrevê-los por inteiro, executá-los e criar, ler ou apagar credenciais. O próprio README aconselha nunca deixar a IA editar workflows de produção e publica uma receita somente leitura: DISABLED_TOOLS para remover ferramentas inteiras, DISABLED_TOOL_OPERATIONS para bloquear verbos destrutivos dentro de ferramentas agrupadas e, por baixo, uma chave do n8n somente leitura. A receita tem armadilhas que o autor detalha, como o fato de quatro dos cinco métodos de n8n_test_workflow de fato executarem o workflow.
O histórico de segurança é longo para um servidor da comunidade. O GitHub lista 15 alertas desde maio de 2026: um crítico (acesso entre tenants a backups de workflows no modo HTTP multi-tenant), seis altos, incluindo um SSRF autenticado e um path traversal, e mais três publicados em 18 de outubro de 2026. Eles foram divulgados e corrigidos abertamente, o que conta a favor, mas quem roda o modo HTTP compartilhado deve fixar versões e ler cada um. A telemetria vem ligada por padrão e, sob a política de privacidade em vigor desde 28 de setembro de 2026, coleta estruturas de workflow sanitizadas e a intenção em texto livre das edições para treinar modelos de geração de workflows; um dos alertas de outubro tratava de campos de texto livre que escaparam dessa sanitização.
O servidor MCP nativo do n8n agora consegue criar e editar workflows por conta própria, sem processo extra nem terceiros. O argumento do n8n-MCP contra ele é a amplitude do material de referência e um validador em vários níveis; seu custo é uma segunda base de código com acesso de escrita e um pipeline de telemetria para gerenciar. Os dois foram feitos para coexistir: várias das ferramentas mais novas do n8n-MCP funcionam chamando o servidor em nível de instância do n8n.
Onde ele se destaca
Um engenheiro de automação que mantém uma instância auto-hospedada do n8n para uma equipe financeira
Rascunhar novos workflows a partir de uma descrição simples e pegar configurações de nós erradas antes da importação
Rode npx n8n-mcp sem chave de API; o agente chama search_nodes, get_node e validate_workflow e devolve o JSON do workflow para importar à mão. Nada na instância pode mudar, a telemetria pode ser desligada e o único custo são os tokens do modelo.
Uma equipe de plataforma que deixa desenvolvedores pedirem automações pelo Claude Code
Construir e testar workflows em uma instância de staging do n8n, nunca em produção
Dê a ele uma chave de API de staging, mantenha n8n_create_workflow, n8n_update_partial_workflow e n8n_test_workflow, e use DISABLED_TOOLS para remover n8n_delete_workflow e n8n_manage_credentials. O n8n-MCP faz um snapshot do workflow antes de cada mudança, então n8n_workflow_versions pode reverter uma edição ruim.
Um gerente de operações em uma pequena agência no n8n Cloud
Ter ajuda de IA para montar workflows sem rodar um servidor
O serviço hospedado é gratuito para 100 chamadas de ferramenta por dia; o fluxo recomendado chama várias ferramentas por nó (buscar, configurar, validar), então quem monta workflows com frequência passa para o plano Supporter de €19 por mês. O serviço hospedado guarda sua chave da API do n8n, o que coloca um terceiro no caminho das suas automações.
Antes de decidir
- Configuração
- npx n8n-mcp o roda via stdio; uma imagem Docker (ghcr.io/czlonkowski/n8n-mcp) e um modo HTTP atendem implantações compartilhadas. Há guias para Claude Code, Claude Desktop, Cursor e Windsurf, e o modo apenas documentação não precisa de chaves, então a primeira chamada de ferramenta leva minutos.
- Integrações
- 28 ferramentas: 7 de documentação e validação somente leitura, e 21 de gerenciamento que aparecem quando N8N_API_URL e N8N_API_KEY estão definidas, cobrindo criação, atualização completa e parcial, exclusão, execuções de teste, execuções, pastas, tabelas de dados e credenciais. Gerenciamento de agentes, descoberta de recursos de nós e histórico de versões nativo também exigem um N8N_MCP_ACCESS_TOKEN para o servidor em nível de instância do n8n.
- Dados e privacidade
- A chave do n8n dá ao modelo tudo o que essa chave pode fazer, incluindo ler e apagar credenciais, então combine uma chave somente leitura com DISABLED_TOOLS. A telemetria vai para telemetry.n8n-mcp.com no Azure, em Germany West Central: eventos brutos e registros de mudanças ficam guardados por 7 dias, o conjunto de dados anonimizado de workflows por tempo indeterminado; desative com npx n8n-mcp telemetry disable ou N8N_MCP_TELEMETRY_DISABLED=true.
- Custo em escala
- Auto-hospedar é gratuito além da máquina onde roda. O serviço hospedado é gratuito até 100 chamadas de ferramenta por dia, depois €19 por mês para chamadas ilimitadas sob um limite de uso justo de 5.000 por dia; limites pagos acima disso são negociados. n8n_test_workflow roda execuções reais com efeitos colaterais reais.
- Limites
- 28 definições de ferramentas são uma carga de contexto considerável; DISABLED_TOOLS reduz o contexto e também o risco. Várias ferramentas exigem versões recentes do n8n (pastas 2.19+, avaliações 2.30+, agentes 2.34+), e o modo HTTP multi-tenant é onde caiu a maior parte dos alertas anteriores.
O que é bom
- Dados de referência para 3.143 nós e 2.352 templates
- Valida nós e workflows inteiros antes que qualquer coisa chegue ao n8n
- O modo apenas documentação não precisa de credenciais do n8n
- Chaves por ferramenta e por operação para uma implantação somente leitura
O que não é
- Telemetria ligada por padrão, incluindo estruturas de workflow sanitizadas
- 15 alertas de segurança desde maio de 2026, um deles crítico
- As ferramentas de gerenciamento podem apagar workflows e ler credenciais
- Projeto da comunidade com um único mantenedor, não do n8n
Ideal para
Quem constrói no n8n e quer um assistente de IA para rascunhar e validar workflows com configuração de nós precisa.
Alternativas ao n8n-MCP
n8n-MCP: perguntas frequentes
- n8n-MCP vale a pena?
- Ele dá a um modelo o conhecimento de n8n que, de outra forma, ele inventa; rode-o somente leitura e com a telemetria desligada até ter lido seus 15 alertas de segurança. Damos nota 4.1 de 5.
- Quanto custa n8n-MCP?
- Gratuito e de código aberto (MIT) para auto-hospedar. Hospedado: gratuito para 100 chamadas de ferramenta por dia; Supporter a €19/mês para chamadas ilimitadas sob um limite de uso justo de 5.000 por dia.
- Quais são as desvantagens de n8n-MCP?
- Telemetria ligada por padrão, incluindo estruturas de workflow sanitizadas; 15 alertas de segurança desde maio de 2026, um deles crítico; as ferramentas de gerenciamento podem apagar workflows e ler credenciais; projeto da comunidade com um único mantenedor, não do n8n.
- Para quem n8n-MCP é indicado?
- Quem constrói no n8n e quer um assistente de IA para rascunhar e validar workflows com configuração de nós precisa.
- Quanto custa n8n-MCP para uma equipe ou em produção?
- Auto-hospedar é gratuito além da máquina onde roda. O serviço hospedado é gratuito até 100 chamadas de ferramenta por dia, depois €19 por mês para chamadas ilimitadas sob um limite de uso justo de 5.000 por dia; limites pagos acima disso são negociados. n8n_test_workflow roda execuções reais com efeitos colaterais reais.
- n8n-MCP é seguro para dados da empresa?
- A chave do n8n dá ao modelo tudo o que essa chave pode fazer, incluindo ler e apagar credenciais, então combine uma chave somente leitura com DISABLED_TOOLS. A telemetria vai para telemetry.n8n-mcp.com no Azure, em Germany West Central: eventos brutos e registros de mudanças ficam guardados por 7 dias, o conjunto de dados anonimizado de workflows por tempo indeterminado; desative com npx n8n-mcp telemetry disable ou N8N_MCP_TELEMETRY_DISABLED=true.
- Quais são as melhores alternativas ao n8n-MCP?
- As alternativas mais próximas que analisamos são n8n Instance-level MCP e Zapier MCP.
Respostas verificadas em 23 de out. de 2026.