mirror of
https://github.com/R0m1k3/n8n-Agent.git
synced 2026-10-18 12:48:30 +02:00
166 lines
3.6 KiB
Markdown
166 lines
3.6 KiB
Markdown
# Démarrage Rapide - N8N Agent Consultant
|
|
|
|
Guide ultra-rapide pour être opérationnel en 5 minutes.
|
|
|
|
## Étape 1 : Configuration MCP (2 min)
|
|
|
|
```bash
|
|
# 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)
|
|
|
|
```bash
|
|
# 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é
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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](INSTALLATION.md)
|
|
- **Documentation agent** : [Claude.md](Claude.md)
|
|
- **Présentation projet** : [README.md](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](INSTALLATION.md)
|