Guide LangSmith Tool Gateway : identifiants, kits d'outils, politiques et approbations des agents
LangSmith Tool Gateway est entré en bêta publique le 19 novembre 2026. Il regroupe dans une seule couche gérée les identifiants, l'identité et les accès des appels d'outils des agents. Ce guide s'appuie sur un modèle Voir / Agir en tant que / Autoriser. Il couvre l'enregistrement des serveurs MCP, la création de kits d'outils, le choix entre identité par utilisateur et clé de service, et l'ajout de politiques de blocage et d'approbation. Il présente aussi les limites documentées et les points où ces contrôles cessent de vous protéger.
Qu'est-ce que LangSmith Tool Gateway et pourquoi existe-t-il
Selon la description de LangChain, LangSmith Tool Gateway est une couche d'outils gérée qui prend en charge les identifiants, l'identité et les accès pour chaque appel d'outil effectué par un agent. Elle se place entre vos agents et les serveurs MCP qu'ils appellent. Chaque agent n'a donc plus à régler ces questions de son côté.
LangChain a lancé Tool Gateway en bêta publique le 19 novembre 2026, comme l'a rapporté Unite.AI. La bêta est disponible sur les offres LangSmith Plus et Enterprise. Sur LangSmith Cloud, elle couvre les régions GCP US, GCP EU, GCP APAC et AWS US, à l'exclusion d'Azure US.
Prenons le grand distributeur américain que LangChain décrit dans son article de lancement : son équipe d'ingénierie a construit plus de 50 serveurs MCP qui exposent plus d'un millier d'outils. Chaque agent ne devrait toucher qu'une petite partie approuvée de ce catalogue, avec des identifiants adaptés à son contexte. C'est ce type de prolifération, avec des outils et des identifiants dispersés entre de nombreux serveurs et agents, que la passerelle vise à placer sous un ensemble unique de contrôles.
Une remarque avant d'entrer dans le détail. Les produits en bêta évoluent, et plusieurs détails d'implémentation comptent pour obtenir du code fonctionnel : noms des champs de réponse, paramètres de configuration, formats des points de terminaison, en-têtes d'authentification, exigences de transport et couverture des offres pour chaque fonctionnalité. Les exemples ci-dessous utilisent des valeurs génériques pour ces éléments. Vérifiez chacun d'eux dans la documentation à jour et sur de vraies réponses pendant vos tests, et recopiez les valeurs à l'identique plutôt que de les deviner.
Le modèle de gouvernance Voir / Agir en tant que / Autoriser
L'Excessive Agency (agentivité excessive), selon la définition du OWASP Gen AI Security Project, est la vulnérabilité qui permet à un LLM d'effectuer des actions dommageables en réponse à des sorties inattendues, ambiguës ou manipulées. Ses trois causes profondes habituelles sont l'excès de fonctionnalités, l'excès de permissions et l'excès d'autonomie.
Nous associons chacune de ces causes à l'un des contrôles de la passerelle, et nous appelons le résultat Voir / Agir en tant que / Autoriser (See / Act As / Allow) :
- Voir (excès de fonctionnalités) : quels outils cet agent voit-il ? Les kits d'outils.
- Agir en tant que (excès de permissions) : quels identifiants un appel transporte-t-il ? Les paramètres d'identité.
- Autoriser (excès d'autonomie) : cet appel précis doit-il s'exécuter ? Les politiques de blocage et d'approbation.
Ces couches ne se compensent pas entre elles. Un agent de remboursement doté d'un kit de deux outils dispose toujours de tout ce que son identifiant autorise. Si cet identifiant est la clé de service du backend et qu'aucune politique ne bloque un outil destructeur, le petit kit a réduit le menu sans réduire le risque.
Comment un appel d'outil traverse la passerelle
Un appel d'outil implique trois étapes d'authentification distinctes, détaillées sur la page How Tool Gateway works. Pour la conception, deux d'entre elles comptent le plus. L'appelant s'authentifie uniquement auprès de LangSmith. Tool Gateway choisit ensuite un identifiant stocké et l'utilise pour s'authentifier auprès du serveur MCP. L'appelant ne détient donc jamais le jeton ni la clé d'API du serveur. C'est le même principe qu'un proxy d'identifiants qui tient les clés d'API hors de portée des agents IA : l'agent demande, le proxy garde le secret.
Cette conception est conforme aux recommandations d'autorisation de la spécification MCP. Lorsqu'un serveur MCP appelle des API en amont, il utilise un jeton distinct émis par le serveur d'autorisation en amont et ne doit pas transmettre le jeton reçu du client MCP. Les serveurs d'autorisation devraient aussi émettre des jetons d'accès de courte durée pour limiter l'impact d'une fuite.
Quand un utilisateur n'a pas connecté de compte
Si un appel nécessite l'identifiant d'un utilisateur et que celui-ci n'a pas connecté son compte, l'appel renvoie un lien de connexion. Un client compatible avec l'élicitation d'URL MCP affiche ce lien à l'utilisateur. Les autres clients reçoivent une réponse HTTP 428 contenant le lien. Une fois l'utilisateur connecté, les appels suivants utilisent l'identifiant stocké.
Nous conseillons à votre client de traiter cette réponse comme une étape de connexion attendue plutôt que comme une erreur. Affichez le lien, attendez l'utilisateur, puis réessayez une seule fois :
resp = call_tool(req)
if resp.status == 428:
link = sign_in_link_from(resp.body) # placeholder field name
show_sign_in(link)
await user_confirms_sign_in()
resp = call_tool(req) # retry once, never loopCe que la passerelle ne fait pas aux réponses
La réponse de chaque serveur parvient à l'appelant sans modification. LangChain recommande de traiter la sortie des outils comme une entrée non fiable pour votre agent. La passerelle n'est pas un filtre de contenu. Les défenses comme la séparation des instructions et des données contre l'injection de prompt restent de votre ressort et relèvent de la conception de l'agent.
Mise en place pas à pas : serveurs, kits, mode recherche et première requête
Les écrans et les chemins d'API peuvent changer pendant la bêta. Ces étapes suivent donc les concepts documentés plutôt que les clics.
- Enregistrez chaque serveur MCP. Ajoutez le serveur pour que ce soit la passerelle, et non votre agent, qui s'y authentifie, et consultez la documentation sur l'identité avant de décider quels identifiants ses appels doivent transporter.
- Créez un kit par rôle d'agent. Choisissez des outils parmi vos serveurs enregistrés, nommez le kit d'après le rôle qu'il sert et gardez-le réduit. La documentation sur les kits d'outils explique comment créer et actualiser les kits.
- Utilisez le mode recherche pour les grands catalogues. Si un rôle a réellement besoin de nombreux outils, le mode recherche évite de charger tous les outils d'un coup.
- Envoyez une première requête depuis votre backend. Un appelant backend envoie la clé de service ainsi qu'un en-tête X-LangSmith-Identity indiquant l'utilisateur pour lequel l'appel agit :
POST <your kit's MCP endpoint, as shown in LangSmith>
<auth header carrying the service key>
X-LangSmith-Identity: <user this call acts for>
<standard MCP tool call payload>Les lignes du point de terminaison et de l'authentification sont des valeurs génériques, comme indiqué dans la remarque du début. Reprenez les valeurs exactes dans LangSmith et dans la documentation à jour.
Voir : construire des kits d'outils sélectionnés sans les confondre avec de la sécurité
Un kit est un ensemble d'outils sélectionnés parmi les serveurs enregistrés auprès de la passerelle. L'objectif est la focalisation : un agent qui gère les remboursements n'a aucune raison de voir un outil d'agenda ou un outil de déploiement. Des kits plus petits améliorent aussi la qualité, car LangChain observe que lorsqu'un agent dispose de centaines ou de milliers d'outils, les charger tous en même temps augmente la latence et complique le choix du bon outil. Jusqu'à 10,000 outils sont autorisés par kit, mais considérez ce chiffre comme un plafond et non comme un objectif.
Les kits ne sont pas un contrôle d'accès
Le même appelant qui utilise un kit peut aussi utiliser kits/me/mcp, qui expose tous les outils auxquels l'appelant a accès. C'est pourquoi la documentation de LangChain indique clairement qu'un kit n'est pas un contrôle d'accès. Retirer un outil d'un kit n'empêche pas un appel que l'identité de l'agent est autorisée à effectuer. L'application des règles doit reposer sur Agir en tant que et Autoriser.
Garder les kits à jour
Tool Gateway met en cache la liste d'outils de chaque serveur pendant deux heures, selon la documentation sur les kits d'outils. Intégrez l'actualisation des kits à chaque publication d'un serveur MCP, ou acceptez que les agents voient une liste d'outils ayant jusqu'à deux heures de retard après un changement. C'est surtout important lorsqu'une publication supprime un outil que vous ne voulez plus rendre accessible aux agents.
Agir en tant que : choisir l'identité des utilisateurs et des agents autonomes
L'identité détermine quelles permissions un appel d'outil transporte. Dans notre correspondance Voir / Agir en tant que / Autoriser, c'est la couche qui traite l'excès de permissions. Avant de choisir une approche, nous conseillons de lire la documentation sur l'identité en parallèle des deux options ci-dessous.
Identifiants par utilisateur
Chaque utilisateur connecte son propre compte via le parcours de connexion décrit plus haut. Cette option convient aux assistants qui agissent pour une personne, puisque l'agent ne peut faire que ce que cette personne peut déjà faire en amont.
Clé de service avec l'en-tête X-LangSmith-Identity
Les systèmes backend utilisent une clé de service accompagnée d'un en-tête X-LangSmith-Identity. Tool Gateway fait confiance à la valeur de cet en-tête telle qu'elle est envoyée. Tout appelant détenant la clé de service peut donc agir au nom de n'importe quel utilisateur. N'envoyez l'en-tête que depuis un backend que vous contrôlez et n'exposez jamais la clé de service à un navigateur ou à un utilisateur final ; c'est la recommandation de LangChain elle-même. Traitez cette clé comme un identifiant root.
La comparaison ci-dessous est notre propre évaluation, et non la documentation de LangChain.
| Question | Identifiants par utilisateur | Clé de service sur un backend |
|---|---|---|
| Pour qui l'appel agit | Une personne qui a connecté son propre compte | L'identité que votre backend envoie dans l'en-tête |
| Usage typique | Assistants interactifs et copilotes | Services backend et agents sans surveillance ou planifiés |
| Risque principal | Comptes connectés disposant de droits plus larges que la tâche ne l'exige | Une clé divulguée permet d'usurper l'identité de n'importe quel utilisateur |
| Politiques d'approbation | Applicables, car la personne est présente pour confirmer | Utiles seulement si une personne est présente ; sinon, utilisez des politiques de blocage |
Notre règle empirique : utilisez les identifiants par utilisateur lorsqu'une personne est présente et que l'action lui appartient, et la clé de service, envoyée uniquement depuis un backend que vous contrôlez, lorsqu'une tâche s'exécute sans surveillance ou agit pour le système.
Autoriser : rédiger des politiques de blocage et d'approbation qui tiennent vraiment
Les politiques constituent la couche d'application, et deux comportements par défaut décrits dans la documentation sur les politiques conditionnent tout le reste. Un appel qui ne correspond à aucune politique s'exécute. Si un appel correspond à la fois à une politique de blocage et à une politique d'approbation, il est bloqué. C'est le premier comportement qui piège les équipes : un outil pour lequel personne n'a écrit de politique est un outil que tout appelant autorisé peut utiliser.
Qui approuve réellement
Avec une politique d'approbation, c'est l'appelant qui approuve l'appel, et non un relecteur distinct. Chaque appel est confirmé avant de s'exécuter, mais rien n'est transmis à un administrateur. Un agent qui fonctionne sans personne présente ne peut pas approuver d'appels. Dans ce cas, LangChain recommande une politique de blocage pour empêcher l'agent d'appeler l'outil.
Le contrôle humain dans la boucle, où une personne approuve les actions à fort impact avant qu'elles n'aient lieu, fait partie des mesures d'atténuation recommandées par l'OWASP. L'approbation par l'appelant convient lorsqu'un utilisateur laisse un assistant envoyer un e-mail depuis son propre compte. Elle ne convient pas aux actions qui nécessitent un second regard, comme un remboursement au-delà d'un seuil fixé par votre équipe financière. Pour celles-ci, bloquez l'outil au niveau de la passerelle ou mettez en place une étape d'approbation préalable dans votre propre application.
Capacité
Une organisation peut avoir jusqu'à 1,000 politiques applicables à tous les espaces de travail, plus jusqu'à 100 politiques par espace de travail. Créer une politique au-delà de l'une ou l'autre limite renvoie une erreur 422. Placez au niveau de l'organisation les règles comme le blocage des outils irréversibles pour les agents sans surveillance, et les règles propres à une équipe dans les espaces de travail. Si vous générez des politiques automatiquement, gérez l'erreur 422 pour qu'un script échoue de façon visible plutôt que de laisser une règle non écrite.
Plan de déploiement : des secrets dispersés à une passerelle gouvernée unique
Exécutez ces étapes du risque le plus faible au plus élevé.
- Inventaire. Listez chaque serveur MCP et chaque outil utilisés par vos agents, et classez-les par impact : lecture, écriture, irréversible ou exposé à l'extérieur.
- Enregistrement des serveurs. Transférez les identifiants en amont dans la passerelle, puis vérifiez qu'aucune configuration d'agent ne contient encore de clé en amont.
- Voir. Créez un kit par rôle d'agent avec le plus petit ensemble d'outils utile.
- Agir en tant que. Identifiants par utilisateur pour les assistants qui agissent pour des personnes ; clé de service, depuis un backend uniquement, pour les tâches autonomes.
- Autoriser. D'abord les politiques de blocage, pour les agents sans surveillance et les outils irréversibles, puis les politiques d'approbation pour les appels interactifs sensibles.
- Vérifiez l'arrivée des traces. Consultez le projet de traçage tool-gateway et l'onglet Usage après vos premiers appels de test.
- Tests de charge. Testez les limites documentées (voir la section sur les mises en garde ci-dessous) avec un trafic réaliste.
Liste de contrôle avant la production
- [ ] Aucune clé ni aucun jeton en amont ne subsiste dans le code des agents, les prompts ou la configuration des clients
- [ ] Aucun agent sans surveillance ne dépend d'une politique d'approbation
- [ ] Les clients gèrent les réponses de connexion HTTP 428 sans boucler
- [ ] Les agents traitent la sortie des outils comme une entrée non fiable
- [ ] L'actualisation des kits fait partie du processus de publication des serveurs MCP
Observabilité : ce qu'enregistrent les traces et l'onglet Usage
Les traces des appels d'outils enregistrent pour chaque appel l'outil, le serveur, l'utilisateur, le résultat et la durée. Les données envoyées à l'outil ou renvoyées par celui-ci ne sont pas stockées. Les contenus sensibles restent hors de l'enregistrement, tout comme les détails dont vous pourriez avoir besoin plus tard pour une enquête. Les traces arrivent dans un projet de traçage nommé tool-gateway, que la passerelle crée lorsqu'elle enregistre le premier appel, comme l'explique la documentation sur les traces. Les traces de l'espace de travail sont gratuites et ne sont pas décomptées de vos limites de traces. Le coût n'est donc pas une raison de s'en passer. Pour des vérifications plus rapides, l'onglet Usage liste les 100 appels d'outils les plus récents des 7 derniers jours, avec pour chacun l'outil, le serveur, le résultat, la latence et l'heure de début. Cette vue convient aux vérifications pendant le déploiement plutôt qu'à l'audit à long terme.
Si votre processus de conformité ou de réponse aux incidents exige une analyse forensique au niveau du contenu des appels, cette journalisation doit se trouver dans la couche de votre agent ou de votre application, par exemple aux côtés du traçage OpenTelemetry GenAI pour les agents.
Mises en garde, limites de la bêta et cas où les secrets par agent suffisent encore
Les limites strictes indiquées dans la documentation Tool Gateway de LangChain, à commencer par la présentation How Tool Gateway works, sont une taille de requête de 1 Mo, une taille de réponse de 8 Mo, 60 secondes pour que le serveur MCP commence à répondre, et 100 requêtes par seconde avec des pics jusqu'à 1,000. Les outils qui renvoient de gros documents ou dépendent de systèmes en amont lents sont ceux à tester en charge en priorité.
Pendant la bêta, l'accès est limité aux offres Plus et Enterprise et aux quatre régions cloud citées. Le comportement de la bêta peut changer, et ce guide reflète la documentation disponible au lancement. Nous conseillons de régler les détails d'implémentation signalés au début, comme les exigences de transport et la couverture des offres pour les fonctionnalités de gouvernance, avant de planifier une migration.
Quand une passerelle est gagnante
Une passerelle est rentable lorsque vous avez de nombreux serveurs MCP et de nombreux agents, lorsque chaque utilisateur a besoin d'un accès délégué, ou lorsqu'une équipe de sécurité veut un point unique pour définir et revoir les politiques.
Quand des secrets par agent peuvent suffire
Toutes les équipes n'en ont pas besoin. Si vous exploitez un seul agent avec quelques outils, un seul responsable et aucun accès délégué par les utilisateurs, une passerelle centrale risque d'ajouter plus de processus que de protection.
Points clés
- LangSmith Tool Gateway est entré en bêta publique le 19 novembre 2026, sur les offres Plus et Enterprise, dans les régions GCP US, GCP EU, GCP APAC et AWS US. Azure US est exclu.
- Le modèle Voir / Agir en tant que / Autoriser associe les causes profondes de l'Excessive Agency selon l'OWASP aux kits, à l'identité et aux politiques. Chaque couche a ses propres limites.
- L'appelant s'authentifie uniquement auprès de LangSmith et ne détient jamais les jetons ni les clés d'API des serveurs MCP en amont, conformément à l'interdiction de transmission de jetons de la spécification MCP.
- Les kits d'outils déterminent ce que voit un agent mais ne sont pas un contrôle d'accès, car un appelant peut toujours atteindre kits/me/mcp et tous les outils que son identité autorise.
- Avec l'en-tête X-LangSmith-Identity, toute personne détenant la clé de service peut agir au nom de n'importe quel utilisateur. Gardez cette clé sur un backend que vous contrôlez.
- Les politiques autorisent les appels par défaut, le blocage l'emporte sur l'approbation et l'appelant est l'approbateur. Les agents sans surveillance ont besoin de politiques de blocage.
- Les traces n'incluent pas le contenu des appels et la sortie des outils passe sans modification. Tenez compte des limites de 1 Mo par requête, 8 Mo par réponse, 60 secondes et 100 requêtes par seconde.
Conclusion
Commencez par l'inventaire. Classez chaque outil MCP utilisé par vos agents en lecture, écriture, irréversible ou exposé à l'extérieur, et rédigez des politiques de blocage pour les outils irréversibles et exposés à l'extérieur avant de placer le moindre agent derrière la passerelle. Faites ensuite passer un seul rôle d'agent de bout en bout, avec son propre petit kit et le mode d'identité qui correspond à la personne réellement présente. N'élargissez le déploiement qu'une fois ses appels visibles dans le projet de traçage tool-gateway et les tests de charge maintenus dans les limites documentées.
L'exception concerne les petites équipes. Si vous exploitez un seul agent avec quelques outils et un seul responsable, un secret côté serveur au périmètre étroit, avec des jetons de courte durée, peut rester le choix le plus simple. La passerelle peut attendre l'arrivée d'un deuxième agent ou d'un accès délégué par les utilisateurs.
Questions fréquentes
LangSmith Tool Gateway est-il disponible pour tous, et quelles offres et régions le prennent en charge ?
Pas encore. Il a été lancé en bêta publique le 19 novembre 2026. La bêta est disponible sur les offres LangSmith Plus et Enterprise et, sur LangSmith Cloud, elle couvre GCP US, GCP EU, GCP APAC et AWS US. Azure US est exclu. Consultez la documentation à jour avant de vous engager, car le périmètre de la bêta peut changer.
Les kits d'outils empêchent-ils un agent d'appeler des outils hors du kit ?
Non. La documentation de LangChain indique qu'un kit n'est pas un contrôle d'accès, car le même appelant peut utiliser kits/me/mcp, qui expose tous les outils auxquels il a accès. Les kits déterminent ce que voit l'agent. Pour restreindre ce qu'il peut réellement faire, appuyez-vous sur le périmètre de l'identité et sur les politiques de blocage.
Que doit faire mon client lorsqu'il reçoit une réponse HTTP 428 ?
La traiter comme une étape de connexion. La réponse 428 contient un lien de connexion pour un utilisateur qui n'a pas connecté son compte. Affichez le lien, attendez que l'utilisateur confirme sa connexion, puis réessayez l'appel initial une seule fois. Pour trouver le champ qui contient le lien, consultez la documentation à jour ou examinez une vraie réponse pendant vos tests.
Qui approuve un appel soumis à une politique d'approbation, et que faire pour les agents sans surveillance ?
C'est l'appelant qui approuve l'appel. Il n'existe ni relecteur distinct ni file d'attente d'administration. Un agent qui fonctionne sans personne présente ne peut pas approuver d'appels ; LangChain recommande donc des politiques de blocage pour empêcher ces agents d'utiliser un outil. Si une seconde personne doit examiner les actions à fort impact, intégrez cette étape à votre propre application ou bloquez l'outil.
Tool Gateway stocke-t-il les entrées et les sorties des appels d'outils ?
Non. Les traces des appels d'outils enregistrent pour chaque appel l'outil, le serveur, l'utilisateur, le résultat et la durée, mais les données envoyées à l'outil ou renvoyées par celui-ci ne sont pas stockées. Si vous avez besoin d'enregistrements au niveau du contenu pour la conformité ou l'analyse forensique, prévoyez cette journalisation dans votre propre couche applicative.
La passerelle nettoie-t-elle les réponses des outils contre l'injection de prompt ?
Non. Tool Gateway transmet la réponse de chaque serveur à l'appelant sans modification, et la documentation recommande de traiter la sortie des outils comme une entrée non fiable pour votre agent. Les défenses contre l'injection de prompt relèvent toujours de la conception de votre agent.
Quelles sont les limites documentées de taille, de délai et de débit ?
Les limites strictes documentées sont une taille de requête de 1 Mo, une taille de réponse de 8 Mo, 60 secondes pour que le serveur MCP commence à répondre, et 100 requêtes par seconde avec des pics jusqu'à 1,000. Testez en charge les outils qui renvoient de gros documents ou dépendent de systèmes en amont lents avant de passer en production.
Sources
- https://www.langchain.com/blog/langsmith-tool-gateway
- https://docs.langchain.com/langsmith/tool-gateway-how-it-works
- https://docs.langchain.com/langsmith/tool-gateway-quickstart
- https://docs.langchain.com/langsmith/tool-gateway-tool-kits
- https://docs.langchain.com/langsmith/tool-gateway-identity
- https://docs.langchain.com/langsmith/tool-gateway-policies
- https://docs.langchain.com/langsmith/tool-gateway-traces
- https://www.unite.ai/langchain-launches-langsmith-tool-gateway-to-govern-agent-tool-calls/
- https://superpowerdaily.com/posts/langchain-launches-a-gateway-to-control-which-tools-ai-agents-can-use
- https://modelcontextprotocol.io/specification/2025-03-26/basic/transports
- https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/security-considerations
- https://genai.owasp.org/llmrisk/llm062025-excessive-agency/



