Lai pieslēgtu mākslīgā intelekta palīgu MCP ROOTE, pievienojiet attālo serveri https://mcp.roote.ai/mcp lietotnē, kas atbalsta MCP Streamable HTTP. Serveris nodrošina rīkus adrešu, mobilitātes un tuvumā esošo pakalpojumu lasīšanai.
Šis pamācības materiāls seko ROOTE publicētajai konfigurācijai un pārbauda savienojumu ar serveri. Menu nosaukumi var atšķirties atkarībā no klienta; pārbaudāmas ir URL, transports un rīku shēma. Servera rīku saraksts tools/list var mainīties pirms dokumentācijas atjaunošanas: izmantojiet faktiski pieejamās iespējas.
Pārbaudiet klienta saderību
Jūsu lietotnei jāatbalsta attālais MCP serveris caur Streamable HTTP. Klients, kas strādā tikai ar lokāliem stdio serveriem, nevar izmantot šo URL kā izpildāmu komandu. Pārbaudiet arī, vai jūsu kontā ir atļauja pievienot pielāgotus serverus.
Ja lietotne piedāvā formu, ievadiet ROOTE kā nosaukumu un servera URL kā adresi. Ja tā pieņem mcpServers formāta failu, ROOTE dokumentācija piedāvā šādu minimālo konfigurāciju:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}ROOTE oficiālā pieslēguma konfigurācija
Izvēlieties anonīmu vai autentificētu piekļuvi
Dokumentācija paredz anonīmu piekļuvi bez Authorization galvenes, kas pakļauta Free projektam un API darbības ierobežojumiem. Autentificētai piekļuvei izmantojiet klienta drošo mehānismu, lai nodotu savu žetonu Bearer galvenē.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN ir aizvietošanas vieta klienta drošajā konfigurācijā. Neielīmējiet žetonu sarunā, publiskā URL vai rakstā. Derīgs vai atcelts žetons netiek automātiski aizstāts ar anonīmu piekļuvi.
Pārliecinieties, ka rīki ir pieejami
Pēc pieslēgšanās atveriet servera rīku sarakstu savā klientā. ROOTE dokumentācija apraksta secību initialize, tools/list un tools/call; saderīgi klienti šo procesu parasti veic automātiski. Izmantojiet servera paziņoto versiju un iespējas.
Serveris nodrošina rīkus geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions un services_nearby. Šo rīku trūkums norāda uz savienojuma, atklāšanas vai pakalpojuma izmaiņām. Vienmēr pārbaudiet servera piedāvāto rīku sarakstu. Journey un Departures vēl nav pieejami.
Veiciet pirmo reproducējamu meklēšanu
Sāciet ar konkrētu adresi: “Izmanto ROOTE, lai meklētu 10 rue de Rivoli, Parīze, Francija. Norādi atrastos kandidātus un to koordinātas.” Ievērojiet rīka rezultātu, ne tikai modeļa sagatavoto atbildi.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Šis bloks ilustrē zvana nosaukumu un argumentus; tas nav pilns HTTP pieprasījums. Jūsu klients ievieto MCP zvanu. Ja atgriežas vairāki derīgi kandidāti, izvēlieties pareizo pirms meklēšanas apkārtnē.
Pēc tam varat pārbaudīt transportu apkārtnē ap atsauces punktu Bordo. Zemāk norādītās koordinātas ir testa nolūkiem un neapgalvo, ka tās nākta no iepriekšminētās Parīzes adreses.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Izlasiet rezultātu pirms secināšanas
Pārbaudiet statusu, atgrieztās vienības, pārklājumu, brīdinājumus un piemērotos ierobežojumus. Daļējs rezultāts var saturēt noderīgu informāciju. Tukša meklēšana neapliecina fizisku transporta neesamību pilsētā.
Sagaidāmais testa rezultāts ir strukturēta atbilde vai skaidra kļūda, nevis iepriekš definēts pieturu skaits. Avoti un pārklājums var mainīties. Pieturu meklēšana neatgriež nākamos to izbraucienus.
Novērst savienojuma kļūdas
| Simptoms | Noderīga pārbaude |
|---|---|
| Nekādi rīki netika atrasti | Precīzs URL, attālais transports un klienta atļaujas |
| Argumentu kļūda | Atļautie tipi, vērtības un paziņotā shēmas lauki |
| Autentifikācijas kļūda | Bearer derīgums un galveņu konfigurācija |
| Sasniegts ierobežojums | Aktīvi ierobežojumi, atkārtošanas aizture un zvanu biežums |
| Tukšs vai daļējs rezultāts | Koordinātas, filtri, rādiuss, pārklājums un brīdinājumi |
Atšķirt tukšu rezultātu no API kļūdas
Izveidot pilnvērtīgu palīgu no adreses
Nākotnē: nākamie izbraucieni un maršruta aprēķins
ROOTE plāno paplašināt savu MCP ar nākamajiem izbraucieniem un maršruta aprēķinu. Šīs funkcijas vēl nav pieejamas un pagaidām nav iekļautas MCP servera rīkos. Kad šīs funkcijas kļūs pieejamas, pārbaudiet servera piedāvātos rīkus, to parametrus un faktiski atgriezto informāciju pirms paziņot par braucienu vai maršrutu.
Bieži uzdotie jautājumi
Vai noteikti vajag žetonu?
Dokumentācija paredz anonīmu Free piekļuvi. Jūsu piekļuves ierobežojumi un iespējas atbilst pakalpojuma noteiktajiem nosacījumiem.
Kāpēc mans palīgs rāda grafiku pēc pieturas meklēšanas?
Meklēšana transit_nearby nesniedz nākamos izbraucienus. Lūdziet palīgam nosaukt reāli saņemtos datus un norādīt šo trūkumu.
Vai var testēt bez lietotnes izveides?
Jā, izmantojot saderīgu klientu, kas ļauj pievienot attālo serveri un izmantot tā rīkus.