n8n MCP : faire construire tes workflows par Claude, le tuto 2026

TL;DR :

• n8n a son propre serveur MCP : Claude peut y chercher les bons nœuds, écrire un workflow, le tester et le corriger directement dans ton instance.
• Il est inclus dans tous les plans, sur n8n Cloud comme sur la Community Edition gratuite en auto-hébergé.
• La méthode conseillée par n8n : un agent de code comme Claude Code, branché sur l'adresse /mcp-server/http de ton instance, avec les n8n Skills officiels en plus.
• 3 autres façons de relier n8n et le MCP existent : le nœud MCP Server Trigger, le registre MCP des agents n8n et le projet communautaire n8n-mcp. Sans MCP, n8n Assistant construit aussi des workflows dans l'éditeur.
• Les limites : Claude fait parfois des choix sans te les signaler, il ne crée pas tes identifiants, et il ne doit jamais toucher directement un workflow en production.

---

Salut 👋

En août 2025, je te présentais ici n8n-mcp, un projet communautaire qui donnait à Claude la documentation des nœuds n8n. Depuis, n8n a sorti son propre serveur MCP, et Claude peut maintenant créer le workflow directement dans ton instance. J'ai donc réécrit cet article de zéro.

Après des années sur Make, je suis passé à n8n pour mes projets complexes, notamment pour orchestrer mes scrapings Apify, et j'ai déjà branché le serveur MCP d'Apify sur Claude Code. Par contre, je n'ai pas encore testé le serveur MCP de n8n moi-même : ce tuto suit la documentation officielle, lue le 16 septembre 2026 (n8n 2.39.6).

Chapitre 1, 1 min

Le MCP de n8n, c'est quoi ?

Le MCP (Model Context Protocol) est un standard qui permet de brancher des outils sur une IA comme Claude (voir mon guide du MCP). Avec n8n, il marche dans les deux sens : Claude peut piloter ton instance, et tes workflows peuvent proposer ou utiliser des outils MCP.

Avec le serveur MCP de n8n, Claude peut :

• chercher, lire et lancer les workflows que tu lui as ouverts, puis lire leurs exécutions ;
• trouver les bons nœuds et leurs paramètres exacts ;
• écrire un workflow, le valider, le tester avec des données simulées et le corriger ;
• lister tes identifiants sans voir les secrets, publier ou archiver un workflow.

Ce qui a changé depuis 2025

Avant, tu demandais un workflow à une IA, tu importais le fichier JSON dans n8n, et il y avait presque toujours un nœud mal configuré : l'IA écrivait les paramètres de tête. Avec le MCP, Claude consulte la vraie liste des nœuds et de leurs paramètres, et n8n lui signale les erreurs avant la création.

• novembre 2025 : accès MCP à l'instance en bêta, pour chercher et lancer des workflows, pas pour les construire ;
• mars 2026 : les outils de construction arrivent, puis sont activés par défaut ;
• 29 avril 2026 : n8n annonce officiellement que son serveur MCP construit des workflows, en préversion publique ;
• juillet 2026 : la mention « preview » disparaît des réglages du MCP, chaque client connecté peut avoir ses propres droits, et n8n Assistant remplace l'AI Workflow Builder sur n8n Cloud.

Pour les curieuxPourquoi Claude écrit du TypeScript au lieu du JSON ?

Le serveur officiel fait écrire le workflow en TypeScript, avec la bibliothèque de code de n8n (son SDK). n8n demande à Claude de passer ce code dans validate_workflow avant de créer le workflow : un code mal écrit est refusé, et un paramètre douteux remonte en avertissement que Claude doit corriger. Toi, tu retrouves un workflow normal sur le canevas. Ce filet n'attrape pas tout : relis toujours le résultat.

Chapitre 2, 1 min

4 façons de relier n8n et le MCP

Derrière « n8n MCP », il y a quatre choses différentes, qui ne vont pas toutes dans le même sens.

Et n8n Assistant ? L'assistant intégré à l'éditeur construit aussi des workflows, mais sans MCP. Je le présente plus bas.

Pour choisir :

• Claude doit construire ou corriger tes workflows : le serveur MCP de l'instance avec Claude Code, le tuto ci-dessous.
• Tu ne veux rien installer en dehors de n8n : n8n Assistant.
• Claude doit pouvoir lancer une seule action, comme ajouter un lead dans ton CRM : le nœud MCP Server Trigger.
• Ton agent n8n doit utiliser un autre outil : le registre MCP ou le nœud MCP Client Tool.
• Tu es sur n8n 1.x, ou tu veux partir de modèles existants : n8n-mcp.

Chapitre 3, 2 min

Tuto : activer le MCP dans n8n

Ces étapes valent pour n8n Cloud comme pour une instance auto-hébergée.

Ce qu'il te faut

• n8n 2.33 ou plus : c'est la version de l'interface décrite ici. La dernière stable, au 16 septembre 2026, est la 2.39.6.
• N'importe quel plan, Community Edition gratuite comprise. Les prix des plans Cloud sont sur ma page n8n.
• Un compte propriétaire ou admin de l'instance.
• Une instance joignable depuis Internet pour claude.ai ou pour le connecteur personnalisé de Claude Desktop. Avec Claude Code sur ta machine, une instance locale en http://localhost:5678 suffit.
• En auto-hébergé derrière un proxy qui ne laisse passer que certains en-têtes : ajoute MCP-Protocol-Version, Mcp-Method et Mcp-Name à sa liste, sinon Claude peut échouer à se connecter.

Étape 1 : active l'accès MCP

Va dans Settings > Instance-level MCP et clique sur Enable MCP access. La page affiche ensuite trois blocs : Connection details, Access et Connected clients.

Étape 2 : choisis les workflows que Claude peut voir

Claude voit un aperçu de tous les workflows auxquels ton compte a accès, mais il ne peut lire en détail, lancer ou modifier que ceux que tu ouvres au MCP :

• dans Settings > Instance-level MCP, section Workflows exposed ;
• dans l'éditeur : menu du workflow, Settings, interrupteur Available in MCP ;
• dans la liste des workflows : menu de la carte, Enable MCP access.

Tu peux aussi ouvrir un projet ou un dossier entier avec Manage MCP access. Un workflow ouvert n'a pas besoin d'être publié pour que Claude le lise, le teste ou le modifie. Pour que Claude puisse le lancer en production, il doit en plus être publié et démarrer par un déclencheur webhook, formulaire, planifié ou chat. Les workflows que Claude crée lui-même sont ouverts automatiquement.

Étape 3 : récupère l'adresse du serveur

Dans Connection details, clique sur Connect et copie la Server URL. Elle se termine par /mcp-server/http : ce n'est pas l'adresse de ton éditeur. Sur n8n Cloud, elle ressemble à https://ton-instance.app.n8n.cloud/mcp-server/http.

• OAuth, recommandé : tu te connectes avec ton compte n8n dans une page qui s'ouvre, sans jeton à copier.
• Clé API : l'onglet API key génère un jeton personnel lié à ton compte. Copie-le tout de suite, il est masqué dès que tu quittes l'onglet. En générer un nouveau révoque l'ancien.

Cette fenêtre donne aussi les étapes pour chaque client : Claude Code, Claude.ai, ChatGPT, Cursor, VS Code...

Chapitre 4, 2 min

Tuto : connecter Claude à n8n

Avec Claude Code

Pour construire des workflows, n8n recommande un agent de code plutôt qu'un chat : son blog note de meilleurs résultats avec Claude Code qu'avec Claude en chat, pour la même demande.

Si tu comptes installer les n8n Skills officiels (juste en dessous), commence par eux et saute cette commande : le plugin crée sa propre connexion à ton instance. Sinon, dans ton terminal :

claude mcp add --transport http n8n https://ton-domaine-n8n/mcp-server/http

Par défaut, la connexion ne vaut que pour le dossier où tu lances la commande. Ajoute --scope user pour l'avoir dans tous tes projets.

Lance ensuite Claude Code, tape /mcp, choisis n8n et authentifie-toi dans la page n8n qui s'ouvre. Si tu passes par une clé API, ajoute l'en-tête à la commande :

claude mcp add --transport http n8n https://ton-domaine-n8n/mcp-server/http --header "Authorization: Bearer TON_JETON_N8N"

Ajoute les n8n Skills officiels

Le plugin officiel n8n-io/skills ajoute 13 Skills qui apprennent à Claude les bonnes pratiques de n8n : expressions, boucles, sous-workflows, gestion d'erreurs, débogage... Si tu découvres les Skills, lis mon guide des Skills Claude. Dans Claude Code :

/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io
/reload-plugins
/mcp

Le plugin te demande l'adresse de ton instance et crée sa propre connexion MCP, nommée n8n-mcp : dans /mcp, choisis-la puis Authenticate. Si tu as déjà lancé la commande claude mcp add du dessus, Claude voit maintenant tous les outils en double : désactive la connexion n8n dans /mcp, ou supprime-la avec claude mcp remove n8n. Malgré son nom, la connexion n8n-mcp n'a rien à voir avec le projet communautaire n8n-mcp.

