Routing24 als MCP-Server
Von Nathan ColeAktualisiert
Routing24 stellt unter https://routing24.ai/mcp einen Model-Context-Protocol-Server
bereit. Ein Assistent, der MCP unterstützt, listet die Tools auf, die
Routing24 anbietet, und ruft sie auf. Diese Seite behandelt, wie ein Aufruf
zu Ihrem Plan geleitet wird, die 45 Tools, die der Server bereitstellt, was
die App zeigt, während ein verbundener Assistent arbeitet, und was jeder
Fehler bedeutet.
Wie ein Aufruf zu Ihrem Plan geleitet wird
Ein Aufruf wird in drei Schritten geleitet. Die Arbeit passiert beim letzten:
- Der verbundene Assistent sendet den Aufruf an
https://routing24.ai/mcp. - Der Server leitet ihn in Ihren angemeldeten Routing24-Browser-Tab.
- Der Tab führt die Arbeit an dem Plan aus, den er geöffnet hat, und antwortet.
Aus dieser Weiterleitung folgen drei Bedingungen. Die meisten Fehler auf dieser Seite gehen auf eine davon zurück:
- Sie sind in einem Browser bei Routing24 angemeldet.
- Ein
routing24.com/app-Tab ist geöffnet. Jede Seite der App zählt. - Sie haben die Verbindung einmal aus diesem Browser genehmigt. Siehe Claude und ChatGPT verbinden.
Es bedient immer nur ein Browser das Konto. Wenn Sie die Verbindung in einem zweiten Browser genehmigen, antwortet der erste nicht mehr.
Der Assistent in der App erledigt dieselbe Arbeit über dieselben Tools. Die beiden unterscheiden sich in dem, was sie umgibt:
| Der Assistent in der App | Ein verbundener Assistent |
|---|---|
| Öffnet sich in der App, keine Einrichtung | Einmal mit einer URL und einer Genehmigung verbinden |
| Kann auf den Plan zugreifen, nicht auf Ihre Dateien oder andere Systeme | Greift auch auf Ihre Dateien, E-Mails und andere Tools zu |
| Importiert eine angehängte Datei, speichert einen Konverter, prüft eine Adressreparatur | Verwendet nur die 45 Tools |
| Verbraucht das KI-Budget des Kontos | Verbraucht sein eigenes Anbieter-Budget |
| Läuft, während der Bereich geöffnet ist | Braucht einen geöffneten App-Tab, auf einer beliebigen Seite |
Was Routing24 bereitstellt
Jedes Tool trägt das Präfix routing24_. Das Vokabular, das ein verbundener
Assistent liest, ist das Vokabular der App: Zeitfenster, Kapazitäten,
Schichten, Prioritäten, Tags, Pausen, Transfers, Reihenfolgen, Nachladungen
und Kosten.
Ein unten mit read markiertes Tool liest nur. Es kann den Plan nicht ändern, und der Server weist es als solches aus; danach gruppiert ein Client seine Berechtigungen. Alles Unmarkierte schreibt.
Pläne und das Konto
| Tool | Was es tut |
|---|---|
routing24_get_auth_userread | Das angemeldete Konto, zu dem ein gespeicherter Plan gehören wird |
routing24_list_plansread | Die gespeicherten Pläne: ID, Name, Zeitstempel, Entitätsanzahlen und welcher geladen ist |
routing24_load_plan | Einen gespeicherten Plan per ID laden; ungespeicherte Änderungen des ersetzten Plans werden zuerst gespeichert |
routing24_new_plan | Einen neuen leeren Plan starten; ersetzt den geladenen Plan, nachdem dessen ungespeicherte Änderungen gespeichert wurden |
routing24_save | Den Plan speichern und seinen Link zurückgeben |
routing24_plan_urlread | Der Link des aktuellen Plans |
Den Routenplan lesen
| Tool | Was es tut |
|---|---|
routing24_statusread | Fortschritt plus Überblick über den Routenplan: Zusammenfassungen, Kosten und Statistiken pro Route |
routing24_routeread | Die geordneten Stopps einer Route nach ihrer angezeigten Routennummer: ETAs, Ladungen, Wartezeiten und Probleme |
routing24_unassignedread | Welche Aufträge nicht zugewiesen sind und warum: IDs, Diagnosen und Kostenschätzungen für das Einfügen |
Plandaten
| Tool | Was es tut |
|---|---|
routing24_list_stopsread | Die Aufträge des Plans lesen, seitenweise und filterbar |
routing24_list_vehiclesread | Die Fahrzeugtypen des Plans lesen |
routing24_list_depotsread | Die Depots des Plans lesen |
routing24_list_addressesread | Das Adressbuch lesen, mit Nutzungszählern |
routing24_upsert_stops | Aufträge per ID anlegen oder aktualisieren |
routing24_upsert_vehicles | Fahrzeugtypen per ID anlegen oder aktualisieren |
routing24_upsert_depots | Depots per ID anlegen oder aktualisieren |
routing24_upsert_addresses | Adressbuchzeilen anlegen oder aktualisieren |
routing24_delete_stops | Aufträge per ID löschen |
routing24_delete_vehicles | Fahrzeugtypen per ID löschen |
routing24_delete_depots | Depots löschen: die Fahrzeuge, die auf sie verweisen, werden mit ihnen gelöscht |
routing24_delete_addresses | Adressen löschen: die Aufträge und Depots an ihnen werden mit ihnen gelöscht |
Routenbearbeitung
| Tool | Was es tut |
|---|---|
routing24_edit_move_stops | Stopps auf eine andere Route oder eine andere Position verschieben, verankert oder an die günstigste Position |
routing24_edit_unassign_stops | Stopps von ihren Routen nehmen |
routing24_edit_set_route_vehicle | Einer Route ein anderes Fahrzeug geben |
routing24_edit_create_route | Eine leere Route für ein Fahrzeug hinzufügen |
routing24_edit_remove_routes | Routen löschen: Stopps, die noch darauf liegen, werden in derselben Bearbeitung auf nicht zugewiesen gesetzt |
routing24_edit_split_route | Eine Route nach einem Stopp in zwei teilen |
routing24_edit_merge_routes | Die Stopps anderer Routen auf eine Route verschieben |
routing24_edit_mark_user_assigned | Stopps als manuell platziert markieren und dabei auf verletzte Bedingungen hinweisen |
routing24_edit_clear_user_assigned | Diese Markierung und ihren Bericht entfernen |
routing24_undo | Im gemeinsamen Bearbeitungsverlauf zurückgehen |
routing24_redo | Wieder vorwärtsgehen |
Optimierung
| Tool | Was es tut |
|---|---|
routing24_reoptimize_plan | Den geladenen Plan direkt optimieren |
routing24_reoptimize_route | Eine Route neu sequenzieren, synchron |
routing24_cancel | Eine lange Optimierung abbrechen; der bisher beste Routenplan bleibt erhalten |
Daten und Skripting
| Tool | Was es tut |
|---|---|
routing24_sql_queryread | Den Plan mit SQL über acht Live-Tabellen lesen, von Aufträgen bis zu Routenplan-Stopps |
routing24_sql_update | Massenaktualisierungen von Feldern mit SQL, validiert und atomar angewendet |
routing24_run_script | Sandbox-JavaScript-Transformationen und -Analysen über einen Entwurf des Plans |
Die App und die Ausgabe
| Tool | Was es tut |
|---|---|
routing24_renderread | Zur Optimierungsseite navigieren, damit die Routen gezeichnet werden |
routing24_open_pageread | Eine der Seiten der App öffnen |
routing24_show_on_mapread | Den Kartenausschnitt animiert auf einen Auftrag, ein Depot oder eine Adresse ausrichten |
routing24_export_excelread | Den Plan als Excel-Arbeitsmappe herunterladen |
routing24_map_imageread | Den Plan als Retina-Kartenbild aufnehmen, mit Pins und Routenlinien |
routing24_session_logread | Das Aktionsprotokoll einer Assistentensitzung lesen, für Übergaben und Prüfungen |
Tabs und Sitzungen
| Tool | Was es tut |
|---|---|
routing24_list_loaded_plansread | Die offenen Tabs, der in jedem geöffnete Plan und die Assistentensitzung, die ihn bearbeitet |
Koordinaten statt einer Adresse
Ein Auftrag oder ein Depot braucht einen Standort. Normalerweise geben Sie eine Adresse an, und Routing24 geokodiert diese Adresse, wenn es die Zeile speichert.
Wenn Sie den genauen Punkt bereits kennen, setzen Sie stattdessen
coordinates auf die Zeile, mit lat und lng in Dezimalgrad. Routing24
platziert die Zeile an diesem Punkt und ruft den Geocoder nie auf. Fügen Sie
zusätzlich eine address hinzu, um Ihren eigenen Text auf der Zeile zu
behalten. Ohne sie zeigt die Zeile 25.19882, 55.27939.
Eine als zwei Dezimalzahlen geschriebene Adresse bewirkt dasselbe. Senden Sie
25.19882, 55.27939 als Adresse, und die Zeile landet auf diesem Punkt.
Beide Formen funktionieren bei routing24_upsert_stops und
routing24_upsert_depots, und beide funktionieren für einen ganzen Batch auf
einmal. Eine vorhandene Liste von Punkten lässt sich mit einem einzigen Aufruf übergeben. Da keine Geokodierung erforderlich ist, können dabei keine Geokodierungsfehler entstehen.
Koordinaten gehen nur hinein. Kein Tool gibt sie zurück.
Welchen Plan ein Aufruf anspricht
Ein Browser kann mehrere Pläne geöffnet haben, einen pro Tab. Zwei Eingaben entscheiden, welchen Plan ein Aufruf anspricht.
plan_id identifiziert den Plan, auf dem der Aufruf arbeiten muss.
Dieser Plan muss bereits in einem Tab geöffnet sein. Wenn kein Tab ihn
geöffnet hat, schlägt der Aufruf fehl und nennt die Pläne, die geöffnet
sind.
session_id identifiziert die eigene Bearbeitungssitzung eines
verbundenen Assistenten. Routing24 erzeugt eine bei der ersten Änderung des
Assistenten an einem Plan und gibt sie im Ergebnis zurück. Ein Assistent,
der diese ID an jeden späteren Aufruf anheftet, behält seinen eigenen Plan,
auch wenn Sie zu einem anderen Tab wechseln. Nur-Lese-Aufrufe erzeugen nie
eine Sitzung.
routing24_list_loaded_plans meldet die offenen Tabs, den in jedem
geöffneten Plan, ob der Tab leer, fokussiert oder sichtbar ist, und die
Assistentensitzung, die ihn bearbeitet. Zwei Assistenten, die an zwei Plänen
arbeiten, nutzen es, um ihre Aufrufe auf ihren eigenen Plänen zu halten.
Wenn keine der beiden Eingaben angegeben ist, bezieht sich der Aufruf auf den Plan der eigenen Sitzung des Aufrufers. Ohne Sitzung arbeitet er auf dem Plan im fokussierten Tab, dann in einem sichtbaren Tab, dann in dem zuletzt gesehenen Tab. Der fokussierte Tab wechselt, sobald Sie einen anderen anklicken.
Was Sie sehen, während ein verbundener Assistent arbeitet
- Das Header-Badge. Auf planbezogenen Seiten zeigt ein grünes Badge
den Client-Namen und wie lange der letzte Aufruf zurückliegt, zum
Beispiel
Claude (now)oderChatGPT (3 min ago). Sein Tooltip zeigt das letzte Tool unter seinem technischen Namen: "Letzte Aktion von Claude: routing24_reoptimize_plan. Klicken Sie für das Sitzungsprotokoll." Das Badge verschwindet fünf Minuten nach dem letzten Aufruf. Drücken Sie darauf, um den Assistentenbereich beim Protokoll zu öffnen. - Das Sitzungsprotokoll. Der Assistentenbereich listet jede Sitzung
unter einer Überschrift
Session a1b2c3d4 (Claude), dann eine Zeile pro Aufruf mit der Zeit, der Aktion in einfachen Worten und ob sie fehlgeschlagen ist. Lebenszyklus-Zeilen lauten "hat diese Sitzung gestartet", "hat diese Sitzung übernommen" und "in einem anderen Tab fortgesetzt". - Die Disconnect-Leiste. Unter dem Nachrichtenfeld zeigt eine Leiste "Claude ist mit Ihrem Konto verbunden" mit einer Schaltfläche Verbindung trennen. Siehe Claude und ChatGPT verbinden.
- Die Sperre. Eine Bearbeitung legt die App hinter ein Vollbild-Overlay mit dem Titel Agentensteuerung und dem Text "Ein KI-Agent bearbeitet diesen Plan. Der Bildschirm ist gesperrt, während er arbeitet; jede Änderung landet im gemeinsamen Undo-Verlauf.", mit einem Zähler der bisher angewendeten Änderungen. Drücken Sie Kontrolle übernehmen, um die App jederzeit zurückzuholen.
- Der Bereich. Während ein verbundener Assistent arbeitet, wird das Nachrichtenfeld durch "Claude arbeitet an diesem Plan" und eine Schaltfläche Kontrolle übernehmen ersetzt.
Löschungen und Massenfeldänderungen eines verbundenen Assistenten werden ohne Prüfung angewendet. Die Prüfdialoge gehören zum Assistenten in der App.
Gemeinsames Bearbeiten
Die Bearbeitungen des verbundenen Assistenten und Ihre eigenen Bearbeitungen teilen einen Undo-Verlauf. Machen Sie von Hand genau dort weiter, wo der Assistent aufgehört hat. Siehe Einen Plan mit KI abfragen, bearbeiten und exportieren.
Wenn sich der Plan geändert hat, seit der verbundene Assistent ihn zuletzt gelesen hat, weist Routing24 die nächste Bearbeitung dieses Assistenten zurück. Nichts wird geschrieben. Die Zurückweisung enthält die aktuelle Revision des Plans und den letzten Bearbeiter. Der Assistent liest den Plan erneut, und derselbe Aufruf gelingt beim erneuten Versuch. Die App zeigt dabei nichts an.
Was die Fehler bedeuten
Ein verbundener Assistent meldet diese in seinem eigenen Transkript.
| Was der Assistent meldet | Was passiert ist |
|---|---|
| Kein Routing24-Browser-Tab ist verbunden | Kein angemeldeter Browser ist angebunden. Öffnen Sie die App und melden Sie sich an |
| Kein Routing24-App-Tab ist geöffnet | Der Browser ist angebunden, aber kein App-Tab ist geöffnet. Öffnen Sie routing24.com/app |
| Der Tab wurde geschlossen, während ein Tool lief | Der Tab wurde mitten im Aufruf geschlossen. Die Änderung wurde möglicherweise angewendet, möglicherweise nicht |
| Der Tab hat nicht innerhalb von 60 s geantwortet | Ein Tool hat das 60-Sekunden-Limit überschritten. Eine laufende Optimierung läuft im Tab weiter |
| Ein anderer Tab hat während dieses Aufrufs übernommen | Ein zweiter Browser hat sich angebunden und den ersten abgelöst |
| Der Planzustand ist abgedriftet | Der Plan hat sich geändert, seit der Assistent ihn zuletzt gelesen hat. Er liest erneut und versucht es noch einmal |
Eine lange Optimierung überschreitet das 60-Sekunden-Limit immer. Die
Optimierung läuft im Tab weiter. Der Assistent fragt routing24_status nach
dem Ergebnis ab, statt den Aufruf zu wiederholen.
Limits
- Acht gleichzeitig laufende Aufrufe pro Sitzung.
- 120 Anfragen pro Minute und Konto.
- 60 Sekunden pro Aufruf.
- Ein Kartenbild von rund 600 KB.
- Ein sichtbarer Tab für ein Kartenbild. Ein verborgenes Fenster hört auf zu zeichnen, sodass die Aufnahme in ein Timeout läuft.
- Ein angebundener Browser pro Konto. Ein verbundener Assistent arbeitet über diesen Browser und nirgendwo sonst: Routing24 führt nichts eigenständig aus, solange alle Tabs geschlossen sind.
Wo die Arbeit läuft
Die Optimierung läuft in Ihrem Browser-Tab. Geokodierung und Distanzmatrizen laufen auf Routing24-Servern unter Ihrer eigenen Sitzung. Der MCP-Endpunkt ist der einzige Routing24-Server, auf den ein verbundener Assistent zugreift, mit einem Token, das beim Genehmigen der Verbindung erzeugt wird. Datenschutz und Datenverarbeitung nennt, was jeder dieser Aufrufe sendet und wer die Daten erhält, die ein verbundener Assistent liest.
Was es kostet
Das Verbinden eines Assistenten ist in jedem Tarif verfügbar. Ein verbundener Assistent verbraucht sein eigenes Anbieter-Budget statt des KI-Budgets des Kontos. Eine Optimierung, die er startet, verbraucht dasselbe Kontingent wie die Schaltfläche Optimieren. Siehe Einschränkungen in einfacher Sprache beschreiben und Tarife, Abrechnung und kostenlose Limits.
Die Optimization API ist ein separates Pro-Produkt für die System-zu-System-Integration, eingerichtet mit dem Team. Siehe Integrationen.
Nächster Schritt
Die Schreib-Tools setzen dieselben Felder, die Sie von Hand setzen. Fahrzeuge und Depots hinzufügen öffnet die Referenz dafür, was diese Felder bedeuten.
FAQ
Was brauche ich, damit ein verbundener Assistent funktioniert?
Ein verbundener Assistent braucht drei Dinge: Sie sind in einem Browser bei Routing24 angemeldet, ein routing24.com/app-Tab ist auf einer beliebigen Seite der App geöffnet, und Sie haben die Verbindung einmal aus diesem Browser genehmigt. Es bedient immer nur ein Browser das Konto; wenn Sie die Verbindung in einem zweiten Browser genehmigen, antwortet der erste nicht mehr.
Wo läuft die Arbeit eines verbundenen Assistenten tatsächlich?
Der Aufruf wird in Ihren angemeldeten Browser-Tab geleitet, und der Tab führt die Arbeit an dem Plan aus, den er geöffnet hat. Die Optimierung läuft im Browser. Geokodierung und Distanzmatrizen laufen auf Routing24-Servern unter Ihrer eigenen Sitzung. Der MCP-Endpunkt ist der einzige Routing24-Server, auf den ein verbundener Assistent zugreift.
Wie unterscheidet sich ein verbundener Assistent vom Assistenten in der App?
Beide erledigen dieselbe Arbeit über dieselben Tools. Der Assistent in der App öffnet sich ohne Einrichtung, kann auf den Plan zugreifen, aber nicht auf Ihre Dateien oder andere Systeme, und verbraucht das KI-Budget des Kontos. Ein verbundener Assistent verbindet sich einmal mit einer URL und einer Genehmigung, greift auch auf Ihre Dateien und andere Tools zu und verbraucht sein eigenes Anbieter-Budget.
Kann ich einen verbundenen Assistenten stoppen, während er bearbeitet?
Ja. Eine Bearbeitung legt die App hinter ein Vollbild-Overlay mit dem Titel Agent controlled, mit einem Zähler der bisher angewendeten Änderungen. Drücken Sie Kontrolle übernehmen, um die App jederzeit zurückzuholen. Jede Änderung landet im gemeinsamen Undo-Verlauf, sodass Sie von Hand genau dort weitermachen können, wo der Assistent aufgehört hat.
Warum läuft eine lange Optimierung für einen verbundenen Assistenten in ein Timeout?
Jeder Aufruf hat ein Limit von 60 Sekunden, und eine lange Optimierung überschreitet es immer. Die Optimierung läuft im Tab weiter; nur der Aufruf endet. Der Assistent fragt das Status-Tool nach dem Ergebnis ab, statt den Aufruf zu wiederholen, und liest den Routenplan, wenn der Lauf abgeschlossen ist.