Claude Code e n8n: crie fluxos automáticos com 1 prompt
Aprenda a usar o Claude Code e n8n com MCP para criar workflows automaticamente. Sem programar, só com um prompt no terminal.
O elo entre o Claude Code e o n8n é o MCP. Ative o Instance level MCP nas configurações do n8n (versão 2.14.1 ou superior), gere um token de acesso e registre o servidor no terminal com claude mcp add --transport http n8n-mcp. Depois disso, você descreve o fluxo em linguagem natural e o Claude Code monta o workflow na sua instância. Criar workflow exige o Claude Code: o Claude Desktop apenas lê e executa.
O que você vai ver aqui?
Introdução
Usar o Claude Code e n8n juntos é uma das formas mais rápidas de montar automações complexas hoje em dia, sem arrastar um único bloco no editor. Você descreve o que precisa, manda para o Claude Code pelo terminal e ele cria o workflow inteiro dentro da sua instância do n8n.
Mas para isso funcionar, existe um componente que conecta tudo: o MCP. Neste artigo, você vai aprender passo a passo como instalar o Claude Code, configurar o VS Code, habilitar o MCP no n8n e disparar um prompt para criar seu primeiro fluxo automático.
Se você ainda não conhece o n8n, vale dar uma passada no nosso artigo sobre o que é o n8n antes de continuar.
O que você precisa para começar
Para criar fluxos no n8n com prompt, você vai precisar de três elementos funcionando juntos: Claude Code, uma instância do n8n na versão certa e o protocolo MCP configurado. Cada um tem um papel específico nessa integração.
Claude Code
O Claude Code é uma ferramenta da Anthropic que funciona direto no terminal ou em uma IDE, como o VS Code. Diferente do chat normal do Claude, aqui a IA tem acesso ao seu ambiente local, podendo criar arquivos, executar comandos e se conectar a ferramentas externas via MCP. Você pode ler mais sobre o Claude Code e como usá-lo na prática no nosso blog. Para usá-lo, você precisa de uma assinatura ativa do Claude, como o plano Pro.
n8n na versão correta
Nem toda versão do n8n suporta o MCP de instância. Para essa integração funcionar, você precisa da versão 2.14.1 ou superior. Essa versão trouxe o recurso de “Instance Level MCP”, que permite que ferramentas externas, como o Claude Code, criem, leiam e executem workflows dentro da sua instância. Você pode conferir todas as versões disponíveis no GitHub do n8n.
O protocolo MCP
O MCP (Model Context Protocol) é um protocolo aberto criado pela Anthropic para conectar IAs a ferramentas externas de forma padronizada. Pense nele como um conector universal, o cabo USB-C da inteligência artificial: uma única interface para plugar o Claude ao n8n, ao Gmail, ao Google Sheets, ao Figma e ao que mais você precisar. Quer entender mais fundo como ele funciona? Temos um artigo completo sobre o Model Context Protocol aqui no blog.
Como instalar e abrir o Claude Code
A instalação é simples e leva menos de cinco minutos. Veja o passo a passo:
- Acesse o site do Claude (claude.ai), vá em Product > Claude Code e copie o comando de instalação exibido na página.
- Abra o terminal do seu computador (PowerShell no Windows ou Terminal no Mac/Linux) e cole o comando. Execute. Pronto, o Claude Code está instalado.
- Instale o VS Code caso ainda não tenha. Abra o VS Code, vá em Arquivo > Abrir Pasta e selecione (ou crie) uma pasta de trabalho para o seu projeto.
- Dentro do VS Code, abra o terminal integrado pelo menu Terminal > Novo Terminal ou arraste a barra inferior para cima.
- No terminal integrado, digite
claudee pressione Enter. O Claude Code abre no próprio terminal. - Na primeira execução, ele pede para você escolher tema (Dark/Light) e depois abre uma página no navegador para autenticar sua conta Anthropic. Autorize o acesso e volte ao VS Code.
- Confirme as configurações recomendadas e aprove o uso da pasta aberta. Claude Code está pronto para usar.
Como conectar o Claude Code ao n8n via MCP
Com o Claude Code instalado, o próximo passo é criar a ponte entre ele e o seu n8n. Esse processo tem duas partes: habilitar o MCP dentro do n8n e rodar o comando de conexão no terminal.
Habilite o MCP no n8n
Abra sua instância do n8n no navegador e siga estes passos:
- Clique no ícone de configurações no canto inferior esquerdo.
- Procure a opção Instance level MCP e clique nela.
- Ative o botão Enable MCP access.
- Clique em Generate new access token e copie o token gerado. Guarde esse token, você vai precisar dele logo.
Lembre-se: só funciona com o n8n na versão 2.14.1 ou mais recente. Se o menu “Instance level MCP” não aparecer, atualize sua instância. Confira a documentação oficial do n8n sobre MCP para mais detalhes.
Configure a conexão no terminal
Agora volte ao terminal do VS Code (com o Claude Code aberto) e use o comando da documentação oficial do n8n para registrar o MCP server. O formato é:
claude mcp add --transport http n8n-mcp https://<seu-dominio-n8n>/mcp-server/http --header "Authorization: Bearer <SEU_TOKEN>"Substitua <seu-dominio-n8n> pela URL completa da sua instância (por exemplo, https://n8n.suaempresa.com) e <SEU_TOKEN> pelo token que você copiou no passo anterior. Pressione Enter, confirme a aprovação que o Claude Code pede e pronto. Você verá a mensagem “MCP Server n8n-mcp adicionado com sucesso”.
Agentes de IA e n8n ImpressionadorCrie agentes de IA que trabalham por você e automações que rodam sozinhas, sem escrever uma linha de código. Aprenda o n8n do zero, conecte WhatsApp, e-mail, planilhas e os sistemas que a empresa já usa, e monte projetos reais como agente de atendimento, de cobrança e de triagem de currículos.
Começar agora
Crie um workflow no n8n com um prompt
Com tudo conectado, a criação de workflows vira uma conversa. No terminal do Claude Code, descreva o fluxo que você precisa em linguagem natural. Quanto mais específico, melhor o resultado.
Um exemplo prático: “Crie um workflow no n8n chamado Relatório Semanal Automático. Toda sexta-feira, leia uma planilha do Google Sheets com as atividades do time, consolide tudo e mande para a IA criar um relatório em HTML e enviar por e-mail para a liderança.”
Após enviar o prompt, o Claude Code começa a trabalhar. Ele vai buscar a documentação dos nós, montar a estrutura do workflow e pedir aprovação antes de cada ação que modifique sua instância ou seus arquivos. Na primeira vez, aprove passo a passo e leia cada solicitação. Depois, quando você conhecer bem o processo, pode habilitar aprovações automáticas para ganhar velocidade.
Quando terminar, abra o n8n no navegador. O novo workflow vai aparecer na lista com um ícone especial indicando que está MCP-enabled. Você verá os nós criados automaticamente: gatilho de agendamento, leitura do Google Sheets, processamento por IA e envio por e-mail. Só vai precisar conectar suas credenciais (conta Google, OpenAI, Gmail) e o fluxo estará pronto para rodar. Para saber mais sobre como montar agentes dentro do n8n, veja nosso artigo sobre agente de IA com n8n.
O que mais você pode fazer com essa integração
Criar workflows é só o começo. O Claude Code com MCP do n8n permite outras ações muito úteis no dia a dia:
- Modificar fluxos existentes: peça para o Claude alterar um nó específico ou adicionar uma nova etapa em um workflow que já existe.
- Executar workflows: dispare a execução de um fluxo diretamente pelo terminal, sem precisar abrir o n8n.
- Documentar fluxos: o Claude lê cada nó do workflow e gera um documento explicando o que faz, como configurar e quais dependências existem, ideal para times.
- Conectar mais ferramentas via MCP: além do n8n, você pode adicionar outros MCP servers ao Claude Code (Google Workspace, GitHub, Slack) e fazer com que a IA acesse essas ferramentas na mesma sessão.
- Criar fluxos mais complexos: subworkflows, agentes de IA com memória, integrações com APIs externas, tudo com um prompt bem estruturado.
Esse nível de controle transforma o Claude Code em um copiloto de automação real. E como o MCP é um protocolo aberto e padronizado, a tendência é que cada vez mais ferramentas ofereçam suporte nativo, ampliando ainda mais o que dá para fazer com um único prompt pro Claude Code.
Conclusão
A combinação de Claude Code e n8n via MCP representa uma mudança real na forma de trabalhar com automações. Em vez de montar fluxo a fluxo no editor visual, você descreve o processo em linguagem natural e a IA faz o trabalho operacional por você, deixando o seu foco onde realmente importa: na lógica de negócio.
Se você quiser dominar essa stack do zero, o Curso Completo No Code + IA da Hashtag tem tudo que você precisa: n8n, agentes de IA, Claude e muito mais. Acesse e comece hoje.
Além disso, se preferir esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!
O que você aprende neste vídeo
Resposta rápida: O elo entre o Claude Code e o n8n é o MCP. Ative o Instance level MCP nas configurações do n8n, gere um token de acesso e registre o servidor pelo terminal. Feito isso, você descreve o fluxo em linguagem natural e ele é criado na sua instância. Criar fluxo exige o Claude Code e o n8n na versão 2.14.1 ou superior.
Neste vídeo (21 min):
- 0:40 - lista os requisitos e apresenta o MCP como conexão padronizada entre ferramentas
- 1:55 - copia o comando de instalação do Claude Code e roda no terminal
- 5:00 - roda
claudena pasta do projeto e conecta a conta pelo navegador - 7:10 - confere a versão do n8n, que precisa ser 2.14.1 ou superior
- 8:10 - ativa Instance level MCP nas configurações do n8n
- 10:00 - mostra que o Claude Desktop lê e executa, mas não cria fluxos
- 10:40 - cola o comando da documentação e informa o domínio do n8n
- 12:00 - gera o token de acesso e conclui a conexão MCP
- 13:30 - descreve o fluxo desejado em linguagem natural e envia o prompt
- 14:30 - aprova cada ação antes de liberar as aprovações automáticas
- 15:50 - abre o fluxo pronto no n8n e conecta as credenciais que faltam
- 19:20 - pede ao Claude para modificar e documentar fluxos existentes
Trechos do vídeo:
- O MCP conecta diversas ferramentas à inteligência artificial de forma padronizada, como um cabo universal.
- Conectado ao Claude Desktop, você lê e executa fluxos, mas para criar precisa do Claude Code.
- Na primeira vez, aprove uma ação de cada vez e leia o que está sendo autorizado.
FAQ – Perguntas Frequentes sobre Claude Code e n8n
1. Preciso saber programar para usar o Claude Code com n8n?
Não. O objetivo dessa integração é exatamente eliminar a necessidade de programar. Você descreve o fluxo que quer criar em linguagem natural e o Claude Code monta o workflow no n8n para você. O conhecimento de como o n8n funciona (nós, gatilhos, credenciais) ajuda a dar prompts melhores, mas não é obrigatório para começar.
2. Qual a diferença entre o Claude Desktop e o Claude Code para uso com n8n?
O Claude Desktop consegue ler e executar workflows no n8n via MCP, mas não tem permissão para criar novos fluxos. Para criação de workflows, você precisa do Claude Code, que roda no terminal ou IDE. É por isso que o processo descrito neste artigo usa o Claude Code.
3. O que acontece se eu aprovar uma ação errada no Claude Code?
O Claude pode modificar arquivos locais, criar ou sobrescrever workflows no n8n e até executar fluxos existentes. Por isso, nas primeiras vezes, leia cada solicitação de aprovação antes de confirmar. Se algo der errado, o n8n mantém histórico de execuções e você pode desfazer manualmente as alterações feitas nos workflows.
4. Por que a opção Instance level MCP não aparece no meu n8n?
Quase sempre é versão: o recurso existe a partir do n8n 2.14.1. Atualize a instância e o item passa a aparecer no menu de configurações, no canto inferior esquerdo. Se a instância é administrada por outra pessoa, peça a atualização a quem cuida dela.
5. Dá para o Claude Code editar workflows que já existem no n8n?
Dá. Além de criar, ele lê, altera e executa fluxos já existentes na instância conectada — você pode pedir a troca de um nó específico ou o acréscimo de uma etapa. Toda ação que modifica algo passa por uma aprovação sua no terminal.
Hashtag Treinamentos
Para acessar outras publicações de No Code, clique aqui!
Posts mais recentes de No Code
- Dots do ChatGPT: o que é e como usar esse agente de IA
Descubra o que é o Dots do ChatGPT, como configurar, integrar com Slack e agenda e se vale a pena usar esse novo agente de IA da OpenAI. - GPT-6 Astra: 7 usos reais do novo modelo da OpenAI
Veja 7 usos reais do GPT-6 Astra, o novo modelo da OpenAI que executa tarefas sozinho no computador. Entenda como ele funciona e onde ainda erra. - Jev IA: o que é e como usar essa IA que não escreve
Entenda o que é o Jev IA, a inteligência artificial classificadora mais rápida e barata do mercado, e veja 5 usos práticos para seus fluxos.
Posts mais recentes da Hashtag Treinamentos
- Planilha de Controle de Notas Fiscais no Excel [Grátis]
Baixe a planilha de controle de notas fiscais no Excel grátis: calcule ISS e retenções, veja o que está em aberto e gere a cobrança de cada nota de serviço. - Qual IA usar na empresa: ChatGPT, Claude ou Perplexity?
Qual IA usar na empresa: veja as diferenças entre ChatGPT, Claude e Perplexity e quando cada um rende mais em cada área da sua equipe. - Apostilas Gratuitas em PDF: Excel, Power BI, Python e IA
Baixe apostilas gratuitas em PDF de Excel, Power BI, Python, Claude e agentes de IA, com exercícios e gabarito. Escolha a sua e comece hoje.
