# 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)