n8n-Agent/README.md

N8N Agent Consultant Expert

Agent Claude spécialisé en création, optimisation et correction de workflows N8N de haute qualité.

Caractéristiques

• 1,084 nœuds N8N supportés (537 core + 547 community)
• 7 skills spécialisées pour la construction de workflows de production
• 20 outils MCP pour interagir avec N8N
• 2,709 templates de workflows avec métadonnées complètes
• 87% de couverture documentaire officielle
• 5 patterns architecturaux éprouvés sur 2,653+ templates

Capacités de l'Agent

Création de Workflows

• Conception d'architectures scalables et robustes
• Utilisation des patterns éprouvés (Webhook, API, Database, AI, Scheduled)
• Configuration optimale des 525+ nœuds supportés
• Gestion d'erreurs et retry logic professionnels
• Expressions N8N avancées avec variables et fonctions

Correction et Optimisation

• Diagnostic précis des problèmes (erreurs, performance, logique)
• Validation et auto-sanitization des configurations
• Optimisation des performances et de la fiabilité
• Refactoring selon les meilleures pratiques
• Tests et validation complète

Expertise Technique

• Maîtrise des expressions {{}} et variables ($json, $node, $now, $env)
• Code Nodes JavaScript et Python avec patterns testés
• Intégration APIs tierces avec authentification (OAuth, API Key, Basic)
• 8 types de connexions AI (OpenAI, Anthropic, Gemini, etc.)
• Gestion avancée des données et transformations

Installation Rapide

1. Configurez le serveur MCP N8N

   # Copiez le template
   cp .mcp.json.template .mcp.json
   
   # Éditez avec vos credentials
   nano .mcp.json
   

2. Installez les skills N8N

   /plugin install czlonkowski/n8n-skills
   

3. Lancez l'agent

   claude
   

Pour l'installation détaillée, consultez INSTALLATION.md.

Structure du Projet

n8n-Agent/
├── Claude.md                # Configuration de l'agent expert N8N
├── README.md                # Ce fichier
├── INSTALLATION.md          # Guide d'installation complet
├── .mcp.json.template       # Template de configuration MCP
├── .env.template            # Template de variables d'environnement
├── .gitignore               # Protection des secrets
└── workflows/               # Vos workflows N8N (optionnel)

Utilisation

Créer un Nouveau Workflow

"Je veux créer un workflow qui :
1. Reçoit des données via webhook
2. Enrichit les données avec une API externe
3. Stocke dans Airtable
4. Envoie une notification Slack"

Corriger un Workflow Existant

"Mon workflow ID 123 génère une erreur 'Cannot read property of undefined'.
Peux-tu l'analyser et corriger ?"

Optimiser un Workflow

"Ce workflow est lent et consomme beaucoup de ressources.
Peux-tu l'optimiser en utilisant le batch processing ?"

Sécurité

⚠️ IMPORTANT ⚠️

• JAMAIS éditer directement les workflows de production
• TOUJOURS tester dans un environnement de développement
• TOUJOURS exporter des backups avant modifications
• TOUJOURS valider les changements avant déploiement

Skills Disponibles

1. n8n Expression Syntax - Syntaxe et variables
2. n8n MCP Tools Expert - Utilisation optimale des outils
3. n8n Workflow Patterns - 5 patterns architecturaux
4. n8n Validation Expert - Gestion des erreurs de validation
5. n8n Node Configuration - Configuration avancée des nœuds
6. n8n Code JavaScript - Patterns JavaScript testés
7. n8n Code Python - Code Python avec limitations

Outils MCP

Documentation (7 outils)

• Recherche de nœuds et validation
• Documentation des propriétés
• Accès aux templates et configurations

Gestion N8N (13 outils)

• CRUD workflows
• Activation/désactivation
• Gestion des exécutions
• Import/export
• Gestion des credentials

Patterns de Workflows

1. Webhook Processing - Réception et traitement de webhooks
2. HTTP API - Appels API avec retry et error handling
3. Database - CRUD et synchronisation de données
4. AI - Intégrations IA avec prompts dynamiques
5. Scheduled - Tâches planifiées et batch processing

Configuration Requise

• Node.js
• Claude Code CLI ou Claude Desktop
• Instance N8N (cloud ou self-hosted)
• API Key N8N

Ressources

• Documentation N8N : https://docs.n8n.io
• N8N MCP Server : https://github.com/czlonkowski/n8n-mcp
• N8N Skills : https://github.com/czlonkowski/n8n-skills
• Claude Code : https://claude.com/claude-code

Support

Pour toute question :

• INSTALLATION.md pour l'installation
• Claude.md pour la configuration de l'agent
• Issues : Voir les repos GitHub des composants

Licence

Les composants utilisés ont leurs propres licences :

• N8N MCP Server : MIT
• N8N Skills : MIT

---

Créé avec Claude Code