Az IA asszisztens MCP ROOTE-hoz történő csatlakoztatásához adja hozzá a https://mcp.roote.ai/mcp című távoli szervert egy MCP Streamable HTTP-kompatibilis alkalmazásban. A szerver lekérdezi az eszközöket címekhez, mobilitáshoz és közeli szolgáltatásokhoz.
Ez az útmutató a ROOTE által közzétett konfigurációt követi és a szerverkapcsolat ellenőrzését végzi. A menüpontok nevei kliensenként változhatnak; az URL-t, a transzportot és az eszközök sémaját szükséges ellenőrizni. A szerver tools/list listája a dokumentáció előtt változhat: használja a ténylegesen bejelentett képességeket.
Kliens kompatibilitás ellenőrzése
Az alkalmazásnak támogatnia kell egy távoli MCP Streamable HTTP szerver kezelését. Egy kizárólag helyi stdio szervereket támogató kliens nem tudja ezt az URL-t futtatható parancsként használni. Ellenőrizze, hogy a fiókja engedélyezi-e egyedi szerverek hozzáadását.
Ha az alkalmazás űrlapot kínál, adja meg a ROOTE-ot névként és a szerver URL-jét címként. Ha mcpServers formátumú fájlt fogad el, a ROOTE dokumentációja minimális konfigurációt javasol:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}ROOTE hivatalos csatlakozási beállítása
Név nélküli vagy hitelesített hozzáférés választása
A dokumentáció névtelen hozzáférést ír elő Authorization fejléc nélkül, a Free projekció és az API aktív korlátjai érvényesek. Hitelesített hozzáféréshez használja a kliens biztonságos mechanizmusát, amely a Bearer fejlécben továbbítja az Ön tokenjét.
Authorization: Bearer YOUR_API_TOKENA YOUR_API_TOKEN helyet kell kicserélni a kliens biztonságos konfigurációjában. Ne illessze be a tokent beszélgetésbe, nyilvános URL-be vagy cikkbe. Az érvénytelen vagy visszavont token nem váltódik át automatikusan névtelen hozzáféréssé.
Ellenőrizze, hogy az eszközök elérhetőek-e
Csatlakozás után nyissa meg a szerver eszközlistáját a kliensében. A ROOTE dokumentáció az initialize, tools/list majd tools/call sorrendet írja elő; a kompatibilis kliensek ezt általában önállóan végrehajtják. Használja a szerver által jelzett verziót és képességeket.
A szerver biztosítja a geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions és services_nearby eszközöket. Ezek hiánya kapcsolat-, felfedezés- vagy szolgáltatásfejlesztési problémára utalhat. Mindig ellenőrizze a szerver által bejelentett listát. A Journey és Departures még nem elérhetőek.
Végezzen el egy ismételhető első keresést
Kezdje egy pontos címmel: „Használja a ROOTE-ot a párizsi 10 rue de Rivoli cím keresésére Franciaországban. Mutassa meg az előjelölt helyeket és koordinátáikat.” Nézze meg az eszköz eredményét, ne csak a modell által megfogalmazott választ.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Ez a rész a hívás nevét és argumentumait mutatja; nem egy teljes HTTP kérés. Az Ön kliense csomagolja az MCP hívást. Ha több lehetséges jelölt visszatér, válassza ki a megfelelőt, mielőtt a környezetében keresne.
Ezután tesztelheti egy referencia pont körüli szállítást Bordeaux-ban. Az alábbi koordináták tesztelési célt szolgálnak, nem állítják, hogy a korábbi párizsi címről származnának.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Olvassa el az eredményt a következtetés előtt
Ellenőrizze a státuszt, visszakapott entitásokat, lefedettséget, figyelmeztetéseket és a szabályozott korlátokat. A részleges válasz hasznos információkat tartalmazhat. Az üres keresés nem bizonyítja a közlekedési eszközök fizikai hiányát a városban.
A teszt elvárt eredménye egy strukturált válasz vagy világos hiba, nem egy előre meghatározott megállószám. A források és lefedettség változhatnak. A megállók keresése nem adja vissza azok következő indulásait.
Csatlakozási hibák elhárítása
| Tünet | Hasznos ellenőrzés |
|---|---|
| Nincsenek eszközök felfedezve | Pontos URL, távoli transzport és kliens engedélyezés |
| Argumentum hiba | Típusok, megengedett értékek és bejelentett séma mezői |
| Hitelesítési hiba | Bearer érvényessége és fejléc beállítások |
| Korlát elérése | Aktív korlátok, újrapróbálati idő és hívások gyakorisága |
| Üres vagy részleges eredmény | Koordináták, szűrők, sugár, lefedettség és figyelmeztetések |
Különböztesse meg az üres eredményt az API hibától
Teljes asszisztens létrehozása egy cím alapján
MCP szerver szerepének megértése
Hamarosan: következő indulások és útvonaltervezés
A ROOTE tervezi MCP-jének bővítését a közelgő indulások és az útvonaltervezés funkcióival. Ezek a szolgáltatások hamarosan érkeznek, jelenleg még nem részei a MCP szerveren elérhető eszközöknek. Elérhetőségük esetén mindig ellenőrizze a szerver által bejelentett eszközöket, azok paramétereit és a ténylegesen visszaadott információkat, mielőtt járatot vagy utazást jelentene be.
Gyakori kérdések
Szükséges-e feltétlenül token?
A dokumentáció névtelen Free hozzáférést ír elő. Az Ön hozzáférésének korlátai és képességei az adott szolgáltatás által érvényesítettek.
Miért jelzi az asszisztens az indulási időt megálló keresés után?
A transit_nearby keresés nem adja vissza a következő indulásokat. Kérje meg az asszisztenst, hogy idézze fel a ténylegesen visszaadott adatokat és jelezze az hiányt.
Lehet-e tesztelni alkalmazás létrehozása nélkül?
Igen, egy kompatibilis kliens használatával, amely engedi távoli szerver hozzáadását és eszközeinek futtatását.