Créer un agent de répartition IA pour les opérations de terrain avec Claude + Crisphive MCP

Ce que c'est : un tutoriel étape par étape qui connecte Claude à un planning d'opérations de terrain (en environnement de test), réservez une intervention en langage naturel, absorbe une urgence P0 avec une reprogrammation complète en cascade et se termine par une liste de contrôle de sécurisation pour la mise en production. Durée : environ 15 minutes. Coût : zéro — le bac à sable est gratuit, sans carte de crédit, et les appels MCP ne sont jamais facturés.

À la fin, vous disposerez d'un assistant capable de faire ceci :

Vous : Intervention de plomberie urgente maintenant au 99 rue Bank pour David Okafor (613-555-0198) — montrez-moi ce qui est reprogrammé.

Claude : appelle les outils de répartition et renvoie un plan — l'urgence est calée à 13h15, deux interventions sont déplacées avec de nouvelles heures d'arrivée estimées, un SLA est identifié comme tendu, rien n'est encore validé. Vous approuvez ?

Ce qu'il faut retenir de cet échange, c'est ce que Claude n'a pas fait : il n'a pas inventé le plan. Claude interprète la demande ; le solveur de contraintes déterministe de Crisphive calcule le planning — temps de trajet, compétences, certifications, pauses protégées et SLA pris en compte comme contraintes strictes — et le renvoie pour validation. Même requête, même planning, à chaque fois. Cette répartition des rôles constitue l'architecture même de ce tutoriel. Un schéma vaut donc mieux qu'un long discours avant de commencer :

