Ressources · Intégration n8n

Nœud MCP Client Tool n8nConfigurer MCP Client Tool dans n8n.

Un serveur MCP expose déjà des outils que ton agent pourrait appeler. Le nœud MCP Client Tool n8n s'y connecte par une adresse SSE et transmet ces outils à un AI Agent. Quatre paramètres, un port de sortie, aucune entrée principale : c'est un sous-nœud.

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

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

Pourquoi automatiser

Que fait le nœud MCP Client Tool n8n pour ton agent ?

C'est un client Model Context Protocol. Il se connecte à un serveur MCP externe, lit la liste des outils que ce serveur publie, et la présente à l'AI Agent auquel il est raccordé. L'agent ne se limite plus aux outils montés à la main dans n8n : il appelle ceux du serveur, dans la limite du filtre que tu poses.

Premier cas : l'assistant personnel. Un agent tourne sur un modèle de chat, garde le fil de la conversation grâce à un sous-nœud de mémoire, et atteint agenda et boîte mail via un seul serveur MCP. C'est la forme du template 3905, qui associe ce nœud à un Google Gemini Chat Model et à Simple Memory. Pour un envoi d'email simple et prévisible, le nœud Gmail reste plus court.

Deuxième cas : un serveur maison qui habille ta propre logique. Le template 3514 construit un serveur MCP avec HTTP Request et Call n8n Workflow Tool, puis pointe ce nœud dessus. L'agent voit une liste d'outils propre au lieu d'un tas d'endpoints bruts, et l'implémentation reste dans n8n.

Troisième cas : dégrossir un serveur trop bavard. Certains serveurs publient bien plus d'outils qu'un agent n'en a besoin. Le paramètre Tools to Include réglé sur selected ou except coupe la liste avant qu'elle n'arrive au modèle. L'agent reste concentré, et le prompt ne gonfle pas.

Quand prendre autre chose. Dès qu'un nœud dédié existe, il gagne : pour un tableur, Google Sheets va droit au but ; pour un message d'équipe, Slack aussi. La doc du nœud signale par ailleurs qu'un service déjà présent dans le registre des serveurs MCP de n8n se connecte depuis le panneau du nœud, sans credential, c'est-à-dire sans identifiants à enregistrer. Ce nœud sert aux serveurs qui n'y figurent pas encore.

Les limites, pour finir. Pas d'entrée principale, donc aucune exécution isolée : le nœud n'agit que si le nœud racine décide d'appeler l'un des outils. La connexion passe par une adresse SSE, que le serveur doit exposer. Et l'AI Agent au-dessus garde son propre modèle de chat, chez Anthropic ou ailleurs, dont le fournisseur facture les appels d'API selon ses conditions.

Connexion

Comment s'authentifier auprès de ton serveur MCP ?

  1. 01

    Renseigner l'adresse SSE

    Ouvre le nœud et remplis SSE Endpoint, l'adresse SSE de ton serveur MCP. Le champ affiche la forme attendue en exemple, e.g. https://my-mcp-server.ai/sse. C'est une chaîne de caractères : une expression n8n fonctionne aussi, par exemple {{ $json.endpoint }} si l'adresse arrive avec l'item entrant. Tant que ce champ est vide, rien ne part.

  2. 02

    Choisir la méthode d'authentification

    Le sélecteur Authentication propose bearerAuth (Bearer Auth), headerAuth (Header Auth) et none (None). La doc du nœud ajoute la gestion de plusieurs en-têtes et OAuth2. Bearer convient au serveur qui attend un jeton ; l'en-tête générique au serveur qui impose son propre nom de clé. None tente la connexion sans aucune authentification.

  3. 03

    Créer le credential une seule fois

    Les credentials se créent dans le menu Credentials de n8n, pas dans le nœud, et un credential créé une fois se réutilise dans tous les workflows de l'instance. Pour Multiple Headers Auth, la doc précise que chaque en-tête s'ajoute sous forme de paire Name et Value, autant de fois que le serveur l'exige, par exemple une clé d'API et un nom d'utilisateur.

Connexions

Sur quoi ce sous-nœud se branche-t-il ?

n8n sépare le travail IA entre un nœud racine, qui reçoit les items du workflow par son entrée principale, et des sous-nœuds qui se clipsent sur ses ports, un type de sous-nœud par port. MCP Client Tool est un sous-nœud : sans entrée principale, il vit sur le port du dessous.

Sortie (où il se branche)

  • Toolai_tool
01ToolC'est la seule connexion du nœud, et c'est une sortie : il se rattache au port Tool d'un nœud racine, qui décide ensuite quand appeler les outils publiés par le serveur MCP.

C'est la seule connexion du nœud, et c'est une sortie : il se rattache au port Tool d'un nœud racine, qui décide ensuite quand appeler les outils publiés par le serveur MCP.

Paramètres clés

  • Required : un sous-nœud ne s'exécute jamais seul, un MCP Client Tool posé sans rattachement ne fait donc rien.
  • AI Agent : l'hôte habituel, celui qui raisonne avec un modèle de chat et choisit un outil à chaque tour.
  • AI Agent Tool : un agent exposé comme outil à un autre agent, pour faire descendre les outils MCP d'un niveau.
  • MCP Server Trigger : la racine qui republie des outils vers des clients externes.
Cas d'usage
raccorde-le sous un agent qui a déjà son modèle de chat, et la liste d'outils du serveur apparaît dès l'exécution suivante.
Paramètres

Quels paramètres le nœud MCP Client Tool expose-t-il ?

Le nœud MCP Client Tool compte 4 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

SSE Endpoint

