n8n Flows

O que faz

O n8n Flows ajuda você a projetar automações descrevendo o que quer em português

e recebendo de volta um workflow JSON pronto para importar no n8n. Em vez de

arrastar nós um a um na interface, você explica o objetivo ("quando chegar um lead no

formulário, salve na planilha e me avise no Slack") e o plugin monta a estrutura de

nós, conexões e parâmetros, deixando apenas as credenciais para você plugar.

O n8n é uma plataforma de automação open-source (alternativa ao Zapier/Make) que roda

no seu próprio servidor. Um workflow é um JSON com nodes e connections. Este plugin

conhece esse formato e os nós mais comuns (Webhook, HTTP Request, Schedule Trigger,

IF, Set, Google Sheets, Slack, Gmail, etc.), produzindo um arquivo que você importa via

"Import from File" ou cola no canvas.

Casos de uso típicos:

• Conectar um formulário a uma planilha e a uma notificação.
• Criar rotinas agendadas (ex.: todo dia às 8h, buscar dados de uma API e resumir).
• Encadear chamadas HTTP com transformação de dados no meio.
• Prototipar rapidamente uma automação para depois refinar na interface do n8n.

Instalação

1. Copie a pasta n8n-flows/ para o diretório de plugins do Claude Code.
2. Tenha uma instância do n8n disponível (cloud ou self-hosted).
3. (Opcional) Defina N8N_BASE_URL e N8N_API_KEY se quiser que o plugin envie o

fluxo direto via API; caso contrário, ele apenas gera o arquivo para import manual.

1. Reinicie o Claude Code.

Comandos disponíveis

• /n8n-criar — gera um workflow n8n completo (JSON) a partir de uma descrição em

linguagem natural e salva em um arquivo .json.

• /n8n-explicar — lê um JSON de workflow do n8n e explica, passo a passo, o que

ele faz, apontando riscos e pontos a configurar.

Configuração

Use sempre o nome da variável de ambiente — nunca cole tokens reais.

• N8N_BASE_URL — opcional; URL da sua instância (ex.: https://n8n.suaempresa.com).
• N8N_API_KEY — opcional; chave de API para criar/atualizar workflows via REST.
• N8N_FLOWS_DIR — opcional; pasta onde os JSONs gerados serão salvos

(padrão: ./n8n-flows).

As credenciais dos serviços (Google, Slack, etc.) não vão no JSON do workflow:

no n8n elas ficam no cofre de credenciais da própria plataforma. O plugin gera os nós

referenciando credenciais por nome, para você selecionar na interface.

Exemplo de uso

/n8n-criar Quando alguém enviar o formulário de contato (webhook),
adicione a linha numa planilha do Google Sheets e me avise no canal #vendas do Slack.

O Claude gera um JSON com três nós (Webhook → Google Sheets → Slack) e as conexões

entre eles, salva em ./n8n-flows/contato-para-sheets-slack.json e explica o que

configurar. Você importa no n8n, escolhe suas credenciais e ativa.

Para entender um fluxo recebido de outra pessoa:

/n8n-explicar ./n8n-flows/legado.json

Segurança e limites

• Nunca coloque chaves de API dentro do JSON do workflow. Use o gerenciador de

credenciais do n8n. O plugin é desenhado para não embutir segredos.

• Revise antes de ativar. O JSON gerado é um ponto de partida; valide URLs,

métodos HTTP e mapeamento de campos antes de colocar em produção.

• Webhooks são públicos: proteja endpoints sensíveis com autenticação no nó de

Webhook e, se possível, com um header secreto.

• Limites: automações que disparam e-mails ou mensagens em massa devem respeitar

limites de envio e regras anti-spam. O plugin não envia nada sozinho — só gera o

fluxo.

• Compatibilidade: valide a versão dos nós com a sua instância do n8n; nós muito

novos podem não existir em versões antigas.