Usando as Skills n8n-mcp

Quando Usar

Use este roteador no início de qualquer tarefa de design, inspeção, edição, validação, teste, implantação, credencial, execução ou solução de problemas de um fluxo de trabalho n8n MCP para que a orientação especializada relevante seja carregada primeiro.

Comece com descoberta somente leitura e inspeção de esquema ao vivo. Nunca copie segredos em prompts ou campos de fluxo de trabalho, nunca infira a instância de destino e obtenha aprovação antes de testes com efeitos colaterais, ativação, exclusão, mutação de credenciais ou outras alterações externamente visíveis.

Este é um roteador, não uma referência. Ele informa qual skill possui as regras para o que você está prestes a fazer. Os corpos das skills contêm a orientação real — invoque-os com a ferramenta Skill. Em caso de dúvida, carregue mais skills do que menos.

O servidor da comunidade n8n-mcp e o próprio n8n evoluem mais rápido do que o corte de treinamento de qualquer modelo. Nomes de ferramentas, parâmetros, nós typeVersion e comportamentos padrão mudam entre as versões. Quando você notar uma mudança — uma ferramenta que o nome de uma skill indica não existe, o formato de um parâmetro não corresponde ao que get_node retorna, o comportamento difere do que uma skill descreve — confie na ferramenta ao vivo, informe o usuário e sugira a atualização do pacote e da instância.

Não Negociáveis

Três regras sem exceções. Cada uma delas impede uma classe de fluxo de trabalho que parece correta, mas falha em produção.

1. Invoque a skill relevante antes de qualquer ação n8n — não apenas antes das chamadas MCP. Antes de escrever uma expressão, configurar um nó, projetar um fluxo de trabalho, conectar fios, ou escrever código, invoque a skill correspondente. Os hooks PreToolUse lembram você das chamadas de ferramenta de maior impacto apenas quando o pacote de plugins está instalado; no Claude.ai (uploads de skill simples, sem hooks) a responsabilidade é inteiramente sua.
2. Valide E verifique antes de ativar. Execute validate_workflow (ou n8n_validate_workflow por id) antes de ativar, e chame n8n_get_workflow após cada criação ou atualização para inspecionar o objeto connections. A validação sozinha não detecta fios que foram silenciosamente descartados, índices de Merge com um erro de deslocamento, e saídas de erro que nunca foram conectadas. Validação passando significa que o JSON está bem formado — não que o fluxo de trabalho está correto.
3. Segredos nunca vão em campos de texto. Tokens, chaves de API e senhas sempre passam pelo sistema de credenciais do n8n. Se não houver um nó nativo, use o nó HTTP Request com o tipo de credencial oficial. Um nó Set mantendo um token referenciado via {{ $json.token }} é um vazamento com passos extras. Veja n8n-mcp-tools-expert.

Confie nas skills, não nos dados de treinamento

O n8n muda constantemente. Nomes de parâmetros "lembrados" geralmente estão silenciosamente errados — eles validam como strings simples e depois não fazem nada em tempo de execução. Confie nas skills e nas ferramentas ao vivo (get_node, search_nodes, tools_documentation) em vez da memória. Se uma skill contradiz sua memória, confie na skill. Se get_node contradiz uma skill, confie na ferramenta e sinalize a inconsistência.

Padrões Fortes

Cada skill possui suas próprias exceções; estes são os padrões.

• O nó Code é o último recurso. Expressão primeiro, depois uma função de seta dentro de Campos de Edição, depois um nó Code apenas quando nenhum dos anteriores puder fazer o trabalho. Veja n8n-code-javascript.
• Um nó Set alimentando 0–1 consumidores é quase sempre errado. Em vez disso, incorpore a expressão no consumidor. Veja n8n-expression-syntax.
• Iteração por item é automática. Não adicione um nó Loop Over Items para "fazer loop" quando a execução padrão por item já lida com o caso.
• Configure a partir do esquema ao vivo, nunca da memória. get_node antes de definir parâmetros. Veja n8n-node-configuration.

Sinais de Alerta: "prestes a ___" → invoque ___

Se você se pegar pensando em qualquer um destes, pare e invoque a skill nomeada primeiro.

…