Vous (en langage naturel)
→ Claude (interprète l'intention, choisit les outils)
→ Serveur MCP Crisphive — https://api.crisphive.com/mcp (43 outils)
→ API REST → solveur de contraintes déterministe
← plan à examiner (interventions déplacées, nouvelles heures d'arrivée, impact SLA)
← Claude explique le plan et les arbitrages
Vous approuvez → le planning est validé

Ce dont vous avez besoin

• Un compte Claude — claude.ai, Claude Desktop ou Claude Code fonctionnent tous ; le support des connecteurs dépend de votre forfait.

• Si vous gérez une entreprise d'opérations de terrain sur Crisphive : rien d'autre — vous vous connecterez via OAuth en tant que propriétaire de l'entreprise.

• Si vous êtes développeur sans entreprise Crisphive : une clé de bac à sable gratuite. Inscrivez-vous sur la page développeurs et récupérez une clé chsk_test_ — un environnement de test isolé basé sur la même URL racine. Pas de carte de crédit, pas d'appel commercial.

Rien ne s'installe ni ne s'exécute localement dans les deux cas. Le serveur MCP est hébergé à distance via Streamable HTTP.

Étape 1 — Connecter Claude à Crisphive

Option A — Opérateurs (OAuth, un seul clic)

Ouvrez la fiche Crisphive dans le répertoire des connecteurs Claude et cliquez sur Connecter. Il vous sera demandé de vous connecter en tant que propriétaire de l'entreprise Crisphive et d'approuver la connexion. C'est tout ce qu'il y a à faire.

Vous préférez le faire manuellement ? Dans claude.ai ou Claude Desktop : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, collez https://api.crisphive.com/mcp et finalisez la connexion OAuth lorsque l'écran de consentement s'ouvre.

Option B — Développeurs (Claude Code + clé de bac à sable)

claude mcp add --transport http crisphive https://api.crisphive.com/mcp

Pour rattacher la session à votre bac à sable isolé au lieu d'une entreprise réelle, ajoutez votre clé de test :

claude mcp add --transport http crisphive https://api.crisphive.com/mcp --header "Authorization: Bearer chsk_test_VOTRE_CLE"

Les autres clients MCP — Cursor, VS Code, Windsurf, Cline, Zed, LM Studio, Gemini CLI — utilisent la même URL ; le tableau complet des clients se trouve dans le README GitHub. Les clients qui n'acceptent que stdio peuvent utiliser la passerelle mcp-remote.

Point de vérification : demandez à Claude « Quels outils Crisphive possèdes-tu ? » — vous devriez voir 43 outils répartis en huit groupes : réservation d'interventions et rendez-vous, suivi des bons d'intervention, répartition et disponibilité, synchronisation client (CRM), catalogues de services, équipes et plannings, zones d'intervention et flotte.

Étape 2 — Découvrir le planning

Commencez par les trois consignes de la fiche du répertoire — ce sont les trois mêmes consignes utilisées partout dans la documentation Crisphive pour ce connecteur.

Essayez d'abord celles-ci :

1. Planifie une intervention HVAC de 2 heures au 145 avenue Laurier Ouest demain pour Marie Tremblay, 613-555-0142.

2. Intervention de plomberie urgente maintenant au 99 rue Bank pour David Okafor (613-555-0198) — montre-moi ce qui est reprogrammé.

3. Fais le résumé de ma journée de demain et signale tout risque potentiel.

Exécutez d'abord la consigne 3 — elle est en lecture seule, ce qui permet de confirmer sereinement la connexion de bout en bout.

Résultat attendu : Claude appelle les outils de répartition, de disponibilité et de bons d'intervention, puis restitue la journée de demain sous forme de chronologie ordonnée — trajets entre les interventions, marge pour chaque travail et signalement des risques (fenêtres de trajet serrées, interventions susceptibles de déborder). Rien ne bouge sur le tableau de bord ; les requêtes en lecture ne modifient jamais les données.

Étape 3 — Réserver une intervention en langage naturel

Passez maintenant à la consigne 1 :

Planifie une intervention HVAC de 2 heures au 145 avenue Laurier Ouest demain pour Marie Tremblay, 613-555-0142.

Ce qui se déclenche : réservation d'interventions et rendez-vous, synchronisation client (pour attribuer la réservation au bon compte) et répartition et disponibilité (qui est réellement disponible).

Résultat attendu : une intervention réservée avec la justification du choix — quel technicien, pourquoi celui-ci (compétences, certification, proximité, tournée existante) et le créneau exact. Si vous souhaitez pousser le moteur de contraintes dans ses retranchements, précisez la demande :

Même intervention, mais uniquement un technicien certifié en installation gaz, et sans ajouter plus de 20 minutes de trajet à la journée de quiconque.

Le solveur traite ces demandes comme des contraintes strictes, pas comme de simples suggestions. Si personne ne remplit les critères, vous obtenez une réponse honnête indiquant qu'aucun créneau n'est réalisable en précisant la contrainte bloquante — et non une estimation au hasard.

Étape 4 — Gérer une urgence P0 (la reprogrammation en cascade)

C'est l'étape qui distingue un agent de répartition d'un simple chatbot relié à un agenda. Une fuite d'eau importante ne demande pas l'heure qui vous arrange — comment reprogrammer automatiquement les interventions des techniciens en cours de journée lorsqu'une urgence survient ?

Intervention de plomberie urgente maintenant au 99 rue Bank pour David Okafor (613-555-0198) — montre-moi ce qui est reprogrammé.

Ce qui se déclenche : les outils de répartition et disponibilité, de réservation d'interventions et de bons d'intervention — et le solveur lance une reprogrammation en cascade : il replanifie chaque intervention impactée en aval, en conservant les temps de trajet, la mobilisation, l'approvisionnement en matériel, les pauses protégées et les fenêtres SLA comme contraintes strictes. Une cascade complète est calculée en moins de 3 secondes — mesuré sur une simulation de flotte de 3 véhicules sur 20 sites avec ces contraintes actives.

Résultat attendu — et c'est un point capital — un plan, pas une modification directe. Claude présente le double plan : l'insertion de l'urgence, chaque intervention déplacée, les nouvelles heures d'arrivée estimées et l'impact global sur les SLA. Rien n'est validé tant que vous ne l'approuvez pas. Chaque flux de modification sur ce serveur fonctionne par paires aperçu/validation par conception ; un agent capable de réorganiser en arrière-plan un tableau de répartition réel n'est pas une fonctionnalité, c'est un incident en puissance.

Approuvez-le, puis demandez :

Pourquoi l'intervention chauffe-eau de 14h a-t-elle été déplacée alors que l'inspection de 15h n'a pas bougé ?

Claude vous l'explique à partir des résultats réels du solveur — la contrainte bloquante, la marge existante — parce que le plan provient du solveur, et non de l'imagination du modèle.

Étape 5 — Personnalisez l'usage

Voici trois orientations pour faire évoluer l'agent de base, chacune accessible en une consigne :

• Recherche de disponibilité : « Trouve une fenêtre de 3 heures dans ma semaine de travail pour aller faire du vélo avec ma femme sans mettre aucune intervention en danger. » — classe les créneaux libres selon la marge disponible ; rien ne bouge.

• Correspondance compétences et déplacements : « Lesquels de mes techniciens certifiés gaz sont libres jeudi matin à moins de 20 minutes de Kanata ? »

• Point de situation pour le dirigeant : « Donne-moi un résumé clair de la journée de demain pour toutes mes équipes — où sont les risques et sommes-nous en surcapacité quelque part ? »

Les 43 mêmes outils servent un répartiteur, un développeur et un dirigeant — seule la façon de poser la question change. La page MCP pour Claude propose une bibliothèque de consignes prête à copier pour ces trois profils.

Vous souhaitez intégrer cela dans votre logiciel au lieu d'une fenêtre de discussion ? Le même moteur est accessible via une API REST — commencez par consulter docs.crisphive.com, ou lisez le comparatif des parcours d'intégration pour déterminer quand privilégier le MCP ou l'API directe.

Étape 6 — Liste de contrôle pour la mise en production

Avant de sortir du bac à sable :

1. Les clés expirent — la durée par défaut est de 30 jours, et l'e-mail d'expiration est envoyé au propriétaire de l'entreprise, pas nécessairement à vous. Pour les agents en production, générez des clés valables 365 jours et appliquez une rotation à deux clés : créez la clé B, déployez, vérifiez le trafic sur B, puis révoquez la clé A. Un agent d'agence qui cesse de fonctionner avec l'erreur API_KEY_EXPIRED un mois après le lancement entraîne un départ client, pas un simple signalement de bug.

2. Privilégiez OAuth pour les utilisateurs humains et les clés pour les services. Les jetons OAuth peuvent être révoqués des deux côtés — depuis les paramètres de connecteur Claude ou depuis le compte Crisphive — et aucune clé ne circule jamais dans une fenêtre de discussion.

3. Conservez le mode aperçu/validation. Ne cédez pas à la tentation d'approuver automatiquement les cascades « pour économiser un clic » — l'étape d'approbation est précisément ce qui rend l'agent auditable pour le répartiteur qui reprend la main le lendemain.

4. Vérification du périmètre d'accès : le connecteur ne voit que les données de planification — interventions, bons d'intervention, clients, équipes, catalogues, zones géographiques, flotte. Les données de facturation et de paiement ne lui sont pas exposées. Assurez-vous qu'il en va de même pour tout ce que vous développez en aval.

5. Testez d'abord les scénarios d'erreur dans le bac à sable : une intervention irréalisable (aucun technicien qualifié), une cascade qui enfreint un SLA, un jeton révoqué en cours de session. La gestion des erreurs par votre agent est ce que vos utilisateurs retiendront.

Foire aux questions

Faut-il disposer d'une entreprise Crisphive pour essayer ?

Non — le bac à sable gratuit chsk_test_ est un environnement de test isolé sur la même URL racine, sans carte de crédit requise. La connexion OAuth sert à relier une entreprise réelle en tant que propriétaire.

Est-ce Claude qui réalise la planification ?

Non — et c'est tout l'intérêt. Claude interprète ce que vous demandez ; chaque réservation, cascade et reprogrammation est calculée par le solveur de contraintes déterministe de Crisphive. Posez deux fois la même question, vous obtiendrez deux fois le même plan.

L'agent peut-il modifier mon planning réel à mon insu ?

Non. Tout changement affectant l'existant est d'abord restitué sous forme de plan à vérifier — interventions déplacées, nouvelles heures d'arrivée, impact SLA — et n'est validé qu'après votre approbation.

Le serveur MCP génère-t-il un coût supplémentaire ?

Non. L'accès MCP est inclus dans tous les forfaits entreprise ainsi que dans le bac à sable développeur gratuit — les appels MCP, cascades, reprogrammations et lectures ne sont jamais facturés ; seule la comptabilisation des interventions réelles est facturée.

Quels autres clients que Claude sont compatibles ?

Tout client prenant en charge les serveurs MCP distants via Streamable HTTP — ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, Cline, Zed et LM Studio, entre autres. Les clients limités à stdio peuvent utiliser la passerelle mcp-remote.

Vous gérez des équipes sur le terrain et souhaitez découvrir ce que ce moteur aurait produit sur votre planning de mardi dernier ? Réservez un audit gratuit de votre planning (Shadow Schedule Audit) — envoyez une journée récente d'interventions et recevez sous 48 heures l'analyse des heures de conduite et de la capacité détectées.