Ressources · Intégration n8n

Nœud MCP Client n8nConfigurer MCP Client dans n8n.

Le nœud MCP Client n8n appelle un outil hébergé sur un serveur MCP et renvoie sa réponse dans le workflow. Six paramètres suffisent : le transport, l'URL du serveur, le mode d'authentification, l'outil appelé, la construction de son entrée, et deux options. Pour les équipes qui branchent l'IA sur des workflows réels.

Tester le nœud MCP Client sur n8nVoir les 6 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud MCP Client n8n ?

Un serveur MCP publie des outils derrière une URL. Le nœud MCP Client est la façon autonome d'aller en chercher un depuis un workflow n8n ordinaire : on lui donne l'adresse du serveur, on choisit l'outil, on décrit son entrée, il lance l'appel et récupère la réponse. Il fait partie du paquet IA de n8n et fonctionne en nœud racine, c'est-à-dire qu'il reçoit ses items par l'entrée principale comme n'importe quelle autre étape.

Premier scénario, celui d'un cabinet comptable : un PDF de facture arrive dans le workflow, un outil hébergé en extrait les lignes, et la réponse structurée repart vers Google Sheets puis vers une alerte Slack quand un montant dépasse le seuil. L'appel reste visible dans l'exécution, il n'est pas caché dans une boucle d'agent.

Deuxième scénario, un serveur MCP interne qui expose déjà la logique métier de la boîte. Plutôt que de la reconstruire appel par appel, le workflow choisit son mode dans le sélecteur Authentication et appelle l'outil par son nom. Le credential, c'est-à-dire l'identifiant enregistré dans n8n, se crée une fois dans le menu Credentials et ressert dans tous les workflows qui visent le même serveur.

Troisième scénario, un enrichissement nocturne. Le workflow parcourt une liste, appelle le même outil pour chaque ligne, et le récapitulatif part par Gmail au matin. Comme un appel d'outil peut durer, c'est Timeout, dans la collection d'options, qui évite une exécution qui reste en l'air.

Quand prendre autre chose ? Si c'est un modèle qui doit décider quel outil appeler, le travail revient au nœud AI Agent et à son port d'outils, avec un fournisseur de modèle branché derrière, Anthropic par exemple. Le MCP Client, lui, est l'option déterministe : tu nommes l'outil, il appelle cet outil, à chaque exécution.

Les limites méritent d'être dites tout de suite. Le nœud parle deux transports, et l'un des deux, Server Sent Events, est signalé comme déprécié dans le catalogue. Il n'écoute rien : il ne se réveille pas tout seul, donc une étape en amont doit lancer le workflow. Et la page décrit la version 1 du nœud, un workflow ancien peut afficher moins d'options.

Connexion

Comment s'authentifier auprès d'un serveur MCP ?

  1. 01

    Choisir le transport du serveur

    Ouvre le nœud et commence par Server Transport, le transport utilisé par ton endpoint, c'est-à-dire le point d'entrée du serveur. Deux valeurs : httpStreamable (HTTP Streamable) et sse (Server Sent Events (Deprecated)). La documentation du serveur dit laquelle il expose, et se tromper fait échouer la connexion avant l'authentification. Quand le serveur accepte les deux, HTTP Streamable est la valeur que le catalogue ne marque pas dépréciée.

  2. 02

    Coller l'URL du serveur

    MCP Endpoint URL est requis : c'est l'URL du serveur MCP auquel se connecter, dans la forme indiquée par l'exemple du champ, e.g. https://my-mcp-server.ai/mcp. Le chemin complet, pas seulement le domaine. Si l'adresse vient d'une étape précédente, une expression fait le travail : n8n lit un champ de l'item entrant avec {{ $json.champ }}, et un champ requis laissé vide bloque le nœud avant tout appel.

  3. 03

    Sélectionner le mode d'authentification

    Authentication décrit la façon de s'authentifier auprès de l'endpoint, avec cinq valeurs : bearerAuth (Bearer Auth), headerAuth (Header Auth), mcpOAuth2Api (MCP OAuth2), multipleHeadersAuth (Multiple Headers Auth) et none (None). Chacune pointe vers un credential créé une seule fois dans le menu Credentials, que les autres workflows réutilisent ensuite. Un serveur de démonstration public se contente en général de none.

Paramètres

Que règle chaque paramètre du nœud MCP Client ?

Le nœud MCP Client compte 6 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Server Transport

serverTransport

Ce que tu vois dans n8n

Notes & cas d'usage

Fixe le transport utilisé par ton endpoint, donc la manière dont le nœud dialogue avec le serveur avant toute autre chose.

Paramètres clés

  • Server Transport : httpStreamable (HTTP Streamable) est la valeur actuelle ; sse (Server Sent Events (Deprecated)) reste disponible pour les serveurs qui n'ont pas migré.
Cas d'usage
un serveur MCP auto-hébergé monté il y a un moment expose encore souvent Server Sent Events, et le workflow tourne sur cette valeur tant que le serveur n'a pas bougé.
02

MCP Endpoint URL

endpointUrl

Ce que tu vois dans n8n

Notes & cas d'usage

Porte l'URL du serveur MCP auquel se connecter. Requis, et seul paramètre qui décide quel serveur répond.

Paramètres clés

  • MCP Endpoint URL : une chaîne, du type de l'exemple e.g. https://my-mcp-server.ai/mcp, ou une expression comme {{ $json.endpoint }} quand l'adresse change d'un item à l'autre.
Cas d'usage
recette et production hébergent souvent les mêmes outils derrière deux adresses ; une expression alimentée par l'étape précédente passe de l'une à l'autre sans dupliquer le workflow.
03

Authentication

authentication

Ce que tu vois dans n8n

Notes & cas d'usage

Définit la façon de s'authentifier auprès de l'endpoint, et change le type de credential que le nœud réclame.

Paramètres clés

  • Authentication : bearerAuth (Bearer Auth), headerAuth (Header Auth), mcpOAuth2Api (MCP OAuth2), multipleHeadersAuth (Multiple Headers Auth), none (None).
Cas d'usage
un serveur qui attend un en-tête de projet en plus du jeton relève de Multiple Headers Auth ; un jeton statique unique tient dans Bearer Auth et se configure en deux minutes.
04

Tool

tool

Ce que tu vois dans n8n

Notes & cas d'usage

Désigne l'outil à utiliser sur le serveur. Requis, et c'est lui que l'exécution lance vraiment.

Paramètres clés

  • Tool : un resource locator, donc l'outil se prend dans la liste que renvoie le serveur, ou se saisit par son identifiant quand la liste ne charge pas.
Cas d'usage
sur un serveur qui publie un outil par type de document, un Switch en amont envoie chaque fichier vers la bonne branche, avec un nœud MCP Client par branche et aucune configuration commune à maintenir.
05

Input Mode

inputMode

Ce que tu vois dans n8n

Notes & cas d'usage

Décide comment l'entrée de l'outil se construit : champ par champ, ou d'un bloc.

Paramètres clés

  • Input Mode : manual (Manual) pour saisir la donnée d'entrée de chaque paramètre de l'outil, json (JSON) pour la passer sous forme d'objet JSON.
  • Parameters : requis en mode Manual, il fait correspondre chaque paramètre de l'outil à une valeur ou une expression.
  • JSON : l'objet envoyé en mode JSON.
Cas d'usage
Manual garde un outil court lisible pour la personne qui reprendra le workflow ; JSON gagne quand l'étape d'avant a déjà produit tout le contenu.
06

Options

options

Ce que tu vois dans n8n

Notes & cas d'usage

Regroupe les options supplémentaires à ajouter, qui touchent à ce qui revient et au temps qu'on accorde à l'appel.

Paramètres clés

  • Convert to Binary : convertir images et audio en données binaires ; laissé inactif, images et audio reviennent en chaînes encodées en base64.
  • Timeout : le temps en ms accordé à l'appel d'outil pour se terminer.
Cas d'usage
un outil qui génère une image a besoin de Convert to Binary pour que le fichier soit joignable ensuite, et un outil lent demande un Timeout plus large sous peine d'exécution coupée en plein appel.
Besoin d'aide

Besoin d'aide pour automatiser MCP Client avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

MCP Client et n8n, les questions qui suivent

01Le nœud MCP Client n8n est-il inclus et gratuit ?
Oui. Il fait partie du paquet IA de n8n, @n8n/n8n-nodes-langchain, livré avec le produit. Rien à installer, aucun surcoût côté n8n, aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne pareil de l'autre. Ce qui peut coûter, c'est ce qui se trouve derrière l'endpoint : le serveur MCP appelé, et le fournisseur de modèle impliqué plus loin dans le workflow, facturent leurs propres appels d'API selon leurs conditions. n8n n'ajoute rien à cette facture.
02Que faut-il pour que le nœud fonctionne ?
Trois choses, sans lesquelles il ne s'exécute pas. Une MCP Endpoint URL, puisque le champ est requis et qu'un champ requis vide bloque le nœud. Un transport qui correspond au serveur, choisi dans Server Transport entre HTTP Streamable et Server Sent Events, ce dernier étant déprécié. Et un outil, pris dans le resource locator Tool. L'authentification est plutôt une décision qu'une obligation : le sélecteur accepte None pour un serveur qui ne demande rien, et sinon il pointe vers un credential créé une fois dans le menu Credentials, réutilisable ensuite partout.
03Quelles sont ses limites ?
Il appelle un outil par nœud, sur un endpoint, avec l'entrée que tu décris. Il n'écoute rien, donc une étape Schedule ou Webhook en amont doit lancer le workflow. Ses deux transports sont HTTP Streamable et Server Sent Events, le second signalé comme déprécié dans le catalogue. La collection d'options tient en deux entrées, Convert to Binary et Timeout, rien d'autre. La page décrit la version 1 du nœud, un workflow plus ancien peut afficher moins d'options. Et la liste d'outils dépend de la réponse du serveur, ce qui fait qu'un mauvais transport ressemble à un catalogue vide.
04Par quoi commencer quand on débute ?
Prends un serveur MCP public, mets Authentication sur None et Input Mode sur Manual. Cette combinaison sort les credentials de l'équation et affiche les paramètres de l'outil comme des champs ordinaires, ce qui montre vite ce que le serveur attend. Dès que l'appel répond, remplace les valeurs par des expressions du type {{ $json.champ }} pour que le nœud lise l'item entrant. Le mode JSON vient après, quand une étape amont fabrique déjà l'objet complet. Et si c'est un modèle qui doit choisir l'outil, ce rôle revient au nœud AI Agent et à son port d'outils.
05n8n ou Make pour appeler un serveur MCP ?
Ça dépend d'où doivent rester les données. n8n s'auto-héberge avec Docker ou npm, ou s'utilise sur n8n Cloud, et le workflow est identique dans les deux cas, ce qui compte quand le serveur MCP vit sur un réseau interne. Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération : un workflow qui appelle un outil pour chaque ligne d'un lot a donc un coût qui suit le volume. Sur la logique visuelle, les deux se tiennent. Tranche sur l'hébergement, la maîtrise des données, puis le modèle de coût.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations