Einen Dispatching-Agenten für Field Operations mit Claude + Crisphive MCP bauen

Was das ist: Eine Schritt-für-Schritt-Anleitung, die Claude mit einem aktiven Einsatzplan (in einer Sandbox) für Field Operations verbindet, Aufträge in natürlicher Sprache bucht, P0-Notfälle über eine vollständige Kaskaden-Umplanung auffängt und mit einer Checkliste zur Produktionsreife abschließt. Dauer: etwa 15 Minuten. Kosten: keine – die Sandbox ist kostenlos, keine Kreditkarte erforderlich, und MCP-Aufrufe werden nie berechnet.

Am Ende haben Sie einen Assistenten, der Folgendes erledigen kann:

Sie: Dringender Sanitär-Notfall jetzt in der Bankstraße 99 für David Okafor (0613-555-0198) – zeig mir, was umgeplant werden muss.

Claude: ruft die Dispatching-Tools auf und liefert einen Plan zurück – der Notfall ist für 13:15 Uhr eingeplant, zwei Aufträge wurden verschoben mit neuen Ankunftszeiten, eine SLA als knapp markiert, noch nichts verbindlich gebucht. Bestätigen?

Das Entscheidende an diesem Verlauf ist das, was Claude nicht getan hat: Es hat den Plan nicht erfunden. Claude interpretiert die Anfrage; der deterministische Constraint-Solver von Crisphive berechnet den Einsatzplan – Anfahrtszeit, Qualifikationen, Zertifizierungen, geschützte Pausen und SLAs als feste Bedingungen – und gibt ihn zur Freigabe zurück. Gleiche Eingabe, gleicher Einsatzplan, jedes Mal. Diese Arbeitsteilung bildet die gesamte Architektur dieses Tutorials, daher lohnt sich ein Blick auf ein Diagramm, bevor wir starten:

Sie (natürliche Sprache)
→ Claude (interpretiert die Absicht, wählt Werkzeuge aus)
→ Crisphive MCP-Server – https://api.crisphive.com/mcp (43 Werkzeuge)
→ REST-API → deterministischer Constraint-Solver
← überprüfbarer Plan (verschobene Aufträge, neue Ankunftszeiten, SLA-Auswirkungen)
← Claude erklärt den Plan und die Kompromisse
Sie bestätigen → der Einsatzplan wird verbindlich gespeichert

Was Sie benötigen

• Ein Claude-Konto – claude.ai, Claude Desktop oder Claude Code funktionieren alle; die Unterstützung für Connectoren hängt von Ihrem Tarif ab.

• Wenn Sie einen Field Operations-Betrieb auf Crisphive führen: sonst nichts – Sie melden sich per OAuth als Inhaber des Betriebs an.

• Wenn Sie Entwickler ohne Crisphive-Betrieb sind: einen kostenlosen Sandbox-Schlüssel. Registrieren Sie sich auf der Entwicklerseite und holen Sie sich einen chsk_test_-Schlüssel – eine isolierte Testumgebung unter derselben Basis-URL. Keine Kreditkarte, kein Verkaufsgespräch.

In beiden Fällen wird nichts installiert oder lokal ausgeführt. Der MCP-Server wird gehostet und läuft remote über Streamable HTTP.

Schritt 1 – Claude mit Crisphive verbinden

Weg A – Für Anwender (OAuth, Ein-Klick)

Öffnen Sie den Crisphive-Eintrag im Claude-Connectoren-Verzeichnis und klicken Sie auf Verbinden. Sie werden aufgefordert, sich als Crisphive-Betriebsinhaber anzumelden und die Verbindung zu bestätigen. Das ist schon die gesamte Einrichtung.

Bevorzugen Sie die manuelle Einrichtung? In claude.ai oder Claude Desktop: Einstellungen → Connectoren → Benutzerdefinierten Connector hinzufügen, fügen Sie https://api.crisphive.com/mcp ein und schließen Sie die OAuth-Anmeldung ab, sobald das Zustimmungsfenster erscheint.

