Como Criar Fluxos no n8n com Claude Code no VS Code (Passo a Passo)

A era da automação "clica e arrasta" está passando por uma transformação radical. Se você trabalha com o n8n, sabe que o verdadeiro valor não está em conectar nós ou ajustar parâmetros de JSON, mas sim na lógica de negócio que esses fluxos resolvem. No entanto, até ontem, o tempo gasto no operacional ainda era o maior gargalo de qualquer analista de dados.

Com o lançamento do Claude Code, a Anthropic mudou as regras do jogo. Saímos da automação reativa para a Engenharia de Agentes.

Imagine ter um copiloto sênior dentro do seu VS Code que não apenas sugere código, mas entende a arquitetura do n8n, cria os fluxos por você e ainda ajuda a construir interfaces modernas no Lovable para que qualquer pessoa possa "conversar" com esses dados.

Neste guia completo do TheBILab, vamos mergulhar na configuração técnica e estratégica para você parar de construir fluxos manualmente e começar a orquestrar sistemas de inteligência autônomos.

O Que é o Claude Code e Como ele Cria Fluxos do n8n

Automação e análise de dados sempre tiveram um ponto de fricção. Você começa com um objetivo simples, como integrar uma planilha e gerar um relatório, e em poucos minutos já está ajustando credenciais, revisando nós, testando webhooks, corrigindo detalhes e repetindo etapas.

O Claude Code entra exatamente nesse buraco de tempo. Em vez de construir tudo do zero, nó por nó, você descreve o que quer em linguagem natural e deixa a IA estruturar arquivos, organizar o projeto e acelerar a criação dos workflows. Ele não é apenas um chat dentro do VS Code: funciona como um agente de execução com contexto de projeto, capaz de ler e criar arquivos, ajustar configurações e seguir instruções com foco em fazer, não só responder.

Na prática, você sai do modo “perguntar coisas para a IA” e entra no modo “orquestrar um ajudante” que produz entregáveis concretos: JSONs de workflow do n8n, arquivos de configuração MCP, estruturas de pasta e até prompts de agentes de análise de dados, como no exemplo da imobiliária demonstrado no vídeo abaixo.

Assista primeiro, execute depois

Se você quer ver a configuração na tela e o fluxo rodando do começo ao fim, assista ao vídeo abaixo. Depois volte para seguir o passo a passo com calma, usando as imagens e exemplos para replicar no seu ambiente.

https://www.youtube.com/watch?v=KyUITMhP18E

Pré-requisitos para usar Claude Code no VS Code com n8n

Para seguir o passo a passo, você precisa do seguinte:

• Ter o VS Code instalado. Onde tudo vai rodar, é o seu editor principal.

• Extensão do Claude Code. É ela que coloca o agente de execução dentro do editor, com acesso ao projeto.

• Conta no Claude com suporte ao Claude Code. Necessária para rodar o agente com acesso a arquivos e ações no editor.

• n8n versão 2.0 ou superior. Garante compatibilidade com recursos atuais de API e integração; no vídeo vocês usam a 2.6.1.

• API Key do n8n. Permite conexão segura via MCP para criar e atualizar workflows automaticamente.

• Lovable (opcional). Serve para criar a interface de chat que “conversa” com o fluxo do n8n, usando o webhook como ponte.

Passo a passo para configurar Claude Code e criar workflows no n8n

1. Preparação do ambiente e extensões

Objetivo: criar um projeto isolado e evitar bloqueios de permissão.

Crie uma pasta dedicada ao projeto, por exemplo claude-code-n8n, e abra essa pasta no VS Code. Isso define um escopo claro de arquivos que o agente poderá ler e escrever, sem misturar com outros documentos.

Instale a extensão “Claude Code for VS Code” e, nas configurações da extensão, habilite as permissões de acesso a arquivos e pastas do projeto. Sem isso, o Claude não consegue criar o agente.md, arquivos de configuração ou JSON de workflow para o n8n.

2. Criando o System Prompt (agente.md)

Objetivo: padronizar o comportamento do agente e economizar contexto/tokens.

