Connecter n8n et Claude Code : Guide complet d'intégration MCP 2026
L'automatisation des processus métier a atteint une nouvelle dimension. Avec l'intégration de n8n et Claude Code via le Model Context Protocol (MCP), vous pouvez désormais créer des workflows complets avec une seule instruction.
Le serveur n8n-MCP est un pont open-source qui donne aux assistants IA un accès complet aux 1 084 nodes d'automatisation de workflows n8n. Dans ce guide, nous vous montrons comment configurer et exploiter cette puissante combinaison.
Le problème : La création manuelle de workflows prend du temps
Traditionnellement, créer des workflows n8n nécessite plusieurs étapes :
- Configuration manuelle des nodes dans l'éditeur n8n
- Test et débogage de chaque connexion
- Itération par essais et erreurs
- Documentation des workflows créés
Un workflow typique peut coûter des heures de développement – du temps que vous pourriez consacrer à des tâches plus importantes.
La solution : Automatisation des workflows par IA
Avec l'intégration n8n-MCP, Claude Code devient votre architecte de workflows personnel :
┌─────────────────┐ ┌─────────────┐ ┌──────────────┐
│ Claude Code │────▶│ MCP Server │────▶│ n8n │
│ (Agent IA) │◀────│ (Pont) │◀────│ (Workflows) │
└─────────────────┘ └─────────────┘ └──────────────┘
│ │
└──────── Langage naturel ─────────────────┘
Vous décrivez simplement ce que vous voulez automatiser, et Claude Code crée, valide et déploie le workflow automatiquement.
Qu'est-ce que le Model Context Protocol (MCP) ?
Le Model Context Protocol (MCP) a été introduit par Anthropic fin 2024 et est un standard ouvert qui définit comment les modèles d'IA communiquent avec les systèmes externes.
Depuis janvier 2026, MCP 1.0 est le standard de facto pour l'intégration d'outils IA.
Concepts fondamentaux du MCP
| Concept | Description |
|---|---|
| Host | L'application IA (ex : Claude Code, Claude Desktop) |
| Server | Fournit les outils et ressources (ex : n8n-MCP) |
| Client | Connecte l'hôte au serveur |
| Tools | Fonctions exécutables (ex : créer un workflow) |
| Resources | Sources de données et informations contextuelles |
Pourquoi le MCP est important
- Standardisation : Interface unifiée pour tous les outils IA
- Sécurité : Accès contrôlé aux systèmes externes
- Évolutivité : Les serveurs développés une fois fonctionnent avec tous les hôtes compatibles MCP
- Interopérabilité : Claude, GPT et autres modèles peuvent utiliser les mêmes outils
Qu'est-ce que n8n ?
n8n (prononcé "n-eight-n") est une plateforme open-source d'automatisation de workflows. Elle permet la création visuelle d'automatisations en connectant différents nodes.
Fonctionnalités principales de n8n
- 400+ intégrations pré-construites (Slack, Google, Airtable, etc.)
- Auto-hébergé ou Cloud : Contrôle total sur vos données
- Licence fair-code : Gratuit pour les utilisateurs individuels
- Nodes IA : Intégration native des LLM dans les workflows
n8n comme serveur et client MCP
n8n peut jouer deux rôles :
- Serveur MCP : Expose vos workflows comme outils pour les agents IA
- Client MCP : Appelle des outils MCP externes depuis les workflows
Qu'est-ce que Claude Code ?
Claude Code (Version 2.1, janvier 2026) est l'outil CLI d'Anthropic pour le développement logiciel assisté par IA.
Il est basé sur Claude Opus 4.5 et offre des capacités avancées pour l'automatisation.
Fonctionnalités de Claude Code 2.1
| Fonctionnalité | Description |
|---|---|
| Intégration MCP | Support natif des serveurs MCP |
| Système de Skills | Capacités extensibles via plugins |
| Workflows multi-agents | Orchestration de plusieurs agents IA |
| Context Fork | Exploration parallèle d'approches |
| Coding agentique | Création et refactoring autonome de code |
Pourquoi Claude Code pour n8n ?
Claude Code est particulièrement adapté à l'intégration n8n car :
- Workflows agentiques : Exécution autonome de tâches complexes
- Utilisation d'outils : Interaction directe avec les APIs externes
- Sessions persistantes : Le contexte persiste entre les interactions
- Validation : Vérification automatique des workflows créés
Étape par étape : Connecter Claude Code avec n8n-MCP
Prérequis
Avant de commencer, vous aurez besoin de :
- Node.js 18+ installé
- Claude Code 2.1+ installé (
npm install -g @anthropic-ai/claude-code) - Instance n8n (Cloud ou auto-hébergée)
- Clé API n8n (pour la gestion des workflows)
Le serveur n8n-MCP est disponible sur GitHub : github.com/czlonkowski/n8n-mcp
Option 1 : Configuration de base (Documentation uniquement)
Cette configuration donne à Claude Code accès à la documentation n8n et aux outils de validation.
Linux/macOS/WSL :
claude mcp add n8n-mcp \
-e MCP_MODE=stdio \
-e LOG_LEVEL=error \
-e DISABLE_CONSOLE_OUTPUT=true \
-- npx n8n-mcp
Windows PowerShell :
claude mcp add n8n-mcp `
'-e MCP_MODE=stdio' `
'-e LOG_LEVEL=error' `
'-e DISABLE_CONSOLE_OUTPUT=true' `
-- npx n8n-mcp
Option 2 : Configuration complète (avec gestion des workflows)
Pour la fonctionnalité complète – création, mise à jour et exécution de workflows – ajoutez vos identifiants n8n.
Linux/macOS/WSL :
claude mcp add n8n-mcp \
-e MCP_MODE=stdio \
-e LOG_LEVEL=error \
-e DISABLE_CONSOLE_OUTPUT=true \
-e N8N_API_URL=https://votre-instance-n8n.com \
-e N8N_API_KEY=votre-cle-api \
-- npx n8n-mcp
Pour les instances n8n locales :
-e N8N_API_URL=http://localhost:5678
Option 3 : Configuration Docker
Pour une exécution isolée avec Docker :
{
"mcpServers": {
"n8n-mcp": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MCP_MODE=stdio",
"-e", "LOG_LEVEL=error",
"-e", "DISABLE_CONSOLE_OUTPUT=true",
"-e", "N8N_API_URL=http://host.docker.internal:5678",
"-e", "N8N_API_KEY=VOTRE_CLE_API",
"ghcr.io/czlonkowski/n8n-mcp:latest"
]
}
}
}
Vérifier la configuration
Après l'installation, vérifiez le statut :
# Lister tous les serveurs MCP
claude mcp list
# Détails du serveur n8n-MCP
claude mcp get n8n-mcp
# Dans une session Claude Code : afficher les outils disponibles
/mcp
Outils MCP disponibles
Le serveur n8n-MCP fournit plus de 20 outils répartis en quatre catégories.
Outils principaux (7 outils – Toujours disponibles)
| Outil | Fonction |
|---|---|
get_n8n_documentation | Accès à la documentation n8n |
search_n8n_nodes | Rechercher les nodes disponibles |
get_node_details | Informations détaillées sur les nodes |
validate_workflow_json | Valider la structure JSON |
validate_node_minimal | Vérifier la configuration minimale |
validate_workflow_connections | Vérifier les connexions entre nodes |
validate_workflow_expressions | Valider les expressions n8n |
Gestion des workflows (6 outils – Nécessite une clé API)
| Outil | Fonction |
|---|---|
n8n_list_workflows | Lister tous les workflows |
n8n_get_workflow | Obtenir les détails d'un workflow |
n8n_create_workflow | Créer un nouveau workflow |
n8n_update_workflow | Mettre à jour un workflow existant |
n8n_update_partial_workflow | Mises à jour partielles (diff) |
n8n_delete_workflow | Supprimer un workflow |
Gestion des exécutions (4 outils – Nécessite une clé API)
| Outil | Fonction |
|---|---|
n8n_execute_workflow | Exécuter un workflow |
n8n_get_executions | Obtenir l'historique d'exécution |
n8n_get_execution | Détails d'une exécution |
n8n_delete_execution | Supprimer une exécution |
Outils système (3 outils – Nécessite une clé API)
| Outil | Fonction |
|---|---|
n8n_validate_workflow | Valider un workflow déployé |
n8n_activate_workflow | Activer un workflow |
n8n_deactivate_workflow | Désactiver un workflow |
Cas d'utilisation pratiques
Exemple 1 : Créer un workflow de nurturing de leads
Prompt à Claude Code :
Crée un workflow n8n qui :
1. Reçoit de nouveaux leads depuis un webhook
2. Valide l'adresse email avec Hunter.io
3. Pour les emails valides, génère un message personnalisé avec Claude
4. Envoie le message via Instantly.ai
5. Met à jour le statut du lead dans Airtable
Claude Code va :
- Identifier les nodes nécessaires
- Générer le JSON du workflow
- Valider toutes les connexions
- Créer le workflow dans votre instance n8n
- Optionnellement l'activer
Exemple 2 : Automatiser un pipeline de contenu
Prompt :
Construis un workflow de réutilisation de contenu :
- Déclencheur : Nouvelle vidéo YouTube uploadée
- Extraire la transcription avec Assembly AI
- Générer un article de blog avec Claude
- Créer des extraits social media pour LinkedIn et X
- Planifier les posts avec Buffer
Exemple 3 : Monitoring et alertes
Prompt :
Crée un workflow de monitoring :
- Vérifier le statut de nos APIs toutes les 5 minutes
- En cas d'erreur : Envoyer un message Slack à #ops
- Logger tous les checks dans Google Sheets
- Créer un rapport de disponibilité hebdomadaire
Bonnes pratiques pour n8n + Claude Code
1. Utiliser des prompts structurés
Structurez vos demandes pour obtenir les meilleurs résultats :
TÂCHE : [Ce qui doit être automatisé]
DÉCLENCHEUR : [Ce qui démarre le workflow]
ÉTAPES : [Liste numérotée des actions]
SORTIE : [Résultat attendu]
GESTION DES ERREURS : [Que faire en cas d'erreur]
2. Validation avant déploiement
Claude Code valide automatiquement les workflows, mais vous devriez également :
- Faire vérifier la syntaxe des expressions
- Vérifier les connexions entre nodes
- Effectuer une exécution de test avec des données d'exemple
3. Approche itérative
Commencez par un workflow simple et étendez progressivement :
Première itération : Webhook → Message Slack
Deuxième itération : + Validation des données
Troisième itération : + Gestion des erreurs
Quatrième itération : + Logging et monitoring
4. Utiliser les opérations de diff de workflow
Pour les petites modifications, utilisez n8n_update_partial_workflow au lieu de mises à jour complètes.
Cela économise des tokens et réduit les erreurs.
Dépannage
Problème : Serveur MCP non accessible
# Vérifier le statut
claude mcp list
# Réajouter le serveur
claude mcp remove n8n-mcp
claude mcp add n8n-mcp [options]
Problème : Échec de connexion API
Vérifiez :
- URL API correcte ? Pas de slash final
- Clé API valide ? Dans n8n : Settings → API → Create API Key
- Pare-feu/Réseau ? n8n doit être accessible depuis votre système
Problème : La création de workflow échoue
Causes courantes :
- Identifiants manquants dans n8n
- Configuration de node invalide
- Erreurs de syntaxe dans les expressions
Solution : Utilisez les outils de validation avant le déploiement :
validate_workflow_json → validate_workflow_connections → n8n_create_workflow
L'avenir : MCP comme standard pour l'automatisation IA
La combinaison de n8n et Claude Code via MCP n'est que le début. Nous voyons déjà :
- Systèmes multi-agents : Plusieurs agents IA orchestrant des workflows ensemble
- Workflows auto-réparateurs : L'IA détecte les erreurs et les corrige automatiquement
- Langage naturel comme interface : Workflows créés et modifiés par conversation
n8n n'a pas seulement adopté MCP – il devient un composant central de l'infrastructure d'automatisation IA.
Ressources
- Dépôt GitHub n8n-MCP : github.com/czlonkowski/n8n-mcp
- Documentation officielle n8n : docs.n8n.io
- Documentation Claude Code : docs.anthropic.com/claude-code
- Spécification MCP : modelcontextprotocol.io
Definition of Done ✅
Votre intégration n8n + Claude Code est complète quand :
- Claude Code est installé (Version 2.1+)
- Le serveur n8n-MCP est ajouté et actif (
claude mcp list) - Les identifiants API sont configurés (pour la gestion des workflows)
- Un workflow de test a été créé avec succès
- Le workflow a été validé et activé
Questions fréquemment posées (FAQ)
Quelle est la différence entre n8n comme serveur MCP et client MCP ?
En tant que serveur MCP, n8n expose vos workflows comme outils que les agents IA comme Claude peuvent appeler.
En tant que client MCP, n8n peut lui-même incorporer des outils MCP externes dans les workflows.
Pour l'intégration avec Claude Code, vous avez besoin d'un serveur MCP séparé comme n8n-mcp qui fait le pont entre Claude Code et votre instance n8n.
Ai-je besoin d'une clé API pour les fonctions de base ?
Non. Sans clé API, vous avez accès aux 7 outils principaux : documentation, recherche de nodes et validation.
Cependant, pour réellement créer, mettre à jour et exécuter des workflows, vous avez besoin d'une clé API n8n.
n8n-MCP fonctionne-t-il aussi avec Claude Desktop au lieu de Claude Code ?
Oui. Le serveur n8n-MCP supporte à la fois Claude Code et Claude Desktop.
La configuration se fait via claude_desktop_config.json au lieu de commandes CLI. Les outils et fonctions disponibles sont identiques.
Quelle est la sécurité de la connexion MCP à mon instance n8n ?
La sécurité dépend de votre configuration :
- La clé API ne doit jamais être stockée dans des dépôts publics
- Utilisez des variables d'environnement et limitez l'accès API aux opérations nécessaires
- Pour les instances n8n auto-hébergées, nous recommandons HTTPS et le whitelisting IP
Puis-je modifier des workflows n8n existants avec Claude Code ?
Absolument. Utilisez n8n_get_workflow pour récupérer l'état actuel, décrivez les modifications souhaitées, et Claude Code utilise n8n_update_workflow ou n8n_update_partial_workflow pour la modification.
L'opération de diff est particulièrement efficace pour les petites modifications.
Conclusion
L'intégration de n8n et Claude Code via MCP transforme la façon dont nous créons des automatisations.
Au lieu d'heures de configuration manuelle, vous décrivez simplement vos besoins – et l'IA fait le reste.
Prêt pour la prochaine étape ? Contactez-nous par email pour un conseil personnalisé sur l'automatisation IA pour votre entreprise.
Cet article a été mis à jour pour la dernière fois le 12 janvier 2026 et reflète l'état actuel de Claude Code 2.1, MCP 1.0 et n8n.