n8n-skills: 14 skills do Claude Code para criar workflows no n8n (via MCP)

Se você usa o n8n para automação e queria que o Claude Code montasse os workflows por você — sem errar o tipo de nó, sem quebrar expressão e sem entrar naquele loop infinito de erro de validação — é exatamente para isso que serve o n8n-skills. É um pacote de 14 skills (mais uma skill roteadora e uma camada de hooks) que ensina a IA a construir workflows n8n prontos para produção, usando o servidor n8n-mcp (MCP). Funciona no Claude Code, no Claude.ai e via API. Neste guia você vê o que é, para que serve, como instalar o MCP passo a passo, como usar e exemplos reais.

O que é o n8n-skills (e onde entra o n8n-mcp)

São duas peças que trabalham juntas, e é importante não confundir:

• n8n-mcp — é o servidor MCP. Ele expõe a documentação dos nós do n8n e a API da sua instância como ferramentas que o Claude pode chamar. Ele conhece mais de 500 tipos de nó e tem uma biblioteca com milhares de templates reais de workflow para servir de exemplo.

• n8n-skills — é a camada de conhecimento. São as 14 skills que ensinam o Claude a usar bem essas ferramentas: quais padrões seguir, como escrever expressões, como configurar cada nó, como tratar erro, como validar. Sem elas, a IA sabe chamar as ferramentas, mas erra o jeito.

Juntando os dois, o Claude passa a ter, nas palavras do projeto, "os instintos de um engenheiro n8n sênior": ele escolhe o tipo de nó certo, escreve as expressões corretas, cria as ramificações de erro e a lógica de retry — em vez de alucinar um nó que não existe ou uma expressão que quebra.

Para que serve — o problema que ele resolve

Quando você pede pra uma IA montar um workflow no n8n "no seco", ela costuma tropeçar sempre nos mesmos pontos. O n8n-skills foi desenhado justamente para eliminar isso:

• Usar as ferramentas do MCP de forma errada ou ineficiente.

• Ficar preso em loops de erro de validação.

• Não saber qual padrão de workflow aplicar para cada caso.

• Configurar nós e suas dependências de forma incorreta (o clássico "por que meu HTTP Request não manda o corpo?").

Resumo prático: em vez de você revisar e corrigir a mão cada workflow que a IA gera, o n8n-skills faz a IA já entregar o workflow no formato de produção — com tipos de nó corretos, expressões válidas, ramos de erro e retry.

As 14 skills — o que cada uma faz

Cada skill cobre um pedaço da construção de um workflow. Elas se combinam sozinhas conforme o que você pede:

Além dessas 14, o pacote traz uma skill roteadora sempre ligada (que decide qual skill usar) e uma camada de hooks que dispara antes das chamadas mais sensíveis ao n8n-mcp para dar o contexto certo na hora.

Antes de começar: o que você precisa

• Uma instância do n8n (na nuvem ou self-hosted) com a API habilitada.

• Claude Code instalado (também funciona no Claude.ai ou via API, com ressalvas que explico no fim).

• Node.js, para rodar o n8n-mcp via npx — a não ser que use a versão hospedada (abaixo).

Como instalar o n8n-mcp (o servidor MCP)

Você tem dois caminhos. Escolha um:

Caminho rápido — versão hospedada (sem instalar nada)

O jeito mais rápido de experimentar é a versão hospedada, no painel em dashboard.n8n-mcp.com. Tem um plano gratuito com 100 chamadas de ferramenta por dia e não exige instalação. Bom para testar antes de montar tudo na sua máquina.

Caminho local — via npx (recomendado para uso de verdade)

Aqui você roda o MCP na sua máquina e conecta na sua instância do n8n. São três passos:

Passo 1 — Pegue a chave de API do n8n

Na sua instância do n8n, vá em Settings → n8n API e clique em Create API Key. Copie a chave e guarde a URL da sua instância (ex.: https://sua-instancia.n8n.cloud). Se você roda o n8n localmente, a URL é http://localhost:5678.

Passo 2 — Crie o arquivo .mcp.json

Na raiz do seu projeto, crie um arquivo .mcp.json com este conteúdo, trocando a URL e a chave pelos seus valores:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://sua-instancia.com",
        "N8N_API_KEY": "sua-chave-de-api"
      }
    }
  }
}

Passo 3 — Registre o MCP no Claude Code

Depois de salvar o .mcp.json, rode:

claude mcp add n8n-mcp --scope project

Cuidado com a chave de API: o .mcp.json guarda a N8N_API_KEY em texto puro. Não suba esse arquivo para um repositório público — coloque no .gitignore.

Como instalar as 14 skills

Com o MCP no lugar, instale o pacote de skills. Dentro do Claude Code, o jeito recomendado é um comando só:

/plugin install czlonkowski/n8n-skills

Se preferir pelo marketplace de plugins:

/plugin marketplace add czlonkowski/n8n-skills
/plugin install
# selecione "n8n-mcp-skills" na lista

Ou manualmente, copiando as pastas das skills para o seu diretório do Claude:

git clone https://github.com/czlonkowski/n8n-skills.git
cp -r n8n-skills/skills/* ~/.claude/skills/
# recarregue o Claude Code

No Claude.ai (versão web), o caminho é outro: baixe as pastas das skills (ou os zips prontos das releases), zipe cada skill e envie em Settings → Capabilities → Skills.

Como usar — as skills ativam sozinhas

Aqui está a melhor parte: você não precisa "chamar" a skill. Uma skill roteadora, carregada por um hook no início da sessão, lê o que você pediu e direciona para a skill certa (ou para várias em sequência). Você só descreve o que quer, em linguagem natural, e o Claude puxa o conhecimento necessário.

Alguns exemplos de pergunta e a skill que entra em ação:

Exemplos de uso

O poder real aparece quando várias skills se combinam num pedido só. Um exemplo do próprio projeto: ao pedir

Monte e valide um workflow que recebe um webhook e manda a mensagem para o Slack.

o Claude encadeia, em ordem: Workflow Patterns (escolhe o padrão de webhook) → MCP Tools Expert (acha os nós certos) → Node Configuration (configura cada um) → Code JavaScript (trata os dados) → Expression Syntax (monta as expressões) → Validation Expert (valida no fim). O resultado é um workflow que já sobe funcionando, não um rascunho pra você depurar.

Outros pedidos que funcionam bem:

• "Crie um workflow agendado que consulta uma API todo dia às 8h e salva no banco."

• "Adicione tratamento de erro e retry nesse workflow que já montei."

• "Monte um agente de IA que classifica e-mails e responde com base em uma base de conhecimento (RAG)."

Erros comuns e cuidados

• Esquecer a API do n8n. Sem a N8N_API_KEY e a N8N_API_URL corretas, o MCP até responde sobre os nós, mas não consegue criar/executar nada na sua instância.

• Apontar para a instância errada. Se você tem mais de uma conta n8n, use a skill Multi-Instance para confirmar em qual instância o workflow vai parar.

• Python com bibliotecas externas. O nó Code em Python não aceita requests, pandas ou numpy — a skill de Python já te avisa disso antes de você quebrar a cara.

Perguntas frequentes