Tous les articles

Combien d'outils MCP exposer avant que l'agent décroche

Le nombre d'outils exposés décide de la qualité perçue de ton serveur MCP. Les paliers observables, les trois leviers pour réduire, et ce qu'il ne faut jamais fusionner.


Personne ne parle de ça, et c'est pourtant ce qui décide de la qualité perçue de ton serveur.

Un serveur MCP n'est pas jugé sur ce qu'il permet de faire. Il est jugé sur la fréquence à laquelle l'agent choisit le bon outil du premier coup. Et ce taux s'effondre bien avant que tu aies fini d'exposer ton API.

Pourquoi le nombre compte

Le modèle voit ta liste d'outils avec leurs noms et leurs descriptions, et il doit choisir. Trois choses se dégradent quand la liste s'allonge.

La confusion entre outils proches. get_user, get_user_profile, fetch_user_details : un humain devine, un modèle tire au sort. Et il tire au sort de manière non déterministe, donc ton bug n'est pas reproductible.

Le coût de contexte. Chaque outil consomme de la place, et cette place n'est plus disponible pour la conversation.

Le partage de l'attention. Ton serveur est rarement seul. L'utilisateur en a trois ou quatre connectés. Tes quarante outils entrent en concurrence avec ceux des autres.

Ce dernier point est celui qu'on oublie. Tu ne dimensionnes pas pour ton serveur seul, tu dimensionnes pour un contexte partagé.

L'ordre de grandeur

Il n'y a pas de seuil magique, mais il y a des paliers observables.

En dessous de dix outils bien nommés, la sélection est fiable. Entre dix et vingt, ça tient si les noms sont nets et les périmètres disjoints. Au-delà de trente, la sélection devient le principal facteur d'échec de ton produit, quelle que soit la qualité de ton code.

Un serveur avec douze outils clairs bat un serveur avec quarante outils exhaustifs. C'est contre-intuitif pour une équipe qui a passé trois ans à construire une API complète.

Les trois leviers pour réduire

Regrouper par intention, pas par endpoint. Ton API a create_draft, update_draft, publish_draft. Un agent pense en termes de « publier ce truc ». Souvent, un outil avec un paramètre d'état vaut mieux que trois outils.

Absorber la variation dans les paramètres. search_by_name, search_by_tag, search_by_date sont un seul outil search avec des filtres optionnels. Le modèle est bien meilleur pour remplir un paramètre que pour choisir entre trois outils voisins.

Retirer ce que personne n'appelle. Instrumente les appels par outil, ce que les en-têtes Mcp-Name rendent trivial. Un outil jamais appelé en trois mois n'est pas neutre : il occupe de la place et il ajoute une possibilité d'erreur.

Ce qu'il ne faut pas fusionner

La réduction a une limite, et elle est nette.

Ne fusionne jamais lecture et écriture. Un outil qui lit ou modifie selon un paramètre ne peut pas être annoté correctement, donc le client ne peut pas demander de confirmation avant une action destructrice. Tu viens de supprimer le seul point où un humain pouvait dire non.

Ne fusionne pas des niveaux de risque différents. Supprimer un élément et supprimer tout le compte ne sont pas le même outil avec un drapeau.

Ne fusionne pas au prix d'un paramètre incompréhensible. Si le modèle doit deviner un mode parmi sept, tu as déplacé le problème sans le résoudre.

Le test qui mesure vraiment

Prends vingt formulations naturelles de choses que tes utilisateurs veulent faire. Pas ton vocabulaire, le leur.

Pour chacune, lance la demande dans un client réel, avec au moins deux autres serveurs connectés à côté du tien, et note simplement : le bon outil a-t-il été choisi du premier coup.

Un taux en dessous de 90 % est un problème produit, pas un accident. Et le détail des échecs te dit exactement quels outils se ressemblent trop.

Refais ce test à chaque ajout d'outil. C'est la seule façon de voir la dégradation avant tes utilisateurs.

FAQ

Faut-il exposer toute mon API ?

Non, et c'est la décision la plus importante de la conception. Ton API sert des développeurs qui lisent une doc. Ton serveur MCP sert un modèle qui choisit vite.

Et si mes utilisateurs ont besoin de cas rares ?

Un outil générique bien borné couvre souvent la longue traîne mieux que vingt outils spécifiques.

Les listes cachables changent-elles quelque chose ?

Elles réduisent le trafic, pas la confusion. Le coût de sélection reste entier.

Faire concevoir le périmètre de tes outils

C'est la partie la plus structurante d'une construction de serveur, et celle qu'on rate le plus souvent. Construction complète de 4 500 à 7 500 € selon le périmètre. Sur un serveur existant, l'audit chiffre la refonte de la surface d'outils.

Intéressé ? Parler de mon serveur MCP →

Lectures liées

Un serveur MCP à faire auditer ?

Cinq minutes pour le décrire. Je réponds sous 24 heures ouvrées avec un premier diagnostic écrit et gratuit.

Faire auditer mon serveur MCP
Combien d'outils MCP exposer avant que l'agent décroche