Norėdami sujungti dirbtinio intelekto asistentą su MCP ROOTE, pridėkite nuotolinį serverį https://mcp.roote.ai/mcp į programą, suderinamą su MCP Streamable HTTP. Serveris teikia skaitymo įrankius adresams, mobilumui ir paslaugoms netoliese.
Šis vadovas atitinka ROOTE paskelbtą konfigūraciją ir ryšio su serveriu patikrinimą. Meniu pavadinimai skiriasi priklausomai nuo kliento; svarbu tikrinti URL, transportavimą ir įrankių schemą. Serverio įrankių sąrašas tools/list gali keistis anksčiau nei dokumentacija – naudokite faktiškai paskelbtas galimybes.
Patikrinkite kliento suderinamumą
Jūsų programa turi palaikyti nuotolinį MCP serverį Streamable HTTP būdu. Klientas, skirtas tik vietiniams stdio serveriams, negali naudoti šio URL kaip vykdomos komandos. Taip pat patikrinkite, ar jūsų paskyra leidžia pridėti pasirinktinius serverius.
Jei programa turi formą, įrašykite ROOTE kaip pavadinimą ir serverio URL kaip adresą. Jei ji priima mcpServers formato failą, ROOTE dokumentacijoje pateikta minimali konfigūracija:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Oficiali ROOTE jungimosi konfigūracija
Pasirinkite anoniminį arba autentifikuotą prieigą
Dokumentacija numato anoniminę prieigą be Authorization antraštės, taikomą Free projekcijai ir aktyvioms API riboms. Autentifikuotai prieigai naudokite kliento saugų mechanizmą perduoti savo žetoną Bearer antraštėje.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN yra vieta, kurią turite pakeisti kliento saugioje konfigūracijoje. Nelipdykite žetono pokalbyje, viešame URL ar straipsnyje. Nepgaliojantis ar atšauktas žetonas nėra automatiškai pakeičiamas anonimine prieiga.
Patvirtinkite, kad įrankiai yra pasiekiami
Prisijungę atidarykite serverio įrankių sąrašą savo kliente. ROOTE dokumentacija aprašo initialize, tools/list ir tools/call seką; suderinami klientai tai paprastai atlieka automatiškai. Naudokite serverio nurodytą versiją ir galimybes.
Serveris teikia įrankius geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions ir services_nearby. Šių įrankių nebuvimas rodo ryšio, aptikimo problemą arba paslaugos pokyčius. Visada tikrinkite serverio paskelbtą sąrašą. Journey ir Departures šiuo metu nėra pateikti.
Atlikite pirmą pakartojamą paiešką
Pradėkite nuo aiškaus adreso: „Naudok ROOTE paieškai 10 rue de Rivoli, Paris, France. Nurodyk rastus kandidatus ir jų koordinates.“ Peržvelkite įrankio rezultatą, ne tik modelio sugeneruotą atsakymą.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Šis blokas iliustruoja iškvietimo pavadinimą ir argumentus; tai nėra pilnas HTTP užklausos pavyzdys. Jūsų klientas supakuoja MCP iškvietimą. Jei gaunate kelis galimus kandidatus, pasirinkite tinkamą prieš tęsiant paiešką aplink tą tašką.
Vėliau galite išbandyti transportą aplink referencinį tašką Bordo mieste. Žemiau pateiktos koordinatės naudojamos testui ir nėra susietos su ankstesniu Paryžiaus adresu.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Perskaitykite rezultatą prieš darydami išvadas
Patikrinkite būseną, grąžintas entites, aprėptį, įspėjimus ir taikomas ribas. Dalis atsakyto turinio gali būti naudinga. Tuščia paieška nereiškia, kad mieste nėra transporto.
Tikėtinas testo rezultatas yra struktūruotas atsakymas arba aiški klaida, o ne nustatytas stotelių skaičius. Šaltiniai ir aprėptis gali keistis. Stotelių paieška negrąžina jų artimiausių išvykimų.
Spręsti ryšio klaidas
| Simptomas | Naudingas patikrinimas |
|---|---|
| Įrankiai nerasta | Teisingas URL, nuotolinis transportas ir kliento leidimas |
| Argumentų klaida | Leidžiami tipai, reikšmės ir nurodytos schemos laukai |
| Autentifikacijos klaida | Bearer galiojimas ir antraščių konfigūracija |
| Pasiektas limitas | Aktyvios ribos, atsigavimo laikas ir kvietimų dažnumas |
| Tuščias arba dalinis rezultatas | Koordinatės, filtrai, spindulys, aprėptis ir įspėjimai |
Atskirti tuščią rezultatą nuo API klaidos
Sukurkite pilną asistentą iš adreso
Suprasti MCP serverio vaidmenį
Būsimi patobulinimai: artimiausi išvykimai ir maršruto skaičiavimas
ROOTE planuoja išplėsti MCP prie artėjančių išvykimų ir maršruto skaičiavimo. Šios funkcijos dar nėra ir nėra šiuo metu MCP serverio teikiamų įrankių dalis. Jas įdiegus, patikrinkite serverio paskelbtus įrankius, jų argumentus ir faktiškai grąžintą informaciją, prieš skelbiant maršrutą ar kelionę.
Dažniausiai užduodami klausimai
Ar visada reikia žetono?
Dokumentacija numato nemokamą anoniminę prieigą. Jūsų prieigos ribos ir galimybės atitinka paslaugos taikomas taisykles.
Kodėl mano asistentas rodo tvarkaraštį po stotelės paieškos?
transit_nearby paieška nepateikia artimiausių išvykimų. Paprašykite asistento nurodyti tikrą grąžintą informaciją ir pažymėti šį skirtumą.
Ar galima išbandyti be programos sukūrimo?
Taip, naudojant suderinamą klientą, leidžiantį pridėti nuotolinį serverį ir naudoti jo įrankius.