mirror of
https://github.com/R0m1k3/n8n-Agent.git
synced 2026-10-20 21:58:32 +02:00
feat: Initialize the n8n agent project with comprehensive AI skills, documentation, and configuration templates.
This commit is contained in:
Michael committed
commit
994b3f218d
45 files changed
+23677
No files matched your search
+258
@@ -0,0 +1,258 @@
|
||||
# Installation N8N Agent Consultant Expert
|
||||
|
||||
Ce guide vous aide à configurer votre agent consultant N8N avec le serveur MCP et les 7 skills spécialisées.
|
||||
|
||||
## Prérequis
|
||||
|
||||
- Node.js installé
|
||||
- Claude Code CLI ou Claude Desktop
|
||||
- Une instance N8N (cloud ou self-hosted)
|
||||
- Git
|
||||
|
||||
## Étape 1 : Configuration du Serveur MCP N8N
|
||||
|
||||
### Option A : Via NPX (Recommandé - le plus rapide)
|
||||
|
||||
Ajoutez cette configuration à votre fichier de configuration Claude :
|
||||
|
||||
**Pour Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json` sur Mac ou `%APPDATA%\Claude\claude_desktop_config.json` sur Windows) :
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"n8n-mcp": {
|
||||
"command": "npx",
|
||||
"args": ["n8n-mcp"],
|
||||
"env": {
|
||||
"MCP_MODE": "stdio",
|
||||
"N8N_API_URL": "https://votre-instance.n8n.io",
|
||||
"N8N_API_KEY": "votre_api_key_ici",
|
||||
"LOG_LEVEL": "error",
|
||||
"DISABLE_CONSOLE_OUTPUT": "true"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Pour Claude Code** (`.mcp.json` dans votre projet) :
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"n8n-mcp": {
|
||||
"command": "npx",
|
||||
"args": ["n8n-mcp"],
|
||||
"env": {
|
||||
"MCP_MODE": "stdio",
|
||||
"N8N_API_URL": "https://votre-instance.n8n.io",
|
||||
"N8N_API_KEY": "votre_api_key_ici",
|
||||
"LOG_LEVEL": "error",
|
||||
"DISABLE_CONSOLE_OUTPUT": "true"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Option B : Via Docker
|
||||
|
||||
```bash
|
||||
docker run -e MCP_MODE=stdio \
|
||||
-e N8N_API_URL=https://votre-instance.n8n.io \
|
||||
-e N8N_API_KEY=votre_api_key \
|
||||
-e LOG_LEVEL=error \
|
||||
-e DISABLE_CONSOLE_OUTPUT=true \
|
||||
ghcr.io/czlonkowski/n8n-mcp:latest
|
||||
```
|
||||
|
||||
### Option C : Installation Locale (Développement)
|
||||
|
||||
```bash
|
||||
git clone https://github.com/czlonkowski/n8n-mcp.git
|
||||
cd n8n-mcp
|
||||
npm install
|
||||
npm run build
|
||||
```
|
||||
|
||||
Puis référencez le chemin compilé dans votre config.
|
||||
|
||||
## Étape 2 : Obtenir votre API Key N8N
|
||||
|
||||
### N8N Cloud
|
||||
1. Connectez-vous à votre instance N8N
|
||||
2. Allez dans **Settings** → **API**
|
||||
3. Cliquez sur **Create API Key**
|
||||
4. Copiez la clé générée
|
||||
|
||||
### N8N Self-Hosted
|
||||
1. Allez dans **Settings** → **API**
|
||||
2. Activez l'accès API si nécessaire
|
||||
3. Créez une nouvelle API Key
|
||||
4. Copiez la clé
|
||||
|
||||
## Étape 3 : Installation des Skills N8N
|
||||
|
||||
### Via Claude Code (Recommandé)
|
||||
|
||||
```bash
|
||||
# Lancer Claude Code
|
||||
claude
|
||||
|
||||
# Installer le plugin de skills
|
||||
/plugin install czlonkowski/n8n-skills
|
||||
```
|
||||
|
||||
### Installation Manuelle
|
||||
|
||||
```bash
|
||||
# Cloner le repository des skills
|
||||
git clone https://github.com/czlonkowski/n8n-skills.git
|
||||
|
||||
# Copier les skills dans le dossier Claude
|
||||
# Sur Mac/Linux
|
||||
cp -r n8n-skills/* ~/.claude/skills/
|
||||
|
||||
# Sur Windows PowerShell
|
||||
Copy-Item -Recurse n8n-skills\* $env:USERPROFILE\.claude\skills\
|
||||
```
|
||||
|
||||
### Pour Claude.ai
|
||||
|
||||
1. Téléchargez chaque dossier de skill individuellement
|
||||
2. Créez un fichier ZIP pour chaque skill
|
||||
3. Uploadez via **Settings** → **Capabilities** → **Skills**
|
||||
|
||||
## Étape 4 : Vérification de l'Installation
|
||||
|
||||
### Tester le Serveur MCP
|
||||
|
||||
```bash
|
||||
# Avec Claude Code
|
||||
claude
|
||||
|
||||
# Dans la session, demandez :
|
||||
"Liste les outils MCP N8N disponibles"
|
||||
```
|
||||
|
||||
Vous devriez voir 20 outils disponibles (7 documentation + 13 gestion).
|
||||
|
||||
### Tester les Skills
|
||||
|
||||
Essayez ces commandes :
|
||||
- "Explique-moi la syntaxe des expressions N8N"
|
||||
- "Quels sont les patterns de workflows disponibles ?"
|
||||
- "Comment utiliser les outils MCP N8N ?"
|
||||
|
||||
Les skills devraient s'activer automatiquement.
|
||||
|
||||
## Étape 5 : Configuration du Projet N8N Agent
|
||||
|
||||
Dans votre dossier de projet :
|
||||
|
||||
1. Le fichier **Claude.md** est déjà créé avec la configuration de l'agent
|
||||
2. Créez un fichier **.mcp.json** avec votre configuration MCP
|
||||
3. (Optionnel) Créez un **.env** pour vos variables sensibles
|
||||
|
||||
### Exemple .env
|
||||
|
||||
```env
|
||||
N8N_API_URL=https://votre-instance.n8n.io
|
||||
N8N_API_KEY=votre_api_key_super_secrete
|
||||
MCP_MODE=stdio
|
||||
LOG_LEVEL=error
|
||||
DISABLE_CONSOLE_OUTPUT=true
|
||||
N8N_MCP_TELEMETRY_DISABLED=true
|
||||
```
|
||||
|
||||
### Exemple .mcp.json
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"n8n-mcp": {
|
||||
"command": "npx",
|
||||
"args": ["n8n-mcp"],
|
||||
"env": {
|
||||
"MCP_MODE": "stdio",
|
||||
"N8N_API_URL": "${N8N_API_URL}",
|
||||
"N8N_API_KEY": "${N8N_API_KEY}",
|
||||
"LOG_LEVEL": "error",
|
||||
"DISABLE_CONSOLE_OUTPUT": "true"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Étape 6 : Désactiver la Télémétrie (Optionnel)
|
||||
|
||||
```bash
|
||||
npx n8n-mcp telemetry disable
|
||||
```
|
||||
|
||||
Ou ajoutez à vos variables d'environnement :
|
||||
```env
|
||||
N8N_MCP_TELEMETRY_DISABLED=true
|
||||
```
|
||||
|
||||
## Structure du Projet Final
|
||||
|
||||
```
|
||||
n8n-Agent/
|
||||
├── Claude.md # Configuration de l'agent (créé ✓)
|
||||
├── INSTALLATION.md # Ce fichier (créé ✓)
|
||||
├── .mcp.json # Configuration MCP (à créer)
|
||||
├── .env # Variables d'environnement (à créer)
|
||||
├── .gitignore # Ignorer .env et credentials
|
||||
└── workflows/ # Vos workflows N8N (optionnel)
|
||||
```
|
||||
|
||||
## Vérification Finale
|
||||
|
||||
Lancez Claude Code dans ce dossier :
|
||||
|
||||
```bash
|
||||
cd "c:\GIT\n8n Agent"
|
||||
claude
|
||||
```
|
||||
|
||||
Testez avec cette commande :
|
||||
```
|
||||
"Je suis ton agent consultant N8N. Peux-tu me confirmer que tu as accès à :
|
||||
1. Les 20 outils MCP N8N
|
||||
2. Les 7 skills N8N
|
||||
3. La documentation de 1,084 nœuds N8N"
|
||||
```
|
||||
|
||||
## Résolution de Problèmes
|
||||
|
||||
### Erreur "MCP server not found"
|
||||
- Vérifiez que Node.js est installé : `node --version`
|
||||
- Vérifiez que npx fonctionne : `npx --version`
|
||||
|
||||
### Erreur "Invalid API Key"
|
||||
- Vérifiez votre N8N_API_KEY dans la config
|
||||
- Régénérez une nouvelle API Key dans N8N
|
||||
|
||||
### Skills non activées
|
||||
- Vérifiez l'installation : `ls ~/.claude/skills/`
|
||||
- Réinstallez via `/plugin install czlonkowski/n8n-skills`
|
||||
|
||||
### Erreur de parsing JSON
|
||||
- Vérifiez que `MCP_MODE="stdio"` est présent
|
||||
- Vérifiez que `DISABLE_CONSOLE_OUTPUT="true"` est défini
|
||||
|
||||
## Ressources
|
||||
|
||||
- **N8N MCP Server** : https://github.com/czlonkowski/n8n-mcp
|
||||
- **N8N Skills** : https://github.com/czlonkowski/n8n-skills
|
||||
- **N8N Documentation** : https://docs.n8n.io
|
||||
- **Claude Code** : https://claude.com/claude-code
|
||||
|
||||
## Support
|
||||
|
||||
Pour toute question ou problème :
|
||||
- Issues N8N-MCP : https://github.com/czlonkowski/n8n-mcp/issues
|
||||
- Issues N8N-Skills : https://github.com/czlonkowski/n8n-skills/issues
|
||||
- Claude Code : https://github.com/anthropics/claude-code/issues
|
||||
Reference in new issue
Block a user