n8n-Agent/QUICK_START.md

Démarrage Rapide - N8N Agent Consultant

Guide ultra-rapide pour être opérationnel en 5 minutes.

Étape 1 : Configuration MCP (2 min)

# Copiez le template
cp .mcp.json.template .mcp.json

Éditez .mcp.json et remplacez :

• REMPLACEZ_PAR_VOTRE_URL_N8N → URL de votre instance N8N
• REMPLACEZ_PAR_VOTRE_API_KEY → Votre API Key N8N

Obtenir votre API Key :

1. Ouvrez votre instance N8N
2. Settings → API → Create API Key
3. Copiez la clé

Étape 2 : Installation Skills (1 min)

# Lancez Claude Code
claude

# Dans la session, tapez :
/plugin install czlonkowski/n8n-skills

Étape 3 : Test de l'Installation (1 min)

Dans Claude Code, testez :

Liste les outils MCP N8N disponibles

Vous devriez voir 20 outils listés.

Étape 4 : Premier Workflow (1 min)

Essayez cette commande :

Crée un workflow simple qui :
1. Se déclenche toutes les heures
2. Récupère la météo via une API
3. Envoie le résultat par email

L'agent va vous guider dans la création !

Commandes Utiles

Créer un Workflow

Crée un workflow qui [description de ce que tu veux]

Analyser un Workflow

Analyse le workflow ID [numéro] et explique ce qu'il fait

Corriger une Erreur

Mon workflow [ID ou description] a cette erreur : [message d'erreur]
Peux-tu le corriger ?

Optimiser un Workflow

Optimise mon workflow [ID] pour améliorer les performances

Comprendre un Nœud

Comment configurer le nœud [nom du nœud] ?
Montre-moi un exemple

Patterns Rapides

Webhook → Traitement → Notification

Crée un workflow webhook qui reçoit des données JSON,
les valide, puis envoie une notification Slack

API Schedule → Database

Crée un workflow qui récupère des données d'une API toutes les heures
et les stocke dans Airtable

Form → AI → Response

Crée un workflow qui reçoit un formulaire,
utilise OpenAI pour analyser le contenu,
et retourne une réponse formatée

Résolution Rapide de Problèmes

MCP Server non trouvé

# Vérifiez Node.js
node --version

# Testez npx
npx n8n-mcp --version

API Key invalide

1. Régénérez dans N8N Settings → API
2. Mettez à jour .mcp.json
3. Relancez Claude Code

Skills non activées

# Réinstallez
/plugin install czlonkowski/n8n-skills

# Ou manuellement
git clone https://github.com/czlonkowski/n8n-skills.git
cp -r n8n-skills/* ~/.claude/skills/

Aide Supplémentaire

• Installation complète : INSTALLATION.md
• Documentation agent : Claude.md
• Présentation projet : README.md

Commandes Essentielles

Commande	Description
Liste les nœuds disponibles pour [type]	Recherche de nœuds
Explique le pattern [nom]	Documentation des patterns
Valide cette configuration [JSON]	Validation de config
Crée un backup du workflow [ID]	Export de workflow
Montre les templates pour [cas d'usage]	Recherche de templates

Conseils Pro

1. Toujours tester en dev avant production
2. Utiliser les patterns éprouvés (5 disponibles)
3. Activer error handling sur tous les nœuds critiques
4. Documenter les workflows complexes avec Sticky Notes
5. Versionner vos workflows (export régulier)

Sécurité Rapide

• Ne commitez JAMAIS .mcp.json ou .env
• Utilisez des credentials N8N, pas de hard-code
• Testez TOUJOURS avant production
• Exportez des backups avant modifications

---

Prêt à créer des workflows N8N professionnels ! 🚀

Pour aller plus loin : INSTALLATION.md