mirror of
https://github.com/R0m1k3/n8n-Agent.git
synced 2026-10-21 22:28:08 +02:00
feat: Initialize the n8n agent project with comprehensive AI skills, documentation, and configuration templates.
This commit is contained in:
commit
994b3f218d
45 files changed
+23677
No files matched your search
+165
@@ -0,0 +1,165 @@
|
||||
# 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)
|
||||
Reference in new issue
Block a user