Créer un agent d'attribution pour les opérations de terrain avec Claude + Crisphive MCP

Ce dont il s'agit : un tutoriel étape par étape qui connecte Claude à un planning d'opérations de terrain réel (en environnement sandbox), planifie une intervention en langage naturel, absorbe une urgence P0 avec un replanning complet 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 : gratuit — la sandbox est gratuite, sans carte bancaire, et les appels MCP ne sont jamais facturés.

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

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

Claude : appelle les outils d'attribution 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, mais rien n'est encore validé. Approuver ?

Ce qui importe dans 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 déterministe sous contraintes de Crisphive calcule le planning — temps de trajet, compétences, certifications, pauses réglementaires et SLA étant gérés comme des contraintes strictes — et le renvoie pour approbation. Mêmes entrées, même planning, à chaque fois. Cette séparation des rôles constitue toute l'architecture de ce tutoriel. Un schéma résume la démarche avant de commencer :

Vous (langage naturel)
→ Claude (interprète l'intention, choisit les outils)
→ Serveur MCP Crisphive — https://api.crisphive.com/mcp (43 outils)
→ API REST → solveur déterministe sous contraintes
← plan à valider (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 ; la prise en charge du connecteur dépend de votre abonnement.

• 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 compte entreprise Crisphive : une clé sandbox gratuite. Inscrivez-vous sur la page développeurs et récupérez une clé chsk_test_ — un environnement de test isolé sur la même URL de base. Sans carte bancaire ni appel commercial.

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

Étape 1 — Connecter Claude à Crisphive

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

Ouvrez la fiche Crisphive dans le répertoire de connecteurs Claude et cliquez sur Connecter. Vous serez invité à vous connecter en tant que propriétaire du compte Crisphive et à approuver la connexion. C'est tout pour la configuration.

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, puis validez la connexion OAuth lorsque l'écran de consentement s'affiche.

Option B — Développeurs (Claude Code + Clé Sandbox)

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

Pour rattacher la session à votre sandbox isolée plutôt qu'à une entreprise en production, 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 ; la liste complète des clients se trouve dans le README GitHub. Les clients qui ne gèrent que le stdio peuvent utiliser le pont mcp-remote.

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

Étape 2 — Interroger le planning

Commencez avec les trois requêtes recommandées sur la fiche du répertoire — ce sont les trois mêmes consignes utilisées dans toute la documentation Crisphive.

Essayez d'abord ceci :

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

2. Urgence plomberie maintenant au 99 rue Bank pour David Okafor (613-555-0198) — montrez-moi ce qui est replanifié.

3. Présente le déroulement de ma journée de demain et signale tout ce qui présente un risque.

Lancez d'abord la requête 3 — c'est une lecture seule, ce qui permet de valider la connexion de bout en bout en toute sécurité.

Résultat attendu : Claude fait appel aux outils d'attribution, de disponibilité et d'ordres de travail, puis restitue la journée de demain sous forme de chronologie ordonnée — trajets entre interventions, marges par tâche et points d'attention (fenêtres de trajet serrées, risque de dépassement d'intervention). Rien n'est modifié sur le tableau de bord : les requêtes de lecture ne mutent jamais les données.

Étape 3 — Planifier une intervention en langage naturel

Passez maintenant à la requête 1 :

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

Ce qui se déclenche : réservation d'interventions et rendez-vous, synchronisation client (pour associer la réservation au bon compte), et attribution & disponibilité (pour déterminer qui peut intervenir).

Résultat attendu : une intervention planifiée avec la justification du choix — quel technicien, pourquoi lui (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 avec un technicien certifié pour le gaz, et sans ajouter plus de 20 minutes de trajet à la journée de quiconque.

Le solveur traite ces exigences comme des contraintes strictes, et non comme de simples préférences. Si personne ne remplit les critères, vous obtenez une réponse claire indiquant qu'aucun créneau n'est réalisable avec le nom de la contrainte bloquante — pas une estimation au hasard.

Étape 4 — Absorber une urgence P0 (le décalage en cascade)

C'est cette étape qui distingue un véritable agent d'attribution d'un simple chatbot connecté à un agenda. Une fuite d'eau critique n'attend pas que vous trouviez un créneau libre — comment décaler automatiquement les interventions d'un technicien en cours de journée quand une urgence survient ?

Urgence plomberie maintenant au 99 rue Bank pour David Okafor (613-555-0198) — montrez-moi ce qui est replanifié.

Ce qui se déclenche : attribution & disponibilité, réservation d'interventions et outils d'ordres de travail — et le solveur exécute un replanning en cascade : il calcule à nouveau chaque intervention impactée en aval, en conservant le temps de trajet, la préparation, le réapprovisionnement, les pauses réglementaires et les fenêtres SLA comme contraintes strictes. Une cascade complète est calculée en moins de 3 secondes — mesurée sur une simulation de flotte de 3 véhicules et 20 sites avec l'ensemble de ces contraintes actives.

Résultat attendu — et ce point est essentiel — un plan de réorganisation, pas une modification immédiate. Claude présente la double proposition : le créneau où l'urgence s'insère, 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. Tous les flux de modification sur ce serveur fonctionnent selon le principe prévisualisation/validation ; un agent capable de modifier silencieusement un planning réel sur le tableau de bord n'est pas une fonctionnalité, c'est un incident d'exploitation.

Approuvez le plan, puis demandez :

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

Claude fournit l'explication basée sur le résultat réel du solveur — la contrainte bloquante, la marge disponible — parce que le plan provient directement du solveur, et non de l'imagination du modèle d'IA.

Étape 5 — Personnaliser l'agent

Voici trois orientations pour adapter cet agent de base, chacune accessible en une simple consigne :

• Recherche de disponibilité : « Trouve un créneau de 3 heures dans ma semaine de travail pour faire une sortie à vélo avec ma femme sans mettre aucune intervention en danger. » — classe les créneaux libres selon la marge disponible ; rien n'est déplacé.

• Correspondance compétences et trajets : « Lesquels de mes techniciens certifiés pour le gaz sont disponibles jeudi matin à moins de 20 minutes de Kanata ? »

• Rapport pour le gestionnaire : « Donne-moi un résumé en français simple de la journée de demain pour toutes mes équipes — où sont les risques et si nous sommes en surcapacité quelque part. »

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

Vous intégrez cette logique directement dans votre logiciel plutôt que dans une fenêtre de discussion ? Le même moteur est accessible via une API REST — rendez-vous sur docs.crisphive.com, ou consultez le comparatif des options d'intégration pour choisir entre MCP et API directe.

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

Avant de sortir de l'environnement sandbox :

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 de service qui cesse de fonctionner avec l'erreur API_KEY_EXPIRED un mois après le lancement entraîne un risque d'attrition client, pas un simple rapport de bug.

2. Privilégiez OAuth pour les utilisateurs humains, et les clés pour les services automatisés. 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 transite par une fenêtre de discussion.

3. Conservez le mode prévisualisation/validation. Résistez à la tentation de valider automatiquement les réorganisations en cascade « pour gagner un clic » — l'étape d'approbation est ce qui rend l'agent auditable par le répartiteur qui devra arbitrer la journée de demain.

4. Vérification du périmètre d'accès : le connecteur ne consulte que les données de planification — interventions, ordres de travail, clients, équipes, catalogues, zones, flotte. Les données de facturation et de paiement ne lui sont pas exposées. Assurez-vous que cette règle reste valable pour vos développements en aval.

5. Testez les cas d'erreur dans la sandbox avant le déploiement : une intervention irréalisable (aucun technicien qualifié), un décalage qui enfreint un SLA, un jeton révoqué en cours de session. La gestion des erreurs de votre agent est ce que vos utilisateurs retiendront.

Foire aux questions

Faut-il disposer d'un compte entreprise Crisphive pour tester ?

Non — la sandbox gratuite avec clé chsk_test_ constitue un environnement de test isolé sur la même URL de base, sans carte bancaire requis. La connexion OAuth est réservée au rattachement d'une entreprise réelle par son 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, décalage et réorganisation en cascade est calculé par le solveur déterministe sous contraintes de Crisphive. Posez deux fois la même question, vous obtiendrez exactement le même plan.

L'agent peut-il modifier mon planning réel sans mon accord ?

Non. Tout changement affectant des interventions existantes est restitué sous forme de plan à valider — interventions déplacées, nouvelles heures d'arrivée, impact SLA — et n'est appliqué qu'après votre confirmation.

Le serveur MCP génère-t-il un surcoût ?

Non. L'accès MCP est inclus dans tous les abonnements entreprise ainsi que sur la sandbox développeur gratuite — les appels MCP, replannings en cascade, décalages et lectures ne sont jamais facturés ; seule la gestion des interventions réelles entre dans la facturation.

Quels clients autres que Claude sont compatibles ?

Tout client compatible avec 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 au stdio peuvent utiliser le pont mcp-remote.

Vous gérez des équipes sur le terrain et souhaitez savoir ce que ce moteur aurait produit avec votre planning de mardi dernier ? Demandez un audit gratuit de votre planning — transmettez une journée d'interventions récente et recevez sous 48 heures une analyse des heures de route et des capacités inutilisées détectées.