n8n-mcp et MCP officiel : faire créer vos workflows n8n par Claude

Un serveur MCP n8n donne à Claude les outils pour créer un workflow dans votre instance n8n à partir d’une consigne en français : il cherche les nodes, écrit le workflow, le valide et le dépose dans votre espace, prêt à relire. Deux serveurs font ce travail : le serveur MCP officiel, intégré à n8n, et n8n-mcp, le projet open source de Romuald Czlonkowski. Il vous faut une instance n8n et Claude Desktop ou Claude Code.

n8n-mcp ou MCP officiel de n8n : lequel choisir

	MCP officiel de n8n	n8n-mcp
Qui le maintient	L’équipe n8n	Romuald Czlonkowski, licence MIT
Installation	Un réglage dans n8n, rien sur votre ordinateur	Node.js et npx n8n-mcp, ou le service hébergé
Connexion à n8n	OAuth, ou jeton d’accès	Clé API n8n
Ce que Claude consulte	Les nodes, leurs types et le SDK de workflows de n8n	2 951 nodes documentés, dont 2 113 communautaires, et 2 352 templates
Accès à vos workflows	Workflow par workflow, avec Available in MCP	Tout ce que la clé API autorise

Commencez par le serveur officiel : il s’active dans les réglages, se connecte en OAuth et limite Claude aux workflows que vous lui ouvrez.

n8n-mcp prend le relais dans deux cas. Vous voulez partir d’un template ou d’un node communautaire, qu’il documente en détail. Ou vous voulez préparer un workflow sans relier d’instance : ses sept outils de documentation et de validation fonctionnent seuls. Ses vingt et un outils de gestion demandent une clé API, et l’API de n8n est fermée pendant l’essai gratuit de n8n Cloud.

Installer le MCP officiel de n8n dans Claude

Activer le serveur MCP dans n8n

1. Dans n8n, ouvrez Settings > Instance-level MCP et cliquez sur Enable MCP access. Il faut un compte propriétaire ou administrateur de l’instance.
2. Dans Connection details, cliquez sur Connect. La fenêtre affiche la Server URL, qui se termine par /mcp-server/http, et deux onglets : OAuth (recommended) et API key.
3. Pour ouvrir un workflow existant à Claude : menu … du workflow, Settings, puis Available in MCP.

Le chemin est le même sur n8n Cloud et sur une instance auto-hébergée.

Connecter Claude Desktop

1. Dans Claude, ouvrez Customize > Connectors et cliquez sur Add custom connector. La documentation de n8n situe encore ce menu dans Settings > Connectors.
2. Nommez le connecteur et collez la Server URL copiée dans n8n, pas l’adresse de votre éditeur.
3. Enregistrez, puis approuvez l’accès quand n8n le demande.
4. Dans une conversation, bouton +, puis Connectors, pour activer n8n.

Le plan gratuit de Claude accepte un connecteur personnalisé. Claude joint ce serveur depuis l’infrastructure d’Anthropic : l’instance doit être accessible depuis Internet, ce qui est le cas de n8n Cloud. Pour une instance qui tourne sur votre ordinateur, passez par Claude Code ou par n8n-mcp.

Connecter Claude Code

claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

Lancez ensuite /mcp dans Claude Code et sélectionnez n8n pour terminer l’autorisation OAuth.

Installer n8n-mcp, le serveur communautaire

Deux prérequis : Node.js sur votre ordinateur et une clé API n8n, créée dans Settings > n8n API, bouton Create an API key.

1. Ouvrez le fichier de configuration de Claude Desktop : ~/Library/Application Support/Claude/claude_desktop_config.json sur Mac, %APPDATA%\Claude\claude_desktop_config.json sur Windows.
2. Ajoutez le serveur, avec l’adresse de votre instance et votre clé :

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

3. Redémarrez Claude Desktop.