Avec claude.ai ou Claude Desktop

Ajoute un connecteur personnalisé depuis le menu Connectors de Claude (Add custom connector), colle la Server URL et valide l'accès dans la page n8n qui s'ouvre. Sur un plan Team ou Enterprise, c'est le propriétaire de l'organisation qui ajoute le connecteur. La connexion part des serveurs d'Anthropic : une instance en localhost ne marchera pas avec ce connecteur. Le plan gratuit de Claude n'accepte qu'un seul connecteur personnalisé. n8n publie aussi un connecteur officiel dans l'annuaire des connecteurs de Claude.

Choisis les droits de Claude

Quand tu valides une connexion OAuth, n8n te laisse choisir les droits du client : tout, lecture seule ou à la carte (créer et modifier des workflows, les lancer, lire les exécutions...). Tu peux commencer en lecture seule, puis reconnecter le client avec les droits de création. Tu révoques un client à tout moment dans Connected clients. Une connexion par clé API se coupe en générant un nouveau jeton.

Chapitre 5, 2 min

Tuto : ton premier workflow avec Claude

Choisis un workflow que tu sais déjà construire à la main : tu repéreras tout de suite ce que Claude rate. Mon exemple : lancer un scraping Apify chaque lundi et ranger les résultats dans Google Sheets. Le plan gratuit d'Apify suffit pour tester.

La demande à copier

Le blog de n8n conseille de nommer les nœuds et les services voulus, plutôt que de décrire seulement le résultat :

Construis un nouveau workflow n8n, sans le publier.
1. Schedule Trigger : chaque lundi à 8 h.
2. HTTP Request en POST sur l'endpoint "Run Actor" de mon Actor Apify
   (ID : TON_ACTOR_ID). N'écris aucune clé dans l'URL ni dans le nœud,
   j'ajouterai l'identifiant moi-même.
3. Wait : 60 secondes.
4. HTTP Request en GET sur "Get last run dataset items" du même Actor.
5. Filter : garde seulement les lignes qui ont un site web.
6. Google Sheets : ajoute chaque ligne dans l'onglet "Leads" de mon fichier.
Utilise exactement ces nœuds. Valide le code, teste le workflow avec des
données simulées, corrige les erreurs, puis donne-moi la liste des
identifiants à configurer. Ne modifie aucun autre workflow.

Adapte l'attente à la durée habituelle de ton Actor : si le run n'est pas fini, le GET renvoie un dataset incomplet. Pour un Actor qui tourne moins de 5 minutes, l'appel run-sync-get-dataset-items d'Apify lance le run et renvoie les résultats en une seule requête. Tu peux aussi remplacer Apify par ta propre source.

Ce que Claude fait ensuite

Tu vois passer à peu près ces appels :

1. get_workflow_sdk_reference, search_nodes et get_node_types : il lit la référence du SDK et trouve les paramètres exacts des nœuds.
2. validate_workflow : il vérifie son code et corrige les erreurs et les avertissements signalés.
3. create_workflow_from_code : il crée le workflow dans ton instance. n8n y branche les identifiants existants, sauf sur les nœuds HTTP Request.
4. test_workflow : il teste avec des données simulées (les « pin data » de n8n). Le déclencheur, les nœuds avec identifiant et les HTTP Request sont simulés, les nœuds de logique comme Filter tournent réellement (5 minutes maximum par défaut).
5. update_workflow : il corrige ce qui casse, sans tout réécrire.

D'après n8n, un workflow complexe demande souvent deux ou trois passes. Corrige dans la même conversation plutôt que de repartir de zéro.

Ce qui reste pour toi

Avec le serveur officiel, Claude ne crée pas tes identifiants : il peut seulement lister ceux qui existent. Avant de publier :

• crée dans n8n un identifiant Header Auth pour Apify (en-tête Authorization, valeur Bearer suivie de ta clé API Apify) et branche-le sur les deux nœuds HTTP Request ;
• vérifie la connexion Google du nœud Google Sheets ;
• relis chaque nœud sur le canevas (les bases sont dans mes 3 concepts pour structurer un workflow n8n), puis lance un vrai test sur un petit volume ;
• publie toi-même, ou demande à Claude de le faire (publish_workflow) une fois que tout est bon.

Chapitre 6, 1 min

Le MCP dans tes workflows n8n

Le nœud MCP Server Trigger : un workflow devient un outil

