Routing24 comme serveur MCP
Par Nathan ColeMis à jour le
Routing24 publie un serveur Model Context Protocol à l'adresse
https://routing24.ai/mcp. Un assistant qui prend en charge MCP liste les
outils que Routing24 propose et les appelle. Cette page couvre la façon dont
un appel est acheminé vers votre plan, les 43 outils que le serveur expose,
ce que l'application affiche pendant qu'un assistant connecté travaille, et
ce que signifie chaque échec.
Comment un appel est acheminé vers votre plan
Un appel est acheminé en trois étapes. Le travail a lieu à la dernière :
- L'assistant connecté envoie l'appel à
https://routing24.ai/mcp. - Le serveur l'achemine vers l'onglet de navigateur Routing24 où vous êtes connecté.
- L'onglet effectue le travail sur le plan qu'il a ouvert, et répond.
Trois conditions découlent de cet acheminement. La plupart des échecs de cette page proviennent de l'une d'elles :
- Vous êtes connecté à Routing24 dans un navigateur.
- Un onglet
routing24.com/appest ouvert. N'importe quelle page de l'application convient. - Vous avez approuvé la connexion une fois depuis ce navigateur. Voir Connecter Claude et ChatGPT.
Un seul navigateur à la fois sert le compte. Quand vous approuvez la connexion dans un deuxième navigateur, le premier cesse de répondre.
L'assistant dans l'application effectue le même travail avec les mêmes outils. Les deux diffèrent par ce qui les entoure :
| L'assistant dans l'application | Un assistant connecté |
|---|---|
| S'ouvre dans l'application, sans configuration | Se connecte une fois avec une URL et une approbation |
| Peut accéder au plan, pas à vos fichiers ni à d'autres systèmes | Accède aussi à vos fichiers, vos e-mails et d'autres outils |
| Importe un fichier que vous joignez, enregistre un convertisseur, passe en revue une correction d'adresse | Utilise uniquement les 43 outils |
| Consomme le budget IA du compte | Consomme le budget de son propre fournisseur |
| Fonctionne tant que le panneau est ouvert | A besoin d'un onglet de l'application ouvert, sur n'importe quelle page |
Ce que Routing24 expose
Chaque outil porte le préfixe routing24_. Le vocabulaire qu'un assistant
connecté lit est celui de l'application : créneaux horaires, capacités,
services, priorités, étiquettes, pauses, transferts, séquences,
rechargements et coûts.
Un outil marqué read ci-dessous ne fait que lire. Il ne peut pas modifier le plan, et le serveur le déclare comme tel, ce qui sert de base au regroupement des permissions par le client. Tout ce qui n'est pas marqué écrit.
Les plans et le compte
| Outil | Ce qu'il fait |
|---|---|
Get auth userreadrouting24_get_auth_user | Le compte connecté auquel appartiendra un plan enregistré |
List plansreadrouting24_list_plans | Les plans enregistrés : id, nom, horodatages, nombre d'entités et lequel est chargé |
Load planrouting24_load_plan | Charger un plan enregistré par id, en enregistrant d'abord les changements non enregistrés du plan remplacé |
New planrouting24_new_plan | Démarrer un nouveau plan vide, en remplaçant le plan chargé après avoir enregistré ses changements non enregistrés |
Saverouting24_save | Enregistrer le plan et retourner son lien |
Plan URLreadrouting24_plan_url | Le lien du plan actuel |
Lire le plan de tournées
| Outil | Ce qu'il fait |
|---|---|
Statusreadrouting24_status | La progression plus l'aperçu du plan de tournées : agrégats, coût et statistiques par tournée |
Routereadrouting24_route | Les arrêts ordonnés d'une tournée par son numéro de tournée à l'écran : ETA, charges, attentes et problèmes |
Unassignedreadrouting24_unassigned | Quelles commandes sont non affectées et pourquoi : ids, diagnostics et estimations d'insertion |
Les données du plan
| Outil | Ce qu'il fait |
|---|---|
List stopsreadrouting24_list_stops | Lire les commandes du plan, paginées et filtrables |
List vehiclesreadrouting24_list_vehicles | Lire les types de véhicules du plan |
List depotsreadrouting24_list_depots | Lire les dépôts du plan |
Geocode addressesreadrouting24_geocode_addresses | Vérifier jusqu'à 10 adresses auprès du géocodeur : si chacune se résout et l'adresse qu'il a fait correspondre, sans rien créer |
Upsert stopsrouting24_upsert_stops | Créer ou mettre à jour des commandes par id ; une ligne avec seulement un id et une adresse est la façon dont une liste d'adresses entre dans le plan |
Upsert vehiclesrouting24_upsert_vehicles | Créer ou mettre à jour des types de véhicules par id |
Upsert depotsrouting24_upsert_depots | Créer ou mettre à jour des dépôts par id |
Delete stopsrouting24_delete_stops | Supprimer des commandes par id |
Delete vehiclesrouting24_delete_vehicles | Supprimer des types de véhicules par id |
Delete depotsrouting24_delete_depots | Supprimer des dépôts : les véhicules qui y font référence sont supprimés avec eux |
La modification des tournées
| Outil | Ce qu'il fait |
|---|---|
Move stopsrouting24_edit_move_stops | Déplacer des arrêts vers une autre tournée ou une autre position, ancrés ou à la position la moins coûteuse |
Unassign stopsrouting24_edit_unassign_stops | Retirer des arrêts de leurs tournées |
Set route vehiclerouting24_edit_set_route_vehicle | Attribuer un autre véhicule à une tournée |
Create routerouting24_edit_create_route | Ajouter une tournée vide pour un véhicule |
Remove routesrouting24_edit_remove_routes | Supprimer des tournées : les arrêts encore présents deviennent non affectés dans la même modification |
Split routerouting24_edit_split_route | Scinder une tournée en deux après un arrêt |
Merge routesrouting24_edit_merge_routes | Déplacer les arrêts d'autres tournées sur une seule tournée |
Mark user assignedrouting24_edit_mark_user_assigned | Marquer des arrêts comme placés manuellement, avec un rapport de ce que cela casse |
Clear user assignedrouting24_edit_clear_user_assigned | Supprimer ce marquage et son rapport |
Undorouting24_undo | Revenir en arrière dans l'historique de modifications partagé |
Redorouting24_redo | Avancer à nouveau |
Optimisation
| Outil | Ce qu'il fait |
|---|---|
Reoptimize planrouting24_reoptimize_plan | Optimiser le plan chargé en place |
Reoptimize routerouting24_reoptimize_route | Réordonner une seule tournée, de manière synchrone |
Cancelrouting24_cancel | Interrompre une optimisation longue, en conservant le meilleur plan de tournées obtenu jusque-là |
Données et scripts
| Outil | Ce qu'il fait |
|---|---|
SQL queryreadrouting24_sql_query | Lire le plan avec SQL sur huit tables en direct, des commandes aux arrêts du plan de tournées |
SQL updaterouting24_sql_update | Mises à jour de champs en masse avec SQL, validées et appliquées de façon atomique |
Run scriptrouting24_run_script | Transformations et analyses JavaScript en bac à sable sur un brouillon du plan |
L'application et la sortie
| Outil | Ce qu'il fait |
|---|---|
Renderreadrouting24_render | Naviguer vers la page d'optimisation pour que les tournées s'affichent |
Open pagereadrouting24_open_page | Ouvrir l'une des pages de l'application |
Show on mapreadrouting24_show_on_map | Déplacer la carte vers une commande ou un dépôt |
Export Excelreadrouting24_export_excel | Télécharger le plan sous forme de classeur Excel |
Map imagereadrouting24_map_image | Capturer le plan sous forme d'image de carte Retina, repères et tracés de tournées |
Session logreadrouting24_session_log | Lire le journal d'actions d'une session d'assistant, pour les passations et les audits |
Onglets et sessions
| Outil | Ce qu'il fait |
|---|---|
List loaded plansreadrouting24_list_loaded_plans | Les onglets ouverts, le plan ouvert dans chacun et la session d'assistant qui le modifie |
Des coordonnées à la place d'une adresse
Une commande ou un dépôt a besoin d'un emplacement. Vous lui donnez normalement une adresse, et Routing24 géocode cette adresse à l'enregistrement de la ligne.
Quand vous connaissez déjà le point exact, mettez plutôt coordinates sur
la ligne, avec un lat et un lng en degrés décimaux. Routing24 place la
ligne sur ce point et n'appelle jamais le géocodeur. Ajoutez aussi une
address pour conserver votre propre texte sur la ligne. Sans cela, la
ligne affiche 25.19882, 55.27939.
Une adresse écrite sous forme de deux nombres décimaux fait la même chose.
Envoyez 25.19882, 55.27939 comme adresse et la ligne se place sur ce
point.
Les deux formes fonctionnent sur routing24_upsert_stops et
routing24_upsert_depots, et permettent toutes deux de traiter un lot entier. Une
liste de points dont vous disposez déjà peut être transmise en un seul appel,
sans risque d'erreur de géocodage.
Les coordonnées sont uniquement une entrée. Aucun outil ne les renvoie.
Quel plan un appel cible
Un navigateur peut avoir plusieurs plans ouverts, un par onglet. Deux entrées déterminent quel plan un appel cible.
plan_id identifie le plan sur lequel l'appel doit opérer. Ce plan doit
déjà être ouvert dans un onglet. Quand aucun onglet ne l'a ouvert, l'appel
échoue et nomme les plans ouverts.
session_id identifie la session de modification propre à un assistant
connecté. Routing24 en crée une lors du premier changement de l'assistant
sur un plan et la retourne dans le résultat. Un assistant qui joint cet identifiant
à chaque appel ultérieur continue de travailler sur le même plan, même quand vous passez
à un autre onglet. Les appels en lecture seule ne créent jamais de session.
routing24_list_loaded_plans indique les onglets ouverts, le plan ouvert
dans chacun, si l'onglet est vide, actif ou visible, et la session
d'assistant qui le modifie. Deux assistants travaillant sur deux plans
l'utilisent pour maintenir leurs appels sur leurs propres plans.
Sans aucune de ces deux entrées, l'appel opère sur le plan de la session propre de l'appelant. Sans session, il opère sur le plan de l'onglet actif, puis d'un onglet visible, puis de l'onglet vu le plus récemment. L'onglet actif change chaque fois que vous cliquez sur un autre.
Ce que vous voyez pendant qu'un assistant connecté travaille
- Le badge d'en-tête. Sur les pages liées au plan, un badge vert
affiche le nom du client et le temps écoulé depuis son dernier appel,
par exemple
Claude (now)ouChatGPT (3 min ago). Son infobulle montre le dernier outil par son nom technique : "Dernière action de Claude : routing24_reoptimize_plan. Cliquez pour le journal de session." Le badge disparaît cinq minutes après le dernier appel. Appuyez dessus pour ouvrir le panneau de l'assistant sur le journal. - Le journal de session. Le panneau de l'assistant liste chaque
session sous un titre
Session a1b2c3d4 (Claude), puis une ligne par appel avec l'heure, l'action en langage clair et l'indication d'un éventuel échec. Les lignes de cycle de vie indiquent "a démarré cette session", "a pris le contrôle de cette session" et "a repris dans un autre onglet". - La barre de déconnexion. Sous la zone de message, une barre indique "Claude est connecté à votre compte" avec un bouton Déconnecter. Voir Connecter Claude et ChatGPT.
- Le verrouillage. Une modification place l'application derrière une superposition plein écran intitulée Contrôlé par l'agent, indiquant "Un agent IA modifie ce plan. L'écran est verrouillé pendant qu'il travaille ; chaque changement s'inscrit dans l'historique d'annulation partagé.", avec un compteur des changements appliqués jusque-là. Appuyez sur Prendre la main pour récupérer l'application à tout moment.
- Le panneau. Pendant qu'un assistant connecté travaille, la zone de message est remplacée par "Claude travaille sur ce plan" et un bouton Prendre la main.
Les suppressions et les changements de champs en masse d'un assistant connecté s'appliquent sans passage en revue. Les boîtes de dialogue de validation appartiennent à l'assistant dans l'application.
Édition partagée
Les modifications de l'assistant connecté et les vôtres partagent un même historique d'annulation. Continuez manuellement exactement là où l'assistant s'est arrêté. Voir Interroger, modifier et exporter un plan avec l'IA.
Quand le plan a changé depuis la dernière lecture de l'assistant connecté, Routing24 rejette la modification suivante de cet assistant. Rien n'est écrit. Le rejet inclut la révision actuelle du plan et le dernier éditeur. L'assistant relit le plan, et le même appel réussit à la nouvelle tentative. L'application n'affiche rien pendant ce temps.
Ce que signifient les erreurs
Un assistant connecté signale ces erreurs dans sa propre transcription.
| Ce que l'assistant signale | Ce qui s'est passé |
|---|---|
| Aucun onglet de navigateur Routing24 n'est connecté | Aucun navigateur avec session ouverte n'est attaché. Ouvrez l'application et connectez-vous |
| Aucun onglet de l'application Routing24 n'est ouvert | Le navigateur est attaché, mais aucun onglet de l'application n'est ouvert. Ouvrez routing24.com/app |
| L'onglet s'est fermé pendant l'exécution d'un outil | L'onglet s'est fermé en cours d'appel. Le changement peut avoir été appliqué ou non |
| L'onglet n'a pas répondu dans les 60 s | Un outil a dépassé la limite de 60 secondes. Une optimisation en cours continue dans l'onglet |
| Un autre onglet a pris le relais pendant cet appel | Un deuxième navigateur s'est attaché et a remplacé le premier |
| L'état du plan a divergé | Le plan a changé depuis la dernière lecture de l'assistant. Il relit et réessaie |
Une optimisation longue dépasse toujours la limite de 60 secondes.
L'optimisation continue de s'exécuter dans l'onglet. L'assistant interroge
routing24_status pour obtenir le résultat au lieu de répéter l'appel.
Limites
- Huit appels en cours à la fois par session.
- 120 requêtes par minute et par compte.
- 60 secondes par appel.
- Une image de carte d'environ 600 Ko.
- Un onglet visible pour une image de carte. Une fenêtre masquée cesse de dessiner, donc la capture expire.
- Un navigateur attaché par compte. Un assistant connecté travaille via ce navigateur et nulle part ailleurs : Routing24 n'exécute rien de son propre chef quand tous les onglets sont fermés.
Où le travail s'exécute
L'optimisation s'exécute dans votre onglet de navigateur. Le géocodage et les matrices de distances s'exécutent sur les serveurs de Routing24 sous votre propre session. Le point de terminaison MCP est le seul serveur Routing24 auquel un assistant connecté accède, avec un jeton créé quand vous approuvez la connexion. Confidentialité et traitement des données indique ce que chacun de ces appels envoie et qui reçoit les données qu'un assistant connecté lit.
Ce que cela coûte
La connexion d'un assistant est disponible sur toutes les offres. Un assistant connecté consomme le budget de son propre fournisseur plutôt que le budget IA du compte. Une optimisation qu'il démarre consomme la même allocation que le bouton Optimiser. Voir Décrire des contraintes en langage courant et Offres et facturation.
L'API d'optimisation est un produit Pro distinct pour l'intégration de système à système, mis en place avec l'équipe. Voir Intégrations.
Étape suivante
Les outils d'écriture définissent les mêmes champs que vous définissez manuellement. Ajouter des véhicules et des dépôts ouvre la référence expliquant la signification de ces champs.
FAQ
De quoi ai-je besoin pour qu'un assistant connecté fonctionne ?
Un assistant connecté a besoin de trois choses : vous êtes connecté à Routing24 dans un navigateur, un onglet routing24.com/app est ouvert sur n'importe quelle page de l'application, et vous avez approuvé la connexion une fois depuis ce navigateur. Un seul navigateur à la fois sert le compte ; approuver la connexion dans un deuxième navigateur empêche le premier de répondre.
Où s'exécute réellement le travail d'un assistant connecté ?
L'appel est acheminé vers l'onglet de navigateur où vous êtes connecté, et l'onglet effectue le travail sur le plan qu'il a ouvert. L'optimisation s'exécute dans le navigateur. Le géocodage et les matrices de distances s'exécutent sur les serveurs de Routing24 sous votre propre session. Le point de terminaison MCP est le seul serveur Routing24 auquel un assistant connecté accède.
En quoi un assistant connecté diffère-t-il de l'assistant dans l'application ?
Les deux effectuent le même travail avec les mêmes outils. L'assistant dans l'application s'ouvre sans configuration, peut accéder au plan mais pas à vos fichiers ni à d'autres systèmes, et consomme le budget IA du compte. Un assistant connecté se connecte une fois avec une URL et une approbation, accède aussi à vos fichiers et à d'autres outils, et consomme le budget de son propre fournisseur.
Puis-je arrêter un assistant connecté pendant qu'il modifie ?
Oui. Une modification place l'application derrière une superposition plein écran intitulée Agent controlled, avec un compteur des changements appliqués jusque-là. Appuyez sur Prendre la main pour récupérer l'application à tout moment. Chaque changement s'inscrit dans l'historique d'annulation partagé, vous pouvez donc continuer manuellement exactement là où l'assistant s'est arrêté.
Pourquoi une optimisation longue expire-t-elle pour un assistant connecté ?
Chaque appel a une limite de 60 secondes, et une optimisation longue la dépasse toujours. L'optimisation continue de s'exécuter dans l'onglet ; seul l'appel se termine. L'assistant interroge l'outil de statut pour obtenir le résultat au lieu de répéter l'appel et lit le plan de tournées quand l'exécution se termine.