La ligne MCP_MODE est obligatoire avec Claude Desktop : sans elle, les journaux du serveur se mêlent au protocole et Claude affiche des erreurs de lecture JSON. Sans N8N_API_URL et N8N_API_KEY, seuls les outils de documentation sont chargés.

Avec Claude Code, une commande suffit :

claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e LOG_LEVEL=error \
  -e DISABLE_CONSOLE_OUTPUT=true \
  -e N8N_API_URL=https://your-n8n-instance.com \
  -e N8N_API_KEY=your-api-key \
  -- npx n8n-mcp

Le projet propose aussi un service hébergé, sur dashboard.n8n-mcp.com, gratuit jusqu’à 100 appels d’outils par jour.

Créer un workflow n8n avec Claude : trois consignes qui marchent

J’ai testé n8n-mcp sur des dizaines de cas réels. Trois formes de consigne donnent les meilleurs résultats, et elles valent pour les deux serveurs.

Un nouveau workflow à partir d’une description

Construisez un workflow n8n qui :
- se déclenche quand un nouveau client paie sur Stripe
- crée une page dans ma base Notion « Clients »
- envoie un e-mail de bienvenue avec Resend
- prévient le canal #nouveaux-clients sur Slack

Utilisez les nodes natifs de n8n. Ne publiez pas le workflow : je le relis d'abord.

Avec le serveur officiel, Claude lit la référence du SDK (get_workflow_sdk_reference), cherche les nodes (search_nodes), écrit le workflow en code, le fait valider (validate_workflow), puis le crée dans votre projet personnel (create_workflow_from_code). n8n-mcp suit la même séquence avec ses propres outils : search_nodes, get_node, validate_workflow et n8n_create_workflow.

Mon retour sur n8n-mcp : 80 % de réussite à la première consigne. Le reste demande un ou deux ajustements, le plus souvent un mapping de champs propre à votre base Notion.

Modifier un workflow existant

Dans mon workflow « lead-scoring », ajoutez :
- après le scoring, un appel à HubSpot qui crée le contact si le score dépasse 70
- sinon, un envoi vers le sous-workflow « nurturing »
- une ligne par exécution dans la table Postgres « lead_events »

Claude récupère le workflow, ajoute les nodes et refait les connexions en gardant vos noms et votre organisation. Avec le serveur officiel, activez d’abord Available in MCP sur le workflow concerné.

Auditer avant de corriger

Analysez mes trois workflows tagués « production ». Relevez :
- les nodes sans gestion d'erreur
- les expressions qui cassent sur une entrée vide
- les valeurs en dur à passer en variables
- les boucles qui peuvent tourner sans fin

Donnez-moi le rapport. N'appliquez aucune correction avant mon accord.

Pour une petite entreprise qui a accumulé vingt workflows en un an, c’est un premier audit rapide avant la relecture humaine.

Ce qu’il faut relire avant de publier

Claude est à l’aise sur les workflows de 5 à 15 nodes, les schémas courants comme une notification ou une synchronisation entre deux applications, et les nodes très utilisés. Au-delà de 30 nodes et de nombreuses branches, demandez le workflow en plusieurs morceaux. Quatre points se relisent à chaque fois.

1. Les credentials. Le serveur officiel ne transmet à Claude que le nom et l’identifiant de vos credentials, jamais leurs secrets. Claude rattache ceux qui existent ; les nouveaux comptes se connectent dans n8n, par vous.
2. Le test avec de vraies données. L’outil test_workflow du serveur officiel simule le trigger, les nodes à credentials et les requêtes HTTP. Une exécution réelle dans l’éditeur reste à faire.
3. La logique métier. Un workflow peut être valide et passer à côté de votre intention : vérifiez les conditions et le mapping des champs.
4. Les erreurs. Contrôlez ce qui se passe quand une application répond mal, avec le retry, la sortie d’erreur et l’Error Trigger.

Un node communautaire doit par ailleurs être installé sur l’instance avant d’être utilisé.

