N

n8n-MCP

Un serveur MCP pour consulter les nœuds et valider une proposition, avec un accès aux workflows seulement si tu configures l'API de ton instance.

Dépôt· Romuald Czlonkowski· Licence MITComment démarrer ↓

EN UN COUP D’ŒIL

Ça sert à
  • Retrouver les paramètres d'un nœud
  • Préparer un workflow
  • Reprendre un workflow existant
Pour démarrer
  1. Régler la télémétrie
  2. Ajouter le serveur
  3. Vérifier
  4. Ouvrir l'accès à une instance

C'est quoi ?

n8n-MCP est un serveur MCP maintenu par Romuald Czlonkowski, sous licence MIT. Il donne à un assistant, par exemple claude-code, le catalogue des nœuds de n8n (les blocs d'un workflow), leurs propriétés, des exemples de configuration et des outils de validation.

Sans accès à ton instance, il aide à préparer une configuration ; avec les accès API, il peut aussi gérer et exécuter des workflows. Le client IA, n8n-MCP et l'instance n8n restent trois composants distincts.

À quoi ça sert ?

Retrouver les paramètres d'un nœud

Pour recevoir un formulaire par webhook, l'assistant cherche le nœud avec search_nodes, puis lit ses propriétés avec get_node, au lieu de proposer des champs de mémoire. Ce sont des outils appelés par l'assistant, pas des commandes à saisir.

Préparer un workflow

L'assistant livre un JSON et ses choix de configuration. validate_node vérifie les paramètres d'un nœud, validate_workflow le workflow assemblé, ses connexions et ses expressions.

Reprendre un workflow existant

Pars d'un export JSON pour faire examiner une configuration. Avec l'API d'une instance, précise le workflow et l'environnement visés.

Pourquoi ?

n8n est l'éditeur et le moteur qui exécutent les workflows ; n8n-MCP est un projet tiers qui apporte à l'assistant un catalogue et des validations. n8n propose aussi son propre serveur MCP, activé dans les réglages de l'instance : il retrouve et lance les workflows que tu as exposés et, depuis la version 2.13.0, en crée et en modifie.

Trois limites. Le catalogue du paquet peut différer des nœuds et des versions de ton instance : vérifie avant d'importer. La télémétrie est activée par défaut : elle peut collecter des structures de workflows, assainies, même sans accès à ton instance. Une validation ne vérifie ni les droits, ni les secrets, ni la réponse réelle d'une intégration. Avec l'API, le serveur peut créer, modifier et exécuter des workflows : le README déconseille de modifier directement la production avec une IA.

Comment je m'en sers ?

  1. Régler la télémétrie

    Il faut Node.js. Désactive-la si tu le souhaites ; la sous-commande status en donne l'état.

    npx n8n-mcp telemetry disable
  2. Ajouter le serveur

    Sans URL d'instance ni clé API, pour Linux, macOS ou Windows avec WSL ou Git Bash ; le guide du projet donne la variante PowerShell.

    claude mcp add n8n-mcp -e MCP_MODE=stdio -e LOG_LEVEL=error -e DISABLE_CONSOLE_OUTPUT=true -- npx n8n-mcp
  3. Vérifier

    Ouvre la liste des serveurs, puis demande tools_documentation et la recherche d'un nœud connu : cela confirme l'accès documentaire, pas qu'un workflow fonctionne.

    /mcp
  4. Ouvrir l'accès à une instance

    Seulement sur une copie sauvegardée, dans une instance de test : renseigne N8N_API_URL et N8N_API_KEY dans la configuration du serveur, hors des conversations. Avec Docker, l'URL doit être joignable depuis le serveur.

FONCTIONNE AVECn8n →Claude Code →

Recevoir la newsletter

Des tutos, des essais et des retours bruts sur ce que je construis. Le lien pour te désabonner est en bas de chaque édition.

L’inscription se termine sur Substack, dans un nouvel onglet.