Weg B – Für Entwickler (Claude Code + Sandbox-Schlüssel)

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

Um die Sitzung an Ihre isolierte Sandbox statt an einen echten Live-Betrieb zu binden, hängen Sie Ihren Testschlüssel an:

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

Andere MCP-Clients – Cursor, VS Code, Windsurf, Cline, Zed, LM Studio, Gemini CLI – verwenden dieselbe URL; die vollständige Client-Übersicht befindet sich in der GitHub README. Clients, die nur stdio unterstützen, können über mcp-remote angebunden werden.

Prüfpunkt: Fragen Sie Claude „Welche Crisphive-Werkzeuge stehen dir zur Verfügung?“ – Sie sollten 43 Werkzeuge in acht Gruppen sehen: Auftragsbuchung & Termine, Arbeitsauftragsverfolgung, Dispatching & Verfügbarkeit, Kunden-Synchronisierung (CRM), Leistungskataloge, Teams & Dienstpläne, Einsatzgebiete und Fuhrpark.

Schritt 2 – Den Einsatzplan kennenlernen

Starten Sie mit den drei Prompts aus dem Verzeichniseintrag – es sind dieselben drei Prompts, die in der gesamten Crisphive-Dokumentation für diesen Connector verwendet werden.

Testen Sie zuerst diese:

1. Plane morgen einen 2-stündigen HVAC-Auftrag in der Laurier Ave W 145 für Marie Tremblay, 613-555-0142.

2. Dringender Sanitär-Notfall jetzt in der Bankstraße 99 für David Okafor (0613-555-0198) – zeig mir, was umgeplant werden muss.

3. Gib mir einen Überblick über meinen morgigen Tag und markiere Risiken.

Führen Sie Prompt 3 zuerst aus – er ist schreibgeschützt und bietet eine sichere Möglichkeit, die Verbindung durchgehend zu prüfen.

Erwartetes Ergebnis: Claude ruft die Werkzeuge für Dispatching & Verfügbarkeit sowie Arbeitsaufträge auf und gibt den morgigen Tag als zeitlich geordnete Abfolge zurück – Anfahrtsstrecken zwischen den Aufträgen, Pufferzeiten pro Auftrag und markierte Risiken (knappe Anfahrtsfenster, drohende Zeitüberschreitungen). Auf dem Dispositionboard verändert sich nichts; Lese-Prompts führen nie zu Änderungen.

Schritt 3 – Einen Auftrag in natürlicher Sprache buchen

Führen Sie nun Prompt 1 aus:

Plane morgen einen 2-stündigen HVAC-Auftrag in der Laurier Ave W 145 für Marie Tremblay, 613-555-0142.

Was passiert: Werkzeuge für Auftragsbuchung & Termine, Kunden-Synchronisierung (damit die Buchung dem richtigen Kundenkonto zugeordnet wird) und Dispatching & Verfügbarkeit (wer tatsächlich Zeit hat) werden aufgerufen.

Erwartetes Ergebnis: Ein gebuchter Auftrag mit Begründung für die Zuweisung – welcher Techniker gewählt wurde und warum (Qualifikationen, Zertifizierung, Nähe, bestehende Route) sowie das genaue Zeitfenster. Wenn Sie sehen möchten, wie die Constraint-Engine komplexere Anforderungen löst, schränken Sie die Anfrage weiter ein:

Derselbe Auftrag, aber nur mit einem für Gasinstallation zertifizierten Techniker, und füge niemanden mehr als 20 Minuten zusätzliche Fahrzeit am Tag hinzu.

Der Solver behandelt diese Vorgaben als harte Bedingungen, nicht als Empfehlungen. Wenn niemand die Kriterien erfüllt, erhalten Sie eine ehrliche Rückmeldung, dass kein passendes Zeitfenster existiert, mit Nennung der limitierenden Bedingung – und keine Vermutung.

Schritt 4 – Einen P0-Notfall auffangen (die Kaskade)