Sur une automatisation interne, mon déroulé tient en six temps : cadrage du besoin et des données, schéma des nodes, consigne à Claude, branchement des credentials, test, documentation.

Les réglages de sécurité à poser dès le départ

J’ai vu des gens donner à Claude une clé API d’administrateur sur leur n8n de production. Trois réglages limitent ce que Claude peut toucher.

Un accès limité

Avec le serveur officiel, Claude ne lit en détail, n’exécute et ne modifie que les workflows marqués Available in MCP, et un client se révoque depuis Connected clients, bouton Revoke access. Avec n8n-mcp, la clé API donne un accès complet à l’instance, sauf sur les instances Enterprise où les scopes la restreignent. Créez une clé dédiée, avec une date d’expiration, et retirez les outils à risque avec la variable DISABLED_TOOLS, par exemple n8n_delete_workflow.

Une copie avant toute modification

Le dépôt de n8n-mcp le dit en tête : ne laissez jamais une IA modifier directement un workflow de production. Dupliquez le workflow ou travaillez sur une instance de test, puis reportez la version validée.

La publication à la main

Depuis n8n 2.0, un workflow créé ou modifié reste un brouillon jusqu’à sa publication. Gardez ce geste pour vous : dans Customize > Connectors, ouvrez le connecteur n8n et passez l’outil publish_workflow sur Blocked.

Skills et workflows exposés : les deux compléments

Le serveur MCP relie Claude à n8n, les skills lui apprennent les bonnes pratiques. Les skills officiels de n8n s’installent dans Claude Code et se combinent avec le serveur officiel. n8n-mcp a son propre pack de quatorze skills, n8n-skills, du même auteur.

Le MCP fonctionne aussi dans l’autre sens : un workflow n8n devient un outil que Claude appelle en langage naturel. Le montage est détaillé dans le tutoriel MCP Server Trigger, et vous pouvez télécharger gratuitement trois workflows n8n prêts à importer qui branchent Claude sur Make, Toggl et Qonto. Côté Make, les agents IA se connectent eux aussi à un serveur MCP.

FAQ

n8n-mcp est-il gratuit ?

Oui. n8n-mcp est open source sous licence MIT, et son service hébergé offre 100 appels d’outils par jour. Le serveur MCP officiel fait partie de n8n et s’active dans les réglages de l’instance.

Le MCP n8n fonctionne-t-il avec une instance auto-hébergée ?

Oui, les deux serveurs fonctionnent avec n8n Cloud et avec une instance auto-hébergée. Pour le connecteur de Claude Desktop, l’instance doit être accessible depuis Internet.

Claude peut-il modifier un workflow n8n existant ?

Oui. Avec le serveur officiel, le workflow doit être marqué Available in MCP. Avec n8n-mcp, Claude modifie tout workflow accessible à la clé API, d’où l’intérêt de travailler sur une copie.

Le MCP n8n fonctionne-t-il avec un autre assistant que Claude ?

Oui. La documentation de n8n donne aussi la marche à suivre pour Cursor, VS Code, Windsurf, Codex CLI, Gemini CLI et Lovable.

Faut-il connaître n8n pour faire construire un workflow par Claude ?

Il faut savoir lire un workflow pour le valider : suivre une donnée d’un node à l’autre et repérer une branche sans gestion d’erreur. Le guide n8n pour débutants pose ce vocabulaire avec un premier workflow à monter.

---

Pour relire et corriger ce que Claude construit, il faut comprendre les bases de n8n : triggers, credentials, transformation des données, conditions, boucles et gestion des erreurs. Ma formation n8n les enseigne en 31 leçons vidéo réparties en 4 chapitres. Elle s’arrête à ces fondations : les agents IA et le MCP sont hors programme. Accès à vie, garantie 14 jours satisfait ou remboursé.

Sources : n8n Docs · serveur MCP de l’instance, czlonkowski/n8n-mcp, n8n-io/skills, documentation de Claude sur les connecteurs personnalisés et sur le MCP dans Claude Code.