Claude qui construit ton workflow n8n : guide n8n-mcp

J’ai mis 4 ans à apprendre n8n. Je viens de demander à Claude de construire un workflow complet en 3 minutes, depuis un simple prompt en français.

Ce qui s’est passé : Claude a écrit le JSON du workflow, validé chaque expression, vérifié les connexions entre nodes, et déployé direct dans mon n8n. Sans que je touche l’éditeur.

Le truc qui a rendu ça possible : un projet open source sorti il y a quelques semaines, n8n-mcp par Romuald Czlonkowski. Un MCP Server qui donne à Claude une connaissance complète de n8n (525 nodes, 263 outils AI-capables, syntaxe d’expressions, patterns de workflows).

Si tu utilises déjà n8n et Claude, c’est probablement le truc le plus important à connaître ce mois-ci. Voilà pourquoi.

Ce que n8n-mcp change concrètement

Avant n8n-mcp, l’expérience “demande à un LLM de te construire un workflow n8n” était catastrophique. Le LLM inventait des nodes qui n’existent pas, oubliait des champs requis, mélangeait les versions des APIs.

Tu finissais à passer 1h à corriger ce qu’il avait pondu en 30 secondes. Pas un gain de temps · une perte.

n8n-mcp résout ça en donnant à Claude :

Capacité	Effet pratique
Documentation native de chaque node (525 nodes)	Claude n’invente plus, il cite
Liste des 263 nodes AI-capables	Construit des workflows agentic corrects
Validation de la syntaxe d’expressions n8n	Plus de `{{$json.field}}` cassés
Patterns de workflows éprouvés	Architecture cohérente, pas du bricolage
Création + update de workflows via API n8n	Direct dans ton instance, pas de copier-coller

Le saut est net : tu passes de « Claude essaie d’écrire du n8n » à « Claude est un dev n8n senior à ta disposition ».

Installation : 5 minutes

Pré-requis :

Node.js 20+ installé
Claude Desktop (Mac / Windows / Linux)
Une instance n8n (cloud ou self-hosted) avec une API key

Étape 1 — Cloner et build

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build

Le build construit un index local de toute la doc n8n (~2 min, une fois).

Étape 2 — Configurer Claude Desktop

Ouvre ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) ou %APPDATA%\Claude\claude_desktop_config.json (Windows).

Ajoute :

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": [
        "/CHEMIN/ABSOLU/VERS/n8n-mcp/dist/mcp/index.js"
      ],
      "env": {
        "N8N_API_URL": "https://ton-n8n.com/api/v1",
        "N8N_API_KEY": "ton-api-key-n8n"
      }
    }
  }
}

Étape 3 — Redémarrer Claude

Quitte Claude Desktop complètement (cmd-Q sur Mac), relance. Tu vois l’icône MCP en bas à droite avec « n8n connected, X tools available ».

C’est prêt.

3 prompts qui marchent

J’ai testé n8n-mcp sur des dizaines de cas réels. Voici les 3 patterns qui fonctionnent le mieux.

Prompt 1 — Workflow nouveau depuis une description

Construis-moi un workflow n8n qui :
- Se déclenche quand un nouveau client signe sur Stripe
- Crée une page dans ma database Notion "Clients"
- Envoie un email de bienvenue via Resend
- Notifie le canal #nouveaux-clients sur Slack

Utilise les nodes natifs n8n. Active le workflow après création.

Ce que Claude fait :

Cherche les nodes Stripe Trigger / Notion / Resend / Slack via le MCP
Lit la doc de chaque node (champs requis, format des credentials)
Construit le JSON du workflow avec les connexions correctes
Appelle l’API n8n POST /workflows pour le créer
Active le workflow via POST /workflows/:id/activate

Tu reçois un workflow opérationnel. Tu vas dans n8n, tu connectes tes credentials Stripe / Notion / Resend / Slack (ça, Claude ne peut pas le faire à ta place pour des raisons de sécurité), tu testes.

Mon retour réel : 80% de réussite au premier prompt. Les 20% restants nécessitent 1-2 ajustements (typiquement : un mapping de champs spécifique à TON schéma Notion).

Prompt 2 — Modifier un workflow existant

Tu vois mon workflow "lead-scoring" ? Ajoute :
- Une étape qui appelle l'API HubSpot après le scoring
  pour créer le contact si score > 70
- Si score ≤ 70, route vers un sous-workflow "nurturing"
- Loggue chaque exécution dans la table Postgres "lead_events"

Ce que Claude fait :

Récupère le workflow existant via API n8n
Analyse sa structure
Construit les nodes additionnels (HubSpot Create Contact + Switch + Postgres Insert)
Update le workflow via API

C’est là que c’est puissant : modifier un workflow existant à la main, c’est laborieux et risqué (un mauvais clic et les connexions sont cassées). Claude le fait propre, en gardant les noms et l’organisation que tu avais.

Prompt 3 — Audit + refactor

Analyse mes 3 workflows tagués "production". Identifie :
- Les nodes qui n'ont pas de gestion d'erreur
- Les expressions qui pourraient casser sur des inputs vides
- Les hardcodes qui devraient être en variables d'environnement
- Les boucles potentiellement infinies

Donne-moi un rapport, puis corrige les workflows en respectant
mes conventions (nom des nodes, structure visuelle).

Ce que Claude fait :

Récupère les 3 workflows via API
Lit chaque node, chaque expression
Cross-référence avec les patterns de bonnes pratiques (via le MCP)
Génère un rapport structuré
Si tu valides, applique les corrections

Pour un freelance qui a 20 workflows en production accumulés sur 1 an, c’est un audit sénior en 5 minutes qui prendrait 4h à la main.

Les limites à connaître honnêtement

