n8n MCP Server Trigger : URL, configuration de Claude et exemples

Le n8n MCP Server Trigger transforme un workflow ordinaire en serveur MCP que Claude peut appeler. Vous ajoutez le nœud, rattachez quelques nœuds d’outil, copiez une URL, et Claude peut soudain lire un tableur, publier sur Slack, lancer un sous-workflow ou démarrer une tâche de génération d’images, sans aucun code serveur de votre côté. Trois détails déterminent si cela fonctionne ou échoue en silence : l’URL que vous copiez, la manière dont vous la protégez et la façon dont Claude s’y connecte.

Cet article traite ces trois points. Vous obtenez un fichier de configuration à coller, quatre exemples de workflows, un tableau des erreurs les plus fréquentes et les noms exacts des options utilisés par n8n dans l’éditeur, tirés de la documentation du nœud.

Ce que fait réellement le Trigger

La plupart des triggers n8n démarrent un workflow et transmettent les données au nœud suivant. Le MCP Server Trigger fonctionne différemment. Il ne transmet pas de données en aval. Il se connecte uniquement à des nœuds d’outil et expose ces outils à tout client MCP qui connaît son URL. Lorsque Claude demande ce que le serveur sait faire, n8n répond avec la liste des outils rattachés. Lorsque Claude en choisit un, n8n l’exécute et renvoie le résultat.

Cela rapproche le canevas d’une définition d’API plutôt que d’une automatisation. Chaque outil est une capacité, et c’est le nom de l’outil combiné à sa description que Claude lit pour décider quand l’utiliser. Le nœud parle Server-Sent Events (SSE) et HTTP streamable. Il ne prend pas en charge stdio, c’est pourquoi Claude Desktop a besoin d’un petit pont, présenté plus loin.

Un seul nœud, plusieurs outils

Rattachez autant de nœuds d’outil que nécessaire : Google Sheets Tool, Gmail Tool, HTTP Request Tool, Code Tool, Calculator, ou le Custom n8n Workflow Tool qui appelle un autre workflow. Ce dernier compte le plus en pratique. Il vous permet de garder la logique lourde dans des workflows normaux et de n’exposer qu’un point d’entrée léger et bien nommé.

💡 Nommez vos outils comme des verbes et décrivez chacun en une phrase simple. « find_order : rechercher une commande par son numéro et renvoyer le statut et la date d’expédition » vaut mieux que « orders_tool » à chaque fois, car Claude choisit ses outils uniquement à partir de ce texte.

Server Trigger ou Client Tool

n8n propose deux nœuds MCP que l’on confond souvent. Ils vont dans des directions opposées.

Si vous voulez que Claude utilise n8n, il vous faut le trigger. Si vous voulez qu’un agent n8n utilise les outils de quelqu’un d’autre, il vous faut le client tool.

Trouver la bonne URL MCP

Ouvrez le trigger et vous voyez deux URL en haut du panneau du nœud. Copier la mauvaise est l’erreur la plus fréquente au départ, et elle produit le symptôme le plus déroutant : tout fonctionne tant que l’éditeur est ouvert, puis tout s’arrête dès que vous le fermez.

URL de test ou URL de production

Si vous pointez Claude vers l’URL de test, la démo fonctionne, puis elle casse dès que vous quittez l’onglet. Si vous le pointez vers l’URL de production, le workflow répond en permanence, et chaque appel est consigné dans Executions, où vous pouvez inspecter les entrées et les sorties.

💡 Copiez l’URL directement depuis le nœud au lieu de la taper. Sur la plupart des installations, l’adresse de production ressemble à https://n8n.example.com/mcp/your-path, et l’adresse de test remplace /mcp/ par /mcp-test/. Considérez cette forme comme une indication et fiez-vous à ce qu’affiche le nœud.

Choisir un chemin stable

Le paramètre Path est prérempli avec une chaîne aléatoire afin que deux workflows n’entrent jamais en conflit. Vous pouvez le remplacer par un nom lisible, paramètres de route compris, pour que votre configuration Claude survive à une reconstruction du workflow. Utilisez un chemin par assistant : orders-assistant, support-lookup, image-studio.

Une autre règle qui met souvent les gens en difficulté : un workflow inactif ne traite pas les requêtes MCP. Si Claude se connecte mais ne voit aucun outil, vérifiez d’abord que le workflow est publié.

Verrouiller avec l’authentification Bearer

Le trigger propose trois options d’Authentication : None, Bearer auth et Header auth. None convient pour un test jetable sur votre ordinateur portable. Tout ce qui est joignable depuis l’extérieur d’un réseau de confiance nécessite l’une des deux autres, car une URL MCP publique sans authentification est un bouton public qui exécute vos workflows.

Bearer ou Header auth

Avec Bearer auth, le client envoie un en-tête Authorization: Bearer <token>. Avec Header auth, vous choisissez vous-même le nom et la valeur de l’en-tête, par exemple X-MCP-Token. Choisissez Bearer, sauf si une passerelle placée devant n8n attend déjà un en-tête personnalisé.

1. Ouvrez le trigger et réglez Authentication sur Bearer auth.
2. Créez un credential et collez un jeton aléatoire long. openssl rand -hex 32 en produit un bon.
3. Conservez le jeton dans un gestionnaire de mots de passe. Vous en aurez encore besoin pour la configuration de Claude.
4. Enregistrez puis publiez à nouveau le workflow pour que la modification prenne effet.

Garder une liste d’outils courte

Chaque outil rattaché est quelque chose qu’un prompt peut déclencher. Un modèle capable de lire des lignes et de les supprimer finira par en supprimer une lorsqu’une demande sera ambiguë. Donnez à chaque assistant un ensemble restreint d’outils, en lecture seule chaque fois que c’est possible, et figez les paramètres risqués, comme le canal Slack ou l’ID du tableur, plutôt que de laisser Claude les choisir.

Le modèle en face compte aussi. Les modèles performants pour l’appel d’outils, comme Claude Sonnet 5 et Claude Fable 5, sont de bons partenaires de test sur PicassoIA : collez vos descriptions d’outils dans un chat, envoyez dix exemples de requêtes et vérifiez quel outil le modèle choisirait pour chacune. Réécrivez toute description qui provoque un mauvais choix avant même de toucher au workflow.

Connecter Claude à votre serveur

Claude atteint un serveur MCP par trois portes différentes, et chacune réclame la même URL de production, dans un habillage légèrement différent.

Claude Desktop avec mcp-remote

Claude Desktop démarre des serveurs stdio locaux, et le trigger ne parle pas stdio. Le paquet mcp-remote s’intercale et fait la traduction. Ouvrez le fichier de configuration (sous Windows %APPDATA%\Claude\claude_desktop_config.json, sous macOS ~/Library/Application Support/Claude/claude_desktop_config.json) et ajoutez cette entrée :

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://n8n.example.com/mcp/orders-assistant",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "paste-your-bearer-token-here"
      }
    }
  }
}

Copier le prompt

Le jeton se trouve dans env et l’argument d’en-tête le référence, afin que l’argument reste une chaîne propre. Vous avez besoin de Node.js installé, car npx télécharge le pont au premier lancement. Quittez complètement Claude Desktop, rouvrez-le, et les outils apparaissent dans le menu des outils d’une nouvelle conversation.

Claude Code depuis le terminal

Claude Code peut dialoguer directement avec des serveurs distants, aucun pont n’est donc nécessaire :

claude mcp add --transport http n8n https://n8n.example.com/mcp/orders-assistant \
  --header "Authorization: Bearer YOUR_TOKEN"

Copier le prompt

Utilisez --transport http pour le HTTP streamable. Si votre version de n8n n’expose que l’ancien point de terminaison SSE, remplacez l’option par --transport sse. Exécutez claude mcp list pour vérifier que le serveur apparaît comme connecté, puis demandez à Claude Code de « lister les outils n8n » comme premier contrôle.

Connecteurs personnalisés de claude.ai

Dans claude.ai, ouvrez les paramètres de vos connecteurs et ajoutez un connecteur personnalisé avec l’URL de production. Les requêtes proviennent des serveurs d’Anthropic, et non de votre ordinateur portable : l’adresse doit donc être joignable depuis Internet en HTTPS. Une adresse localhost ou une IP privée ne fonctionnera pas. Placez d’abord n8n derrière un reverse proxy ou un tunnel.

💡 n8n signale une particularité : claude.ai demande une connexion même lorsque l’authentification est désactivée sur le trigger, car il part du principe que chaque point de terminaison MCP utilise une authentification utilisateur. Une demande de connexion ne signifie pas que le trigger est mal configuré.

Quatre exemples à construire

Chaque exemple ci-dessous est un nœud d’outil rattaché au même trigger. Commencez par le premier, vérifiez que Claude peut l’appeler, puis ajoutez les autres un par un.

Rechercher des lignes dans Sheets

Ajoutez un Google Sheets Tool, réglez l’opération sur la récupération de lignes et filtrez la colonne du numéro de commande avec une expression qui laisse Claude remplir la valeur :

{{ $fromAI('order_number', 'The order number the customer gave', 'string') }}

Copier le prompt

Désormais, « Où en est la commande 48213 ? » devient une véritable recherche. Description de l’outil : Rechercher une commande par son numéro et renvoyer le statut et la date d’expédition. Il est en lecture seule, c’est donc le premier outil le plus sûr à exposer.

Publier un résumé dans Slack

Ajoutez un Slack Tool avec l’opération d’envoi de message. Figez le canal et laissez Claude ne remplir que le texte :

{{ $fromAI('summary', 'A two sentence summary to post', 'string') }}

Copier le prompt

Comme le canal est fixé dans le nœud, un prompt confus ne peut rien publier ailleurs. Cette seule décision supprime l’essentiel du risque lié à l’accès en écriture d’un assistant.

Appeler un sous-workflow

Le Custom n8n Workflow Tool exécute un autre workflow qui démarre avec un Execute Workflow Trigger. C’est là que doivent aller les tâches en plusieurs étapes : enrichir un prospect, consulter le CRM, rédiger une page Notion, renvoyer un court résultat. Claude voit un seul outil avec une seule description, et toute la logique de branchement reste dans un workflow que vous pouvez tester seul.

Générer des images via une API

Un HTTP Request Tool permet à Claude de lancer des tâches de génération d’images depuis un chat. L’API de PicassoIA suit une conception de type Replicate : vous créez une prédiction, puis vous l’interrogez jusqu’à ce que le résultat soit prêt. L’adresse de base est https://api.picassoia.com/v1 et les appels utilisent un jeton Bearer qui commence par pia_sk_, créé sur la page de l’API PicassoIA.

1. Ajoutez un HTTP Request Tool nommé create_image avec la description Créer une image photoréaliste au format 16:9 à partir d’un prompt texte et renvoyer l’identifiant de la prédiction.
2. Réglez la méthode sur POST et l’URL sur https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions.
3. Réglez l’authentification sur Bearer et collez votre jeton pia_sk_.
4. Envoyez un corps JSON avec un objet input dont prompt provient de $fromAI.
5. Ajoutez un second HTTP Request Tool nommé get_image qui envoie un GET à https://api.picassoia.com/v1/predictions/ suivi de l’identifiant de la prédiction que Claude transmet.

Claude crée la tâche, attend quelques secondes, interroge get_image et vous affiche l’URL finale. Le modèle derrière le premier appel est PicassoIA Image, et PicassoIA Image Editor Pro gère les retouches selon le même schéma. Les comptes peuvent lancer jusqu’à 5 prédictions simultanément, et les prompts peuvent atteindre 4 000 caractères : rédigez donc la description de l’outil de façon à demander à Claude d’envoyer une seule requête à la fois. Consultez la page de l’API pour les champs de réponse et les exigences de forfait avant de vous appuyer dessus en production.

Corriger les échecs courants

La plupart des problèmes du MCP Server Trigger viennent d’une poignée de causes. Avant de modifier quoi que ce soit, ouvrez l’onglet Executions. Un appel qui n’y apparaît jamais n’a pas atteint n8n, ce qui pointe vers l’URL, le proxy ou la configuration de Claude. Un appel qui apparaît avec une erreur pointe vers le nœud d’outil lui-même.

Les connexions tombent derrière nginx

SSE et HTTP streamable sont des connexions de longue durée. Un reverse proxy qui met les réponses en mémoire tampon retient le flux jusqu’à ce qu’il soit plein, et Claude voit un blocage. n8n recommande de désactiver la mise en mémoire tampon du proxy, la compression gzip et le chunked transfer encoding sur le chemin MCP, et de supprimer l’en-tête Connection :

location /mcp/ {
    proxy_pass http://n8n:5678;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    proxy_buffering off;
    gzip off;
    chunked_transfer_encoding off;
}

Copier le prompt

Routage en mode queue

En mode queue avec plusieurs réplicas de webhook, chaque connexion persistante doit rester sur l’instance qui l’a ouverte. n8n documente le routage de toutes les requêtes /mcp* vers un seul réplica de webhook dédié. Ajoutez une règle dans votre load balancer pour ce chemin, et les échecs aléatoires cessent.

Essayez avec vos propres images

Vous avez maintenant la boucle complète : un nœud trigger, une URL de production, l’authentification Bearer, une configuration Claude qui pointe vers elle, et des outils qui font un vrai travail. Le workflow d’images est le plus amusant à essayer en premier, car le résultat apparaît directement dans votre chat et vous pouvez le juger en quelques secondes.

Ouvrez Picasso IA et lancez quelques prompts à la main avant de brancher l’API. Comparez GPT Image 2, Seedream 4.5 et Nano Banana 2 Lite sur le même prompt, puis gardez le style qui convient à votre projet. Une fois que vous savez quelles formes de prompts fonctionnent, intégrez-les à la description de l’outil pour que Claude rédige seul de meilleurs prompts.

Construisez le premier outil dès aujourd’hui : un trigger, un outil en lecture seule, une connexion Claude. N’ajoutez un second outil qu’une fois le premier fonctionnant sans accroc, et votre assistant grandira sans jamais vous surprendre.