n8n MCP : créer et lancer vos workflows depuis Claude, ChatGPT ou Cursor (guide 2026)
n8n intègre son propre serveur MCP. Une fois activé, Claude, ChatGPT, Cursor ou Claude Code se connectent directement à votre instance pour chercher vos workflows, les lancer, et même en créer ou en modifier à partir d’une simple description. Ce guide explique comment l’activer, connecter vos outils d’IA et garder la main sur ce qu’ils peuvent faire.
n8n et MCP en bref
- Serveur MCP intégré (« Instance-level MCP ») : une seule connexion pour toute l’instance, sur n8n Cloud comme en auto-hébergement.
- Adresse : affichée dans les réglages, elle se termine par
/mcp-server/http. - Authentification : OAuth (recommandé) ou clé d’API personnelle.
- Création et modification de workflows : depuis n8n 2.13.
- Contrôle d’accès : seuls les workflows que vous activez un par un sont exécutables.
Ce que votre IA peut faire
- Chercher vos workflows : un aperçu de tous ceux que votre compte peut voir.
- Lancer et tester les workflows rendus disponibles dans MCP, puis lire le résultat.
- Créer et modifier des workflows et des tables de données à partir d’une description en langage naturel.
- Gérer des agents n8n, une fonction encore en préversion.
Exemple : « Crée un workflow qui récupère chaque matin les nouvelles lignes de ma Google Sheet et m’envoie un résumé sur Slack. » L’assistant construit le workflow dans n8n, le teste, puis l’ajuste avec vous dans la même conversation.
Activer le serveur MCP
- Ouvrez Settings, puis Instance-level MCP.
- Cliquez sur Enable MCP access. Il faut être propriétaire ou administrateur de l’instance.
- La page affiche alors l’état du serveur, les workflows exposés et les clients connectés.
En auto-hébergement, ces réglages peuvent aussi passer par des variables d’environnement. Pour supprimer complètement la fonction, définissez N8N_DISABLED_MODULES=mcp.
Connecter Claude, ChatGPT ou Cursor
Avec OAuth (recommandé)
Dans Connection details, cliquez sur Connect et choisissez votre client. n8n affiche des instructions adaptées (version 2.33 et suivantes) :
- Clients web (Claude.ai, ChatGPT, Mistral Vibe) : installation en un clic, ou copie de l’adresse du serveur dans les réglages de connecteurs du client.
- Clients en ligne de commande (Claude Code, Codex, Gemini CLI) : une commande d’installation, puis une étape d’authentification.
- Éditeurs (Cursor, VS Code, Windsurf) : lien d’installation ou extrait de configuration à coller.
Dans Claude Code, l’ajout ressemble à ceci, avec l’adresse copiée depuis n8n :
claude mcp add --transport http n8n https://votre-instance/mcp-server/http
Lancez ensuite /mcp pour vous connecter. Au retour sur n8n, approuvez l’accès : chaque client ne reçoit que les permissions accordées à ce moment-là.
Avec une clé d’API
Dans l’onglet API key, n8n génère un jeton personnel et un bloc de configuration JSON prêt à coller, avec un en-tête Authorization: Bearer. Copiez-le immédiatement : il n’est plus affiché en clair ensuite. En cas de perte, générez-en un nouveau, ce qui révoque l’ancien.
Rendre vos workflows disponibles
Par défaut, l’IA voit seulement un aperçu de vos workflows. Pour qu’elle puisse en lancer un ou le modifier, activez-le :
- depuis l’éditeur : menu du workflow, Settings, option Available in MCP ;
- depuis la liste des workflows : menu de la carte, Enable MCP access ;
- pour tout un projet ou un dossier d’un coup (n8n 2.24 et suivantes) : menu Options, Manage MCP access.
Ajoutez une description à chaque workflow exposé : c’est elle qui aide l’IA à choisir le bon.
Les points d’attention
- L’accès n’est pas cloisonné par client : Claude, ChatGPT et Cursor voient tous les mêmes workflows activés.
- Le lancement d’un workflow exécute par défaut sa version publiée. Un mode manuel permet de tester la version en cours.
- Les clients hébergés, comme Claude.ai ou ChatGPT, exigent une instance accessible depuis Internet.
- Derrière un proxy ou un pare-feu applicatif, laissez passer les en-têtes
MCP-Protocol-Version,Mcp-MethodetMcp-Name. - Restreignez les adresses de retour OAuth autorisées et révoquez les clients inutilisés depuis la liste des clients connectés.
Serveur intégré, nœud MCP Server Trigger ou nœud MCP Client ?
- Serveur intégré : une connexion pour toute l’instance, pour construire et lancer vos workflows depuis votre IA.
- Nœud MCP Server Trigger : un workflow devient lui-même un serveur MCP sur mesure, qui n’expose que les outils que vous y concevez.
- Nœud MCP Client : l’inverse, votre workflow appelle des serveurs MCP externes, par exemple ceux de notre annuaire.
Un conseil pour bien démarrer
Pour construire des workflows, n8n recommande les agents de code comme Claude Code plutôt que les clients de chat. L’éditeur publie aussi des « n8n Skills », sur le dépôt n8n-io/skills, qui enseignent à l’agent les bonnes pratiques de n8n : expressions, gestion des erreurs, sous-workflows. Pour ajouter un serveur pas à pas, voyez notre guide ajouter un serveur MCP à Claude, et notre checklist de sécurité MCP avant d’ouvrir l’accès.
Questions fréquentes
n8n a-t-il un serveur MCP officiel ?
Oui, un serveur MCP intégré à l’instance, à activer dans Settings, puis Instance-level MCP.
Faut-il n8n Cloud ?
Non, la fonction existe sur n8n Cloud et en auto-hébergement. Vérifiez simplement que votre version est récente : la création de workflows par MCP arrive avec n8n 2.13.
L’IA peut-elle lancer tous mes workflows ?
Non. Elle ne peut lancer ou modifier que les workflows marqués Available in MCP. Elle voit seulement un aperçu des autres.
OAuth ou clé d’API ?
OAuth est recommandé : chaque client a ses propres permissions et se révoque individuellement. La clé d’API sert aux clients qui ne gèrent pas OAuth.
Sources
- Documentation n8n : Connect to n8n MCP server, consultée le 9 octobre 2026
- Documentation n8n : Use n8n MCP server, consultée le 9 octobre 2026