Dieser Schritt unterscheidet einen Dispatching-Agenten von einem Chatbot mit Kalenderfunktion. Ein Rohrbruch fragt nicht nach passenden Uhrzeiten – wie planen Sie Technikeraufträge im laufenden Tagesbetrieb automatisch um, wenn plötzlich ein Notfall dazwischenkommt?

Dringender Sanitär-Notfall jetzt in der Bankstraße 99 für David Okafor (0613-555-0198) – zeig mir, was umgeplant werden muss.

Was passiert: Werkzeuge für Dispatching & Verfügbarkeit, Auftragsbuchung und Arbeitsaufträge greifen ineinander – und der Solver führt eine Kaskaden-Umplanung aus: Er überplant jeden nachfolgenden Auftrag, der von der Einfügung betroffen ist. Dabei werden Anfahrtszeiten, Rüstzeiten, Materialfahrten, geschützte Pausen und SLA-Fenster strikt als harte Bedingungen eingehalten. Eine vollständige Kaskade wird in unter 3 Sekunden berechnet – gemessen in einer Flottensimulation mit 20 Standorten und 3 Fahrzeugen unter aktiven Bedingungen.

Erwartetes Ergebnis – und das ist entscheidend – ist ein Plan, keine unüberlegte Änderung. Claude präsentiert den doppelten Entwurf: wo der Notfall einsortiert wird, jeder verschobene Auftrag, alle neuen Ankunftszeiten und die Gesamtauswirkung auf die SLAs. Nichts wird verbindlich übernommen, bis Sie zustimmen. Jeder verändernde Ablauf auf diesem Server ist bewusst als Vorschau-/Bestätigungspaar ausgelegt; ein Agent, der eigenmächtig eine echte Disposition umstellt, ist kein Feature, sondern eine Störung.

Bestätigen Sie den Plan und fragen Sie anschließend:

Warum wurde der Warmwasserbereiter-Auftrag um 14 Uhr verschoben, die Inspektion um 15 Uhr jedoch nicht?

Claude erklärt die Antwort anhand der tatsächlichen Solver-Ausgabe – welche Bedingung ausschlaggebend war und welcher Puffer vorhanden war – weil der Plan vom Solver stammt und nicht aus der Fantasie des Sprachmodells.

Schritt 5 – Passen Sie es an Ihre Bedürfnisse an

Drei Möglichkeiten, den Basis-Agenten zu erweitern – jeweils nur einen Prompt entfernt:

• Freie Zeitfenster ermitteln: „Finde ein 3-Stunden-Fenster in meiner Arbeitswoche, in dem ich mit meiner Frau Fahrrad fahren kann, ohne Aufträge zu gefährden.“ – bewertet freie Zeitfenster nach Puffer im Einsatzplan; nichts wird verschoben.

• Abgleich von Qualifikationen & Anfahrt: „Welche meiner für Gasinstallation zertifizierten Techniker sind Donnerstagmorgen innerhalb von 20 Minuten um Kanata verfügbar?“

• Überblick für die Geschäftsleitung: „Gib mir eine leicht verständliche Zusammenfassung für morgen über alle Teams hinweg – wo Risiken liegen und ob wir irgendwo überbucht sind.“

Dieselben 43 Werkzeuge unterstützen Disponenten, Entwickler und Betriebsinhaber – der Unterschied liegt nur in der Formulierung Ihrer Anfrage. Die Seite MCP für Claude bietet eine kopierbare Prompt-Bibliothek für alle drei Perspektiven.

Möchten Sie diese Logik direkt in eine Software integrieren statt in ein Chat-Fenster? Derselbe Mechanismus steht als REST-API zur Verfügung – starten Sie unter docs.crisphive.com oder lesen Sie den Vergleich der Integrationspfade, um zu entscheiden, wann MCP oder die direkte API die richtige Wahl ist.

Schritt 6 – Checkliste zur Härtung für den Live-Betrieb

Bevor das System die Sandbox verlässt:

1. API-Schlüssel laufen ab – der Standardwert beträgt 30 Tage, und die Benachrichtigung über das Ablaufdatum geht an den Betriebsinhaber, nicht zwingend an Sie. Stellen Sie für produktive Agenten Schlüssel mit 365 Tagen Laufzeit aus und nutzen Sie eine Rotation mit zwei Schlüsseln: Schlüssel B erstellen, bereitstellen, Traffic auf B bestätigen, Schlüssel A widerrufen. Wenn der Agent einer Agentur einen Monat nach dem Start mit API_KEY_EXPIRED ausfällt, ist das ein Kündigungsgrund, kein einfacher Bug-Report.

2. Bevorzugen Sie OAuth für Personen und Schlüssel für automatisierte Dienste. OAuth-Tokens können von beiden Seiten widerrufen werden – in den Claude-Connector-Einstellungen oder im Crisphive-Konto – und kein Schlüssel gelangt jemals in ein Chat-Fenster.

3. Lassen Sie das Vorschau-/Bestätigungsprinzip aktiv. Widerstehen Sie der Versuchung, Kaskaden automatisch zu bestätigen, „um einen Klick zu sparen“ – der Bestätigungsschritt sorgt dafür, dass die Aktionen des Agenten für Disponenten nachvollziehbar bleiben, wenn sie am nächsten Tag eingreifen.

4. Berechtigungen prüfen: Der Connector sieht ausschließlich Planungsdaten – Aufträge, Arbeitsaufträge, Kunden, Teams, Kataloge, Einsatzgebiete, Fuhrpark. Abrechnungs- und Zahlungsdaten werden nicht offengelegt. Stellen Sie sicher, dass dies auch für alle nachgelagerten Eigenentwicklungen gilt.

5. Testen Sie Ausnahmesituationen zuerst in der Sandbox: einen nicht umsetzbaren Auftrag (kein qualifizierter Techniker), eine Kaskade, die ein SLA verletzt, oder ein mitten in der Sitzung widerrufenes Token. Die Fehlerbehandlung Ihres Agenten ist das, was Ihren Nutzern im Gedächtnis bleibt.

Häufig gestellte Fragen

Benötige ich einen Crisphive-Betrieb, um das auszuprobieren?

Nein – die kostenlose chsk_test_-Sandbox ist eine isolierte Testumgebung unter derselben Basis-URL, ohne Kreditkarte. Die OAuth-Anmeldung dient dazu, einen echten Betrieb als Inhaber zu verbinden.

Übernimmt Claude die Einsatzplanung?

Nein – und genau das ist der Punkt. Claude interpretiert Ihre Anfrage; jede Buchung, Kaskade und Umplanung wird vom deterministischen Constraint-Solver von Crisphive berechnet. Stellen Sie dieselbe Frage zweimal, erhalten Sie zweimal exakt denselben Plan.

Kann der Agent meinen echten Einsatzplan ohne mein Wissen ändern?

Nein. Jede Aktion, die bestehende Termine verschiebt, liefert einen überprüfbaren Plan zurück – verschobene Aufträge, neue Ankunftszeiten, SLA-Auswirkungen – und wird erst übernommen, wenn Sie ihn bestätigen.

Fallen für den MCP-Server zusätzliche Kosten an?

Nein. Der MCP-Zugriff ist in jedem Betriebstarif und in der kostenlosen Entwickler-Sandbox enthalten – MCP-Aufrufe, Kaskaden, Umplanungen und Lesezugriffe werden nie berechnet; gebucht werden nur aktive Aufträge.

Welche Clients außer Claude werden unterstützt?

Jeder Client, der externe MCP-Server über Streamable HTTP unterstützt – unter anderem ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, Cline, Zed und LM Studio. Clients, die nur stdio unterstützen, können über mcp-remote angebunden werden.

Sie leiten ein Außendienstteam und möchten wissen, wie diese Engine Ihren Einsatzplan vom letzten Dienstag optimiert hätte? Buchen Sie ein kostenloses Shadow Schedule Audit – senden Sie uns die Auftragsdaten eines vergangenen Tages und erhalten Sie innerhalb von 48 Stunden eine Auswertung der eingesparten Fahrzeiten und Kapazitäten zurück.