# n8n-mcp

n8n-mcp est un serveur Model Context Protocol (MCP) qui donne aux assistants IA comme Claude Desktop, Cursor et Windsurf un accès complet aux plus de 1 084 nœuds de n8n, à la documentation, aux templates et aux outils de gestion, leur permettant de construire, valider et déployer de manière autonome des workflows prêts pour la production.

Canonical URL: https://a2a-mcp.org/entry/n8n-mcp-fr

Language: fr

Category: MCP Servers

Updated: 2026-03-18

## Aperçu

n8n-mcp est un serveur open-source Model Context Protocol (MCP) qui relie les assistants de codage IA à la plateforme d’automatisation de workflows n8n. Il fournit à des outils comme Claude Desktop, Claude Code, Cursor, Windsurf et VS Code une connaissance structurée et en temps réel de l’ensemble de l’écosystème n8n — incluant 537 nœuds principaux + 547 nœuds communautaires (1 084 au total), 2 709 templates de workflows et une logique de validation spécifique à l’IA.

Développé comme une application Node.js légère avec une base de données SQLite intégrée, il offre des réponses en moins de 12 ms et fonctionne en mode stdio ou HTTP. Connectez-le une seule fois et laissez votre IA construire, valider, tester et déployer des workflows n8n complets sans copier-coller ni configuration manuelle.

Une version hébergée avec un Chat Agent prêt à l’emploi est disponible sur [n8n-mcp.com](https://www.n8n-mcp.com) (offre gratuite + plans payants), tandis que le dépôt GitHub reste entièrement auto-hébergeable sous licence MIT.

## Fonctionnalités principales

- **Base de connaissance complète des nœuds** — Accès total aux 1 084 nœuds n8n avec 99 % de couverture des propriétés, 63,6 % de couverture des opérations et 87 % de la documentation officielle (mise à jour en moins de 48 h après chaque nouvelle version de n8n).
- **Recherche intelligente et découverte** — `search_nodes`, `get_node` (plusieurs niveaux de détail) et filtrage des nœuds communautaires par source (vérifiés/communauté).
- **Exemples réels** — 2 646 configurations extraites au préalable à partir de templates populaires.
- **Validation avancée** — `validate_node` et `validate_workflow` avec profils d’agents IA, vérifications à l’exécution et analyse des dépendances. Compatible avec les workflows AI Agent de n8n v2.17+.
- **Moteur de templates** — Recherche et récupération de plus de 2 709 JSON de workflows prêts à l’emploi avec filtrage intelligent.
- **Outils de gestion n8n** (connexion API optionnelle) — Créer, mettre à jour, tester, exécuter et corriger automatiquement des workflows directement dans votre instance n8n.
- **Performances et compatibilité** — ~12 ms de temps de réponse moyen, empreinte mémoire de 70–120 Mo, compatible avec toutes les versions de Node.js. Supporte les modes stdio (Claude Desktop) et HTTP/SSE.
- **Confidentialité et sécurité** — Télémesure anonyme optionnelle (facilement désactivable), aucune clé codée en dur, modes de sécurité pour les webhooks.

## Installation et configuration

### Démarrage rapide (npx – sans installation)
```bash
npx n8n-mcp
```
Ajoutez-le à votre fichier `claude_desktop_config.json` de Claude Desktop avec `MCP_MODE=stdio`.

### Docker (recommandé en production)
```bash
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest
```

### Cloud (en un clic)
Déployez gratuitement sur Railway via le template du dépôt.

### Build local complet
```bash
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start
```

Variables d’environnement optionnelles : `N8N_API_URL`, `N8N_API_KEY` (pour la gestion directe des workflows), `LOG_LEVEL=error`, `MCP_MODE=stdio`.

## Assistants IA compatibles

- Claude Desktop / Claude Code
- Cursor
- Windsurf
- VS Code + Codex
- Antigravity
- Tout client compatible MCP (plus de 20 outils via le service hébergé)

## Cas d’usage

- **Création de workflows pilotée par IA** — Décrivez « surveiller les mentions Twitter et publier des résumés sur Slack avec analyse de sentiment » → l’IA génère, valide et déploie le JSON complet.
- **Maintenance de workflows existants** — L’IA lit les workflows en direct, propose des optimisations et applique des mises à jour ciblées.
- **Exploration de templates** — Demandez « le meilleur template de synchronisation CRM utilisant des nœuds communautaires » et recevez un JSON prêt à importer.
- **Automatisation en entreprise** — Connectez-vous à des instances n8n auto-hébergées pour générer des workflows sécurisés et auditables à grande échelle.
- **Apprentissage et prototypage** — Utilisez les outils de validation pour enseigner à l’IA les meilleures pratiques avant un déploiement en production.

## MCP natif de n8n vs n8n-mcp

Le serveur MCP natif de n8n (disponible dans les versions récentes) expose vos propres workflows comme outils. n8n-mcp est un serveur MCP **externe** complémentaire centré sur la **connaissance des nœuds n8n** et la création assistée par IA. Utilisez-les ensemble pour une puissance maximale : serveur natif pour déclencher des workflows + n8n-mcp pour une construction intelligente des workflows.

## Liens et ressources

- GitHub : [czlonkowski/n8n-mcp](https://github.com/czlonkowski/n8n-mcp)
- Chat Agent hébergé & Dashboard : [n8n-mcp.com](https://www.n8n-mcp.com)
- Offre gratuite : 100 appels d’outils/jour (hébergé) ou illimité en auto-hébergement
- Documentation et exemples dans le dépôt

n8n-mcp transforme n’importe quel assistant de codage IA en expert complet des workflows n8n — instantanément.

## Tags

- mcp-server
- n8n
- ai-assistant
- workflow-automation
- claude-desktop
- cursor
- typescript
- node-js
- mcp
- automation

## Sources

- [Project website](https://github.com/czlonkowski/n8n-mcp)