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

{
  "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) :

{
  "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

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)

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

# Lancer Claude Code
claude

# Installer le plugin de skills
/plugin install czlonkowski/n8n-skills

Installation Manuelle

# 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

# 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

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

{
  "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)

npx n8n-mcp telemetry disable

Ou ajoutez à vos variables d'environnement :

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 :

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