n8n-Agent/INSTALLATION.md

# 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