Com a pasta aberta, crie um arquivo Markdown na raiz, como agente.md ou claudecode.md.

Esse arquivo é o “manual de instruções permanente” do seu agente:

• Explique o objetivo do projeto (ex.: criar e documentar fluxos n8n para uma imobiliária).

• Descreva o contexto de negócio e as fontes de dados (planilhas, abas, IDs que conectam tabelas).

• Defina regras de resposta, formato de saída, idioma, tom e limites (por exemplo, não expor credenciais).

Manter esse contexto no arquivo economiza tokens, porque você não precisa repetir tudo a cada comando, e deixa o comportamento da IA mais consistente ao longo de todo o projeto.

3. Instalando habilidades e servidores MCP

Objetivo: dar ao agente a estrutura correta para gerar workflows válidos.

Para o Claude “entender n8n” de verdade, você precisa dar duas coisas a ele:

• Habilidades (Skills): São conjuntos de conhecimento e padrões que ensinam como um workflow do n8n é estruturado, quais nós existem, como se conectam e quais campos são necessários.

• Servidor MCP. É a ponte que conecta o agente ao n8n, permitindo criar, atualizar e publicar workflows via API, sem depender de copiar e colar JSON manualmente.

Na prática, isso reduz o trabalho repetitivo e diminui erros de estrutura: o agente passa a gerar fluxos já no formato esperado pelo n8n, com nós conectados, Webhook configurado e documentação básica pronta. No vídeo, você mostra essa configuração acontecendo na tela com o projeto real, o que ajuda muito a tirar dúvidas de quem nunca mexeu com MCP.

4. Conexão segura via API Key

Objetivo: integrar com segurança e acelerar o ciclo de testes.

No painel do n8n, vá em Settings e gere uma API Key específica para o uso com o Claude. Em seguida:

• Crie um arquivo de configuração no projeto, por exemplo .mcp.json. Nesse arquivo, informe a URL da sua instância n8n e a API Key gerada.

Esse arquivo centraliza a conexão: o agente passa a saber para onde mandar os workflows e com qual credencial autenticar, sem você precisar reescrever isso em cada prompt.

Trate esse arquivo como sensível. O ideal é:

• Não versioná-lo em repositórios públicos.

• Colocar o nome dele no .gitignore.

Isso evita vazamento de credenciais e reforça sua autoridade, mostrando que você se preocupa com boas práticas de segurança.

5. Criando o primeiro fluxo via prompt

Objetivo: transformar uma descrição de negócio em um workflow funcional.

Com o ambiente configurado, o arquivo de agente pronto e a conexão definida, você pode pedir workflows em linguagem natural. Em vez de “faça algo com IA”, descreva um processo real, por exemplo:

“Crie um workflow que receba mensagens via Telegram, consulte uma planilha do Google Sheets para qualificar o lead, classifique o cliente e responda automaticamente com base nessa classificação.”

O Claude tende a seguir uma linha de trabalho como:

• Planejar a estrutura do fluxo (gatilho, nós intermediários, saída).

• Criar os arquivos necessários e o JSON do workflow.

• Ajustar a estrutura caso haja erros de tipo ou de conexão de nós.

• Ajudar você a publicar e testar esse fluxo dentro do n8n.

No caso que mostramos no vídeo, o fluxo para imobiliária lê várias abas de uma planilha, cruza dados por ID, calcula metas e gera ranking de corretores e insights de gestão a partir dessas informações, tudo montado em poucos segundos com apoio do agente.

N8N + Lovable: Como Tranformar a Automação em Interface

O n8n é o “motor” que processa dados e regras, mas quem sente o valor é o usuário que faz perguntas e recebe respostas claras. É aí que entra o Lovable.

A ideia é simples:

• O n8n processa: recebe uma pergunta, consulta planilhas ou APIs, roda o agente de IA e estrutura a resposta.

• O Lovable apresenta: oferece uma interface de chat ou painel onde o gestor/analista escreve perguntas e recebe análises prontas.

No fluxo que demonstramos:

• O Lovable chama o webhook do n8n por POST, usando a URL gerada no workflow.

• O n8n executa o fluxo com o “analista de IA”, busca dados no Google Sheets e monta a resposta.

• O Lovable exibe resultados como performance por corretor, performance por região, taxa de conversão e recomendações práticas.

Para o analista, isso significa menos tempo construindo telas e mais tempo refinando lógica e métricas. Para o gestor, significa acesso rápido a respostas sem depender de abrir planilhas e relatórios.

Quer ver esse setup inteiro rodando em um caso real de imobiliária, com a tela do VS Code, o fluxo no n8n e a interface no Lovable? Assista ao vídeo completo. Depois, se fizer sentido para você, acompanhe o canal TheBILab para receber os próximos tutoriais de automação com IA aplicada ao dia a dia de dados.

FAQ – Dúvidas sobre Claude Code, VS Code e n8n

Pergunta: O Claude Code é melhor que o ChatGPT para criar automações?

Resposta: Sim, para quem usa VS Code. Diferente do ChatGPT, o Claude Code tem contexto do seu projeto local, o que permite que ele entenda a estrutura de pastas e configure o servidor MCP do n8n automaticamente.

Claude Code funciona no Mac e Linux ou só no Windows?

Ele funciona em qualquer sistema em que o VS Code e a extensão sejam compatíveis, incluindo Windows, macOS e distribuições comuns de Linux, desde que haja conexão com a conta Claude e acesso aos arquivos do projeto.

Qual versão do n8n devo usar com Claude Code?

Use n8n 2.0 ou superior para garantir compatibilidade com recursos de API e integrações modernas; no exemplo do vídeo, a versão é 2.6.1.

Onde encontro a API Key no n8n e o que fazer se não aparece?

A API Key é gerada no menu de configurações do n8n, em “n8n API”. Se a opção não aparece, verifique permissões de usuário ou se sua instância está atualizada para uma versão compatível.

O que colocar no .gitignore para não vazar credenciais?

Inclua arquivos que contenham chaves e URLs sensíveis, como .mcp.json, arquivos .env e qualquer outro arquivo de configuração com tokens ou senhas.

Qual a diferença entre Webhook do n8n e MCP?

O Webhook do n8n é uma URL que recebe requisições externas para disparar um fluxo. Já o MCP é um protocolo que permite ao Claude Code se conectar ao n8n como “cliente” de API, criando e ajustando workflows automaticamente.

Posso usar isso só com Google Sheets ou também com bancos como Supabase e BigQuery?

Você pode usar com qualquer fonte suportada pelo n8n: Google Sheets, bancos SQL, Supabase, BigQuery, APIs externas e mais, desde que configure os nós e credenciais corretos.

Quanto custa manter esse setup em produção?

O custo depende da combinação: plano do Claude, hospedagem do n8n (cloud ou self-hosted), e, se usado, custos de banco de dados e serviços conectados. O Lovable pode ser usado em plano gratuito para interfaces simples, como mostrado no vídeo.

Pergunta: Consigo usar o Claude Code para consertar erros em fluxos que já tenho?

Resposta: Com certeza. Ao conectar sua API Key do n8n, você pode pedir ao Claude para analisar um fluxo específico e encontrar gargalos ou erros de lógica nos nós de função.

Continue com o TheBILab

🌟 Seja Membro do TheBILab - É Gratuito

Tenha acesso a uma área exclusiva com minicursos, eBooks e materiais sobre dados, IA e automação. Receba no seu e-mail, toda semana, os melhores conteúdos para se manter atualizado.➡️ Quero Ser Membro

🎥 Aprenda na prática com nossos vídeos no YouTube

Assista tutoriais, estudos de caso e aulas rápidas sobre como criar dashboards, usar IA e aplicar dados no dia a dia. ➡️ Acessar Canal

🤝 Soluções para empresas que querem ir além com dados e IA

O TheBILab oferece palestras, mentorias e serviços em Análise de Dados, IA, Web Analytics, Automação e muito mais.➡️ Fale com a Gente