Um einen KI-Assistenten mit MCP ROOTE zu verbinden, fügen Sie den entfernten Server https://mcp.roote.ai/mcp in eine Anwendung ein, die MCP Streamable HTTP unterstützt. Der Server stellt Lesewerkzeuge für Adressen, Mobilität und nahegelegene Dienste bereit.
Dieses Tutorial folgt der von ROOTE veröffentlichten Konfiguration und einer Verbindungsüberprüfung zum Server. Die Menütitel variieren je nach Client; URL, Transport und das Schema der Werkzeuge sind die zu prüfenden Elemente. Die tools/list-Liste des Servers kann sich vor der Dokumentation ändern: Verwenden Sie die tatsächlich angekündigten Funktionen.
Kompatibilität des Clients überprüfen
Ihre Anwendung muss einen entfernten MCP-Server über Streamable HTTP akzeptieren. Ein Client, der nur lokale stdio-Server unterstützt, kann diese URL nicht als ausführbaren Befehl verwenden. Prüfen Sie außerdem, ob Ihr Konto das Hinzufügen benutzerdefinierter Server erlaubt.
Wenn die Anwendung ein Formular bietet, geben Sie als Namen ROOTE und als Adresse die Server-URL ein. Akzeptiert sie eine Datei im mcpServers-Format, bietet die ROOTE-Dokumentation diese Mindestkonfiguration an:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Offizielle ROOTE-Verbindungskonfiguration
Anonymen oder authentifizierten Zugriff wählen
Die Dokumentation sieht anonymen Zugriff ohne Authorization-Header vor, der der Free-Projektion und den aktiven API-Limits unterliegt. Für authentifizierten Zugriff verwenden Sie den sicheren Mechanismus des Clients, um Ihr Token im Bearer-Header zu übermitteln.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN ist ein Platzhalter, der in der gesicherten Client-Konfiguration ersetzt werden muss. Fügen Sie das Token nicht in Gespräche, öffentliche URLs oder Artikel ein. Ein ungültiges oder widerrufenes Token wird nicht automatisch durch anonymen Zugriff ersetzt.
Bestätigen, dass die Werkzeuge verfügbar sind
Öffnen Sie nach der Verbindung die Werkzeugliste des Servers in Ihrem Client. Die ROOTE-Dokumentation beschreibt die Abfolge initialize, tools/list und tools/call; kompatible Clients führen diese Abfragen normalerweise automatisch aus. Verwenden Sie die vom Server angegebenen Versionen und Fähigkeiten.
Der Server bietet geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions und services_nearby an. Fehlen diese Werkzeuge, liegt ein Verbindungsproblem, ein Entdeckungsfehler oder eine Weiterentwicklung des Dienstes vor. Überprüfen Sie stets die vom Server mitgeteilte Liste. Journey und Departures sind dort noch nicht verfügbar.
Führen Sie eine erste reproduzierbare Suche durch
Beginnen Sie mit einer konkreten Adresse: „Nutze ROOTE, um 10 rue de Rivoli, Paris, Frankreich zu suchen. Zeige gefundene Kandidaten und deren Koordinaten an.“ Analysieren Sie das Ergebnis des Werkzeugs, nicht nur die vom Modell formulierte Antwort.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Dieser Block zeigt Namen und Argumente eines Aufrufs; es ist keine vollständige HTTP-Anfrage. Ihr Client kapselt den MCP-Aufruf. Kommen mehrere plausible Kandidaten zurück, wählen Sie den richtigen, bevor Sie in der Umgebung suchen.
Testen Sie anschließend den Transport um einen Referenzpunkt in Bordeaux. Die unten stehenden Koordinaten dienen dem Test und stammen nicht von der zuvor genannten Pariser Adresse.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Ergebnis prüfen, bevor Sie Schlüsse ziehen
Überprüfen Sie Status, zurückgegebene Entitäten, Abdeckung, Warnungen und angewandte Limits. Eine teilweise Antwort kann nützliche Informationen enthalten. Eine leere Suche beweist nicht das physische Fehlen von Verkehrsmitteln in der Stadt.
Das erwartete Testergebnis ist eine strukturierte Antwort oder eine eindeutige Fehlermeldung, nicht eine vorgegebene Anzahl von Haltestellen. Quellen und Abdeckung können sich ändern. Die Haltestellensuche liefert keine nächsten Abfahrten.
Verbindungsfehler beheben
| Symptom | Nützliche Überprüfung |
|---|---|
| Keine Werkzeuge erkannt | Exakte URL, entfernter Transport und Client-Autorisierung |
| Argumentfehler | Typen, erlaubte Werte und Felder des angegebenen Schemas |
| Authentifizierungsfehler | Gültigkeit des Bearer und Header-Konfiguration |
| Limit erreicht | Aktive Limits, Wiederaufnahmeverzögerung und Aufruffrequenz |
| Leeres oder partielles Ergebnis | Koordinaten, Filter, Radius, Abdeckung und Warnungen |
Leeres Ergebnis von einer API-Fehlermeldung unterscheiden
Einen vollständigen Assistenten aus einer Adresse erstellen
Die Rolle eines MCP-Servers verstehen
Zukünftig: nächste Abfahrten und Routenberechnung
ROOTE plant, sein MCP um kommende Abfahrten und die Routenberechnung zu erweitern. Diese Funktionen sind in Vorbereitung und gehören noch nicht zu den derzeit vom MCP-Server bereitgestellten Werkzeugen. Prüfen Sie bei deren Verfügbarkeit die vom Server angebotenen Werkzeuge, deren Parameter und tatsächlich zurückgegebenen Informationen, bevor Sie eine Abfahrt oder Reise ankündigen.
Häufig gestellte Fragen
Ist ein Token unbedingt erforderlich?
Die Dokumentation sieht anonymen Free-Zugang vor. Ihre Zugangsbeschränkungen und Fähigkeiten entsprechen den vom Dienst angewendeten Limits.
Warum zeigt mein Assistent nach einer Haltestellensuche eine Abfahrtszeit an?
Eine transit_nearby-Suche liefert keine nächsten Abfahrten. Bitten Sie den Assistenten, die tatsächlich zurückgegebenen Daten zu nennen und auf diese fehlende Information hinzuweisen.
Kann man testen, ohne eine Anwendung zu erstellen?
Ja, mit einem kompatiblen Client, der das Hinzufügen eines entfernten Servers und das Ausführen seiner Werkzeuge erlaubt.