#9 no GitHub · Dados e automação
Como instalar e usar o n8n-mcp: passo a passo
Dá à IA conhecimento sobre os nós do n8n, a plataforma de automação de fluxos de trabalho. Com ele, o assistente consulta documentação, propriedades e modelos de fluxo para ajudar a montar e validar automações.
- Para quem
- Quem usa ou quer usar o n8n e deseja que o Claude ajude a desenhar e validar fluxos de automação.
- Estrelas (07/11/2026)
- 23.227, #9 no ranking
- Licença
- MIT
- Repositório
- czlonkowski/n8n-mcp
Passo a passo
Antes de começar: Um cliente MCP compatível, como o Claude Code; Uma conta no painel dashboard.n8n-mcp.com para o serviço hospedado, ou a opção de rodar por conta própria; Para as ferramentas que mexem na sua instância: N8N_API_URL e N8N_API_KEY.
Leia o aviso de segurança antes de começar
O README pede para nunca editar fluxos de produção diretamente com IA. Faça uma cópia do fluxo e teste em ambiente de desenvolvimento.
Entre no painel hospedado
O jeito mais rápido segundo o README é usar o painel hospedado, sem instalar nada. Crie a conta e pegue a sua chave de API.
Abra o guia do Claude Code
O README tem um guia próprio para o Claude Code, dentro do repositório, no arquivo docs/CLAUDE_CODE_SETUP.md. O comando exato de conexão está nesse guia, e não no README principal, por isso ele não é reproduzido aqui.
Conecte o cliente com a chave de API
Siga o guia do Claude Code para registrar o servidor usando a chave que você pegou no painel.
Se preferir, rode por conta própria
O README indica um guia de auto-hospedagem com as opções npx, Docker, Railway e instalação local.
Só ligue a sua instância do n8n se precisar
As ferramentas de gerenciamento de fluxos exigem configurar o endereço (N8N_API_URL) e a chave de API (N8N_API_KEY) da sua instância do n8n. A chave é criada na instância, em Settings → API, e o README recomenda uma chave somente leitura quando o objetivo é só consultar. Sem isso, o servidor ajuda com consulta de nós e modelos.
Primeiro teste
O README não traz um pedido de teste. Peça uma tarefa simples e confira se o servidor entra em ação.
Cuidados
- O README alerta: nunca edite fluxos de produção diretamente com IA. Faça cópia, teste em desenvolvimento, exporte backups e valide antes de publicar.
- Com a instância do n8n conectada, há ferramentas que criam, atualizam e apagam fluxos, além de gerenciar credenciais. O README tem uma receita de implantação somente leitura usando DISABLED_TOOLS.
- O README recomenda combinar o modo somente leitura com uma chave de API do n8n que também seja somente leitura.
- O README tem um documento sobre privacidade e telemetria (PRIVACY.md) com o que é coletado e como desligar. Leia antes de usar.
Como desfazer
O README principal não traz um passo de remoção. Ele aponta apenas para os guias de instalação.
O que o README não confirma
Esta página foi montada lendo o README. Estes pontos não estão escritos lá:
- O README principal não traz o comando de conexão para o Claude Code. Ele está no guia docs/CLAUDE_CODE_SETUP.md, que não foi lido.
- O que o painel hospedado coleta e como a telemetria funciona fica em outros documentos do repositório, que não foram lidos.
- Preço depois da faixa gratuita não aparece no README.
- Os números de nós, modelos e testes são do autor e não foram conferidos.
Dúvidas
Existe versão gratuita?
O README cita uma faixa gratuita no painel hospedado, com limite de 100 chamadas de ferramenta por dia.
Preciso ter o n8n instalado?
Para consultar nós e modelos, o README não exige. Para criar e editar fluxos na sua instância, é preciso informar o endereço e a chave de API dela.
Posso testar com segurança?
O README manda copiar o fluxo antes, testar em desenvolvimento e manter backups.
A DNACX usa o n8n-mcp?
Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.
Próximo da lista
Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de czlonkowski/n8n-mcp, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.