Serveur MCP pour les devis de fret et le suivi des envois
Dans cet article
Ce que fait un serveur MCP pour la logistique
Un serveur MCP pour le fret expose la tarification et le suivi sous forme d’outils typés, afin qu’un assistant puisse demander directement un devis ou le statut d’un envoi au lieu qu’une personne ouvre un portail tarifaire. MCP, le Model Context Protocol, est la couche d’interface : il définit comment un client comme Claude, ChatGPT, Codex, Cursor ou VS Code découvre les outils proposés par un serveur, les arguments que chacun accepte et la forme de la réponse renvoyée. En logistique, cela transforme deux corvées récurrentes, « combien ça va coûter » et « où en est-il », en appels de fonction.
La suite de cet article présente ce qu’on peut attendre de chaque type d’outil, comment la tarification diffère selon le mode de transport et comment connecter un serveur opérationnel. Les exemples utilisent le connecteur public JTLGO Commerce MCP, qui chiffre des itinéraires au départ de la Chine et suit les envois.
Les outils qu’un serveur MCP de fret doit exposer
Un serveur utile est compact. Quatre à six outils bien spécifiés valent mieux que vingt outils flous, car le client doit choisir entre eux à partir de leur seule description.
Faites défiler horizontalement ou utilisez les flèches pour voir toutes les colonnes.
| Outil | À utiliser pour | Entrée type | Renvoie |
|---|---|---|---|
| quote_shipping_rates | Estimation d’itinéraire et de coût | poids, pays de destination, longueur, largeur, hauteur, type de marchandise | Options d’itinéraire avec poids taxable et délai de transit estimé |
| track_shipment | Statut d’un colis ou d’une commande | un numéro de suivi ou une liste | Derniers événements de l’historique et indication d’anomalie |
| search_products | Trouver ce qui sera expédié | mot-clé, plateforme, limite | Articles candidats avec leurs identifiants |
| get_product_detail | Confirmer un article avant de chiffrer | identifiant produit ou URL | Champs de spécification, dont le poids lorsqu’il est publié |
| human_handoff | Escalader quand la confiance est faible | langue, motif | Un canal d’assistance qu’une personne peut reprendre |
| get_mcp_config | Vérifier la connexion | aucune | Métadonnées du connecteur et liste des outils |
Les deux derniers comptent plus qu’il n’y paraît. Un outil de configuration permet de prouver que le connecteur est joignable sans consommer une requête de tarif, et un outil de transfert explicite donne à l’assistant un recours quand la réponse est réellement incertaine, au lieu d’inventer un chiffre.
La tarification diffère selon le mode, et les entrées aussi
Les acheteurs recherchent « MCP server for LTL quote » et « MCP server for FTL quote » comme si la tarification était un seul et même problème, un peu comme ils traitent la pile de protocoles pour agents comme un tout. Ce n’est pas le cas. Le mode détermine les entrées qu’un outil de devis doit exiger, et un outil qui en accepte trop peu produit des absurdités avec aplomb.
Faites défiler horizontalement ou utilisez les flèches pour voir toutes les colonnes.
| Mode | Ce qui détermine le prix | Entrées qu’un outil de devis doit exiger |
|---|---|---|
| Colis et express | Le plus élevé du poids réel et du poids volumétrique | Poids, les trois dimensions, destination, type de marchandise |
| LTL, groupage routier | Classe de fret ou densité, plus prestations annexes | Nombre de palettes, dimensions, classe ou densité, prestations annexes à l’enlèvement et à la livraison |
| FTL, camion complet | Trajet, type d’équipement et date | Points d’origine et de destination, type de remorque, date d’enlèvement |
| Fret aérien | Poids taxable selon un diviseur volumétrique | Poids brut, dimensions, couple d’aéroports, restrictions sur la marchandise |
| Maritime, LCL et FCL | Mètres cubes, ou nombre et type de conteneurs | Volume ou type de conteneur, couple de ports, incoterm |
Deux conséquences pratiques. D’abord, tout outil de devis qui accepte un poids sans dimensions devine, puisque pour presque tous les modes le chiffre facturé est volumétrique. Ensuite, la tarification LTL et FTL intérieure dans un pays de destination repose sur une autre source de données que la tarification à l’export international ; un serveur qui fait l’une ne fait pas automatiquement l’autre. Vérifiez à laquelle vous vous connectez avant de bâtir un processus dessus.
Le connecteur JTLGO chiffre des itinéraires au départ de la Chine, c’est-à-dire des options express, aériennes et maritimes depuis la Chine, avec un poids taxable calculé à partir des dimensions que vous fournissez. Il ne tarife pas les transports routiers intérieurs dans le pays de destination. Le même moteur de tarification est accessible aux utilisateurs via Rate and Ship, et le même historique via le suivi des envois. C’est un périmètre délibéré, et mieux vaut le connaître d’emblée que le découvrir au milieu d’une boucle d’agent.
Connecter un serveur
Un serveur MCP hébergé, c’est une URL. La plupart des clients n’ont besoin de rien d’autre, et le transport est du JSON-RPC sur HTTP POST.
{
"mcpServers": {
"jtlgo": {
"url": "https://jtlgo.com/api/mcp"
}
}
}
Pour vérifier la connexion à la main avant de l’intégrer à un client, envoyez un appel d’initialisation, puis listez les outils. Le point de terminaison exige POST et un en-tête Accept mentionnant à la fois JSON et le type event-stream ; une simple requête GET est volontairement rejetée.
curl -X POST https://jtlgo.com/api/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Un appel de devis ressemble à n’importe quelle autre invocation d’outil. Fournissez les dimensions, pas seulement le poids.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "quote_shipping_rates",
"arguments": {
"weight": 12,
"countryCode": "US",
"length": 40,
"width": 30,
"height": 25,
"goodsType": "general"
}
}
}
Accès public et accès au compte
Les connecteurs de fret ont généralement besoin de deux niveaux, et les confondre est l’erreur d’intégration la plus courante. Les outils ouverts comme la tarification et le suivi public ne demandent aucune connexion, car il n’y a rien de propre à un compte à protéger. Tout ce qui lit les commandes, les dossiers ou l’historique d’assistance d’un client en demande une, et c’est là qu’OAuth a sa place.
JTLGO propose cela sous la forme de deux URL pour un même serveur : https://jtlgo.com/api/mcp pour les six outils publics, et https://jtlgo.com/api/mcp/account pour ces six outils plus quatre outils liés au compte, le client ne lançant un flux OAuth que lorsque des données de compte sont réellement demandées. Choisissez l’URL de compte quand l’assistant doit répondre à des questions sur les envois d’un client précis, et l’URL publique dans le cas contraire. Configurer les deux n’apporte rien.
Ce qu’il faut vérifier avant de se fier à un connecteur de fret
- Un appel d’outil atteint-il réellement le système amont ? Un serveur qui répond à
tools/listne fonctionne pas forcément. Les appels de liste sont généralement servis à partir d’un schéma statique. Appelez un vrai outil. - L’outil de devis exige-t-il les dimensions ? S’il accepte le poids seul, son résultat sera faux pour tout ce qui est léger et volumineux, c’est-à-dire la plupart des biens de consommation.
- Le suivi distingue-t-il « pas encore de données » de « introuvable » ? Ces deux réponses n’ont pas le même sens pour un client, et un connecteur qui les confond poussera un assistant à rassurer à tort, avec aplomb.
- Existe-t-il un chemin d’escalade explicite ? Les moteurs de tarification ne renvoient rien pour les marchandises soumises à restriction et les trajets inhabituels. Le bon comportement est de transférer, pas d’extrapoler.
- Le périmètre est-il clairement indiqué ? Régions d’origine, modes couverts, et inclusion ou non de la tarification routière intérieure.
Questions fréquentes
Qu’est-ce qu’un serveur MCP pour le fret ?
Un service qui expose la tarification du fret et le suivi des envois sous forme d’outils appelables via le Model Context Protocol, afin qu’un assistant IA puisse demander directement un devis ou un statut au lieu qu’une personne utilise un portail tarifaire.
Un serveur MCP peut-il chiffrer des tarifs LTL et FTL ?
Oui, s’il est relié à un moteur de tarification de transporteur pour ces modes et qu’il exige les bonnes entrées : nombre de palettes, dimensions et classe de fret pour le LTL ; trajet, type d’équipement et date d’enlèvement pour le FTL. De nombreux connecteurs logistiques, dont celui de JTLGO, couvrent les modes d’export international plutôt que le transport routier intérieur ; vérifiez donc le périmètre avant de vous y fier.
Faut-il une clé API pour utiliser un serveur MCP logistique ?
Pour la tarification et le suivi publics, généralement non. Pour tout ce qui lit le compte d’un client précis, oui, et cela doit passer par un flux OAuth lancé par le client plutôt que par une clé collée dans un fichier de configuration.
Quels clients MCP peuvent l’utiliser ?
Tout client qui prend en charge les serveurs HTTP hébergés, ce qui inclut actuellement Claude, ChatGPT, Codex, Cursor et VS Code. Le connecteur est une URL ; le client gère le transport.
Pourquoi le point de terminaison rejette-t-il les requêtes GET ?
Parce que le transport HTTP de MCP, c’est du JSON-RPC sur POST. Un GET renvoyant des métadonnées constituerait une seconde interface non documentée ; il est donc refusé avec un code 405 plutôt que pris en charge de manière informelle.
Sources et références
- Model Context Protocol specification Model Context Protocol
- JTLGO Commerce MCP connector JTL Global