Ce que Claude fait bien

Workflows de complexité moyenne (5-15 nodes)
Patterns standards (CRUD, notifications, sync entre apps, transformations data)
Nodes très utilisés (HTTP, Webhook, Stripe, Notion, Slack, Sheets, OpenAI)
Refactor cohérent

Ce que Claude rate parfois

Workflows très complexes (30+ nodes, beaucoup de branches)
Nodes très spécifiques peu documentés (extensions communautaires)
Logique métier subtile (Claude peut techniquement écrire le workflow mais rater l’intention)
Auth flow OAuth custom (besoin d’humain pour finaliser)

Ce que Claude NE FERA JAMAIS

Saisir tes credentials (Stripe API key, Notion token…) — sécurité Anthropic, à toi de le faire dans l’UI n8n
Tester en conditions réelles — il peut déclencher un test, mais valider que la logique métier est juste = ton job
Déployer sur ton VPS un node communautaire — si le node n’est pas natif, faut l’installer côté serveur

Workflow type : du prompt à la prod

Voilà comment j’utilise n8n-mcp en mission client maintenant :

Étape	Outil	Temps
1. Discovery (besoin client, schéma data)	Conversation	30 min
2. Architecture (sketch des nodes, connexions)	Tableau blanc / Excalidraw	15 min
3. Prompt à Claude + génération workflow	n8n-mcp	3 min
4. Branchement credentials	UI n8n	5 min
5. Test + validation logique	UI n8n	20 min
6. Documentation	Notion + Claude	10 min
TOTAL		~85 min

Avant n8n-mcp, l’étape 3 (construction du workflow) prenait à elle seule 2-3h. Le saut productif est massif.

Je facture pareil. Mes clients sont contents que ça aille plus vite. Je passe le temps gagné à construire plus de workflows pour eux, ou à les optimiser.

Le complément : n8n-skills

Si tu utilises Claude Code (le CLI), il y a un projet sister du même auteur : n8n-skills. 7 skills à charger dans Claude Code qui boostent encore les performances :

n8n-expression-syntax — maîtrise des expressions {{...}}
n8n-mcp-tools-expert — usage avancé du MCP
n8n-workflow-patterns — patterns architecturaux éprouvés
n8n-validation-expert — validation pré-deploy
n8n-node-configuration — config fine de chaque node
n8n-code-javascript — Code node JavaScript
n8n-code-python — Code node Python

Pour les sessions de craft intensives, c’est un game-changer. Pour de l’usage occasionnel via Claude Desktop, le MCP seul suffit.

Sécurité : 3 règles non-négociables

J’ai vu des gens donner à Claude une API key admin sur leur n8n de production. Mauvaise idée. Voilà ce qui marche :

1. API key dédiée avec scopes limités

Crée une key spécifique pour Claude (workflow:read, workflow:write uniquement). Pas de scope credentials, pas de scope users. Si quelque chose dérape, le blast est confiné.

2. Environnement de staging d’abord

Pointe Claude sur un n8n de staging, pas sur prod. Une fois le workflow validé, tu l’exportes et tu l’importes en prod manuellement. Friction acceptable pour une couche de sécurité.

3. Review systématique avant activation

Désactive l’auto-activation des workflows créés par Claude. Tu actives manuellement après validation. Petit délai, gros avantage de contrôle.

L’écosystème en mai 2026

n8n-mcp s’inscrit dans une vague plus large : les LLMs deviennent des constructeurs de workflows, plus juste des consommateurs.

Cas similaires émergents :

Cursor intègre n8n-mcp nativement pour générer du n8n depuis l’IDE
Make travaille sur un MCP équivalent (rumeurs, pas encore sorti)
Zapier a sorti son propre Agent MCP en avril 2026

Le pattern qui se dessine : dans 12-18 mois, construire un workflow ne sera plus un travail de glisser-déposer, ce sera une conversation. Tu décris l’intent, le LLM génère, tu valides. Le drag-and-drop reste pour les ajustements fins.

Si tu apprends n8n maintenant, tu apprends ce langage à un moment charnière : assez tôt pour comprendre les fondamentaux, à temps pour exploiter cette nouvelle vague.

Le mot de la fin

L’outil est gratuit, open source, installé en 5 minutes. La seule barrière, c’est de commencer.

Mon conseil : choisis un workflow simple que tu envisages de construire cette semaine. Lance Claude Desktop avec n8n-mcp connecté. Décris ce que tu veux. Compare le temps total vs la version manuelle.

Tu vas comprendre le bond.

Tu veux maîtriser n8n en profondeur — fondamentaux, agents IA, MCP, Vector Store, projets end-to-end ? La formation n8n complète couvre les 11 modules de zéro aux agents IA en production. Premier Trainer Partner Make en France comme formateur, garantie 30 jours.

Sources : czlonkowski/n8n-mcp, n8n-skills, doc n8n MCP.

Ce que n8n-mcp change concrètement

Installation : 5 minutes

Étape 1 — Cloner et build

Étape 2 — Configurer Claude Desktop

Étape 3 — Redémarrer Claude

3 prompts qui marchent

Prompt 1 — Workflow nouveau depuis une description

Prompt 2 — Modifier un workflow existant

Prompt 3 — Audit + refactor

Les limites à connaître honnêtement

Ce que Claude fait bien

Ce que Claude rate parfois

Ce que Claude NE FERA JAMAIS

Workflow type : du prompt à la prod

Le complément : n8n-skills

Sécurité : 3 règles non-négociables

1. API key dédiée avec scopes limités

2. Environnement de staging d’abord

3. Review systématique avant activation

L’écosystème en mai 2026

Le mot de la fin

Ce guide t'a aidé ? Reçois les prochains.