Ce nœud transforme un workflow en petit serveur MCP. Tu y branches des nœuds outils, par exemple Call n8n Workflow Tool pour exposer un sous-workflow, et le client IA ne voit que ces outils, pas le reste de ton instance.

• Deux adresses : une de test (/mcp-test/...), active quand tu cliques sur Listen for test event, et une de production (/mcp/...), active une fois le workflow publié.
• Une protection à choisir : jeton Bearer, en-tête personnalisé, ou compte n8n (OAuth) sur les versions récentes du nœud. Ne laisse pas None sur une adresse publique.
• Derrière nginx, la doc du nœud demande de couper le buffering (proxy_buffering off) sur ce chemin. Elle conseille aussi gzip off, chunked_transfer_encoding off et un en-tête Connection vide.

Le registre MCP : ton agent utilise d'autres outils

Dans l'autre sens, un agent IA construit dans n8n peut utiliser des serveurs MCP externes. Sur le nœud AI Agent, clique sur Tool +, ouvre la section MCP Servers, choisis le service et connecte-toi. La liste de départ comptait notamment Apify, Linear, Notion et PostHog, et elle change souvent.

Pour un serveur absent du registre, le nœud MCP Client Tool se règle à la main : adresse, transport (HTTP Streamable par défaut), authentification et outils à garder. Le nœud MCP Client, lui, appelle un outil MCP comme une étape normale, sans agent. Pour débuter, lis mon guide des agents IA de n8n.

Chapitre 7, 1 min

Les alternatives : n8n Assistant et n8n-mcp

n8n Assistant, l'assistant intégré

n8n Assistant (AI Assistant dans les réglages) construit le workflow dans l'éditeur : tu décris ton besoin, il le pose sur le canevas, l'exécute et corrige ses erreurs, sans jamais voir tes secrets. Il est encore en préversion.

• Sur n8n Cloud : plans Starter et Pro, avec des crédits IA inclus dans l'abonnement.
• En auto-hébergé : éditions Community, Registered Community et Business, sur une version récente (n8n conseille la dernière stable), installé avec Docker, avec ta propre clé de modèle (Anthropic, OpenAI, OpenRouter ou compatible) et un environnement isolé pour exécuter le code (une sandbox).
• Pas encore sur le plan Enterprise.

Ne le confonds pas avec Ask n8n AI, l'ancien assistant d'aide de n8n Cloud, qui ne construit pas de workflow. Claude Code est plus intéressant si tu y travailles déjà, car tu peux y brancher d'autres serveurs MCP à côté de n8n, comme celui d'Apify chez moi.

Le projet communautaire n8n-mcp

Le projet dont je parlais en 2025 est toujours actif : licence MIT, version 2.85.0 du 14 septembre 2026, 2 755 nœuds documentés (dont 1 923 communautaires) et 2 352 modèles de workflows. Avec l'adresse et une clé API de ton instance, il crée, modifie, teste et versionne tes workflows. Il reste utile si tu es sur n8n 1.x, si tu veux partir de ses modèles ou si tu cherches des nœuds communautaires que tu n'as pas encore installés. L'installation dans Claude Code, avec Node.js 20 ou plus :

claude mcp add n8n-mcp -e MCP_MODE=stdio -e LOG_LEVEL=error -e DISABLE_CONSOLE_OUTPUT=true -e N8N_API_URL=https://ton-domaine-n8n -e N8N_API_KEY=ta-cle-api -- npx n8n-mcp

Cette commande est pour bash (macOS, Linux, Git Bash). Sous PowerShell, le dépôt du projet donne une variante où chaque -e est entre apostrophes. Si ton n8n tourne en localhost (N8N_API_URL=http://localhost:5678), ajoute -e WEBHOOK_SECURITY_MODE=moderate.

La clé API se crée dans Settings > n8n API. Elle n'est pas disponible pendant l'essai gratuit de n8n Cloud et, hors plan Enterprise, elle donne accès à tout ton compte. La télémétrie du projet est active par défaut : npx n8n-mcp telemetry disable la coupe. Le reste est sur son dépôt GitHub.

Chapitre 8, 1 min

Limites, sécurité et coût

Les erreurs qui restent

Le blog de n8n liste lui-même les problèmes connus :

• au premier jet, Claude fait des choix de conception sans te les signaler ;
• il complique parfois le workflow plus que nécessaire, jusqu'à ce que tu le recadres ;
• les workflows avec beaucoup de conditions ou de branches imbriquées sont souvent à reprendre à la main ;
• Claude prend parfois le mauvais nœud quand plusieurs conviennent ;
• il découvre certaines contraintes de n8n en cours de route.

Nomme les nœuds voulus, puis demande à Claude ce qui l'aurait aidé à mieux faire du premier coup : tu l'ajouteras à ta prochaine demande.

La sécurité

• Tous les clients connectés voient les mêmes workflows : impossible d'en réserver un à Claude Code. N'ouvre au MCP que ce dont tu as besoin.
• Aucune clé dans le chat : tes identifiants se créent dans n8n. Une clé API de connexion se garde comme un mot de passe.
• Limite les adresses de retour OAuth : toutes sont acceptées par défaut. Dans Access, passe Allowed callback URLs sur Only trusted URLs, ajoute l'adresse de retour de chaque client que tu utilises (Add URL), puis clique sur Save. Un client absent de la liste ne pourra plus se connecter.
• Méfie-toi des données lues : quand Claude lit une exécution, un texte scrapé peut contenir des instructions piégées.
• En auto-hébergé, N8N_MCP_BUILDER_ENABLED=false retire les outils de construction et N8N_DISABLED_MODULES=mcp coupe complètement le MCP.

Le coût

Le serveur MCP est inclus dans ton plan n8n. Le modèle, lui, tourne côté Claude : c'est ton abonnement Claude qui paie le travail, et chaque passe de correction entame ton quota.

Chapitre 9, 1 min

Questions fréquentes

Comment connecter Claude à n8n avec le MCP ?

Active l'accès dans Settings > Instance-level MCP de ton instance n8n, puis copie la Server URL, qui se termine par /mcp-server/http. Dans Claude Code, lance claude mcp add --transport http n8n suivi de cette adresse, puis authentifie-toi avec /mcp. Dans claude.ai ou Claude Desktop, ajoute-la comme connecteur personnalisé.

Le serveur MCP de n8n est-il gratuit ?

Il n'est pas facturé à part : il est inclus dans tous les plans de n8n, y compris la Community Edition gratuite en auto-hébergé. Le travail du modèle, lui, est payé côté client IA, par exemple par ton abonnement Claude.

Claude peut-il créer un workflow n8n tout seul ?

Oui, avec le serveur MCP officiel : il cherche les nœuds, écrit le workflow, le valide, le crée dans ton instance, le teste avec des données simulées et le corrige. Il ne crée pas tes identifiants, et un workflow complexe demande souvent deux ou trois passes. Relis toujours avant de publier.

Le MCP de n8n marche-t-il avec ChatGPT ou Cursor ?

Oui. La fenêtre Connect de ton instance donne les étapes pour Claude Code, claude.ai, ChatGPT, Cursor, VS Code et d'autres clients. Le principe reste le même : la Server URL de ton instance, puis une connexion OAuth ou une clé API.

Quelle différence entre le MCP de n8n et le projet n8n-mcp ?

Le serveur MCP de n8n est intégré à ton instance et s'active dans les réglages. n8n-mcp est un projet communautaire open source que tu installes à côté : il passe par l'API publique de n8n avec une clé API, apporte des modèles de workflows et fonctionne aussi sur n8n 1.x.

Le MCP de n8n marche-t-il en auto-hébergé ?

Oui, sur la Community Edition comme sur les éditions payantes, avec n8n 2.33 ou plus pour suivre ce tuto. Pour claude.ai ou le connecteur personnalisé de Claude Desktop, ton instance doit être joignable depuis Internet. Avec Claude Code sur ta machine, une instance en localhost fonctionne.

Claude Code peut-il remplacer n8n ?

Non. Claude Code construit et corrige tes workflows, mais c'est n8n qui les fait tourner en continu, avec ses déclencheurs, ses webhooks, l'historique des exécutions et les identifiants stockés.

Chapitre 10, 1 min

Pour finir

La première version de cet article se demandait si c'était la fin de la construction manuelle des workflows n8n. Pas encore. Sur le papier, le gros problème de 2025 est réglé : Claude lit les vrais nœuds, et n8n lui signale ses erreurs avant de créer le workflow. Mais n8n parle lui-même de deux ou trois passes sur un workflow complexe, et les identifiants, la relecture et la décision de publier restent pour toi.

Mon conseil : mets ton instance à jour, active le MCP, branche Claude Code et fais construire un workflow simple que tu connais déjà, sans le publier. Si tu n'as pas encore d'instance, n8n Cloud est le chemin le plus court, et mon guide de découverte de n8n couvre les bases.

À très vite,

Guillaume 👋

Certains liens de cet article sont des liens affiliés : si tu t'abonnes via ces liens, je touche une commission, sans surcoût pour toi. Je ne recommande que des outils que j'utilise ou que j'ai testés.