sseEndpoint

Ce que tu vois dans n8n

Notes & cas d'usage

Désigne le serveur MCP dont le nœud doit lire les outils. C'est l'unique champ requis, et un champ requis laissé vide bloque l'exécution du nœud.

Paramètres clés

  • SSE Endpoint : une chaîne, l'adresse SSE de ton serveur MCP, sur le modèle de l'exemple affiché e.g. https://my-mcp-server.ai/sse ; passe par {{ $json.sseEndpoint }} quand l'adresse voyage avec l'item.
Cas d'usage
une adresse par serveur. Un workflow qui interroge deux serveurs MCP embarque deux copies du nœud, chacune avec la sienne.
02

Authentication

authentication

Ce que tu vois dans n8n

Notes & cas d'usage

Détermine comment la connexion se présente au serveur. Règle-le avant le premier essai : un serveur qui attend un jeton refuse tout client anonyme.

Paramètres clés

  • Authentication : trois choix au sélecteur, bearerAuth (Bearer Auth), headerAuth (Header Auth) et none (None). La doc ajoute plusieurs en-têtes et OAuth2 aux méthodes acceptées, et indique que None tente la connexion sans authentification.
Cas d'usage
un serveur de démonstration public tourne en None ; un serveur interne s'ouvre en général avec un jeton bearer stocké dans le menu Credentials.
03

Tools to Include

include

Ce que tu vois dans n8n

Notes & cas d'usage

Filtre ce que le serveur publie avant que l'AI Agent ne le voie. Laisse-le tranquille sur un petit serveur, sers-t'en dès que la liste dépasse ce qu'un agent peut suivre.

Paramètres clés

  • Tools to Include : le sélecteur lui-même, avec all (All) pour tout exposer, selected (Selected) pour lister ce qui passe, except (All Except) pour lister ce qui reste dehors.
  • Tools to Include : la liste à choix multiples qui apparaît sur selected, remplie depuis le catalogue ou par une expression.
  • Tools to Exclude : son miroir sur except, tout ce qui n'est pas nommé reste accessible.
Cas d'usage
un serveur qui lit et écrit se réduit aux outils de lecture pour un agent qui ne fait que répondre.
04

Options

options

Ce que tu vois dans n8n

Notes & cas d'usage

Une collection qu'on ouvre avec Add Option, pour les réglages qui ne méritent pas un champ à part. Elle reste vide la plupart du temps.

Paramètres clés

  • Timeout : la durée en millisecondes pendant laquelle n8n attend la fin des appels d'outils. À monter pour un serveur qui travaille vraiment derrière un outil, sinon un appel coupé trop tôt ressemble à une panne.
Cas d'usage
un outil qui interroge un gros jeu de données avant de répondre est la raison classique d'ouvrir cette collection.
Besoin d'aide

Besoin d'aide pour automatiser MCP Client Tool avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Questions fréquentes sur le nœud MCP Client Tool

01Le nœud MCP Client Tool est-il inclus dans n8n ?
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. Le comportement est le même sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée via Docker ou npm, en Community Edition sous licence Sustainable Use. Rien de plus à prévoir côté plateforme. Le coût vient d'ailleurs : l'agent au-dessus de ce nœud tourne sur un modèle de chat, et le fournisseur de ce modèle facture ses propres appels d'API selon ses conditions.
02Que faut-il pour que le nœud fonctionne ?
Deux choses. Une adresse SSE, celle du serveur MCP que tu veux atteindre, à coller dans le champ SSE Endpoint. Et une méthode d'authentification qui corresponde à ce que ce serveur attend : le sélecteur Authentication propose Bearer Auth, Header Auth et None, la doc du nœud ajoutant la gestion de plusieurs en-têtes et OAuth2. Les credentials se créent une fois dans le menu Credentials et se réutilisent partout. Raccourci utile : un service déjà présent dans le registre des serveurs MCP de n8n se connecte sans credential.
03Quelles sont les limites du nœud MCP Client Tool n8n ?
C'est un sous-nœud, en version 1 au catalogue. Sans entrée principale, il ne s'exécute jamais seul : il n'agit que lorsqu'un nœud racine appelle l'un de ses outils. Il lui faut aussi une adresse SSE : un serveur qui n'en expose pas reste hors de portée. Sa surface propre est réduite, quatre paramètres seulement, et tout le reste du comportement, la liste des outils comme leur façon de répondre, appartient au serveur branché en face. Un workflow ancien peut afficher une version antérieure. Avec moins d'options, donc.
04Que faut-il brancher au minimum, et par quoi commencer ?
Au minimum un nœud racine sur le port Tool. L'AI Agent est le choix courant, et cet agent réclame son propre modèle de chat avant de tourner, chez OpenAI, Anthropic, Google ou Mistral. Les templates publiés donnent un bon point de départ : le 3905 associe ce nœud à un Google Gemini Chat Model et à Simple Memory, le 3770 y ajoute Call n8n Workflow Tool. Commence avec un seul serveur et l'option All : tu affineras le filtre une fois que l'agent tourne correctement.
05n8n ou Make pour brancher un serveur MCP ?
Tout dépend d'où doit tourner le workflow. Make est hébergé, sans option d'auto-hébergement, et se facture à l'opération : un agent bavard qui enchaîne les appels d'outils devient une ligne de coût à surveiller. n8n s'utilise sur le Cloud ou sur ta propre machine, avec un workflow identique dans les deux cas, ce qui compte quand le serveur MCP vit sur un réseau interne. La logique visuelle diffère aussi d'une plateforme à l'autre : essaie les deux et garde celle que tu lis le plus vite.
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