IA laguntzailea MCP ROOTE-ra konektatzeko, gehitu zerbitzari urruna https://mcp.roote.ai/mcp MCP Streamable HTTP-rekin bateragarri den aplikazio batean. Zerbitzariak irakurketarako tresnak eskaintzen ditu helbideetarako, mugikortasunerako eta zerbitzu inguruetarako.
Ikastaro honek ROOTE-k argitaratutako konfigurazioa eta zerbitzarira konektatzeko egiaztapena jarraitzen du. Menu izenak bezeroaren arabera aldatzen dira; URLa, garraioa eta tresnen eskema dira egiaztatu beharreko elementuak. Zerbitzariaren tools/list zerrenda dokumentazioaren aurretik aldatu daiteke: erabili benetan adierazitako gaitasunak.
Egiaztatu bezeroaren bateragarritasuna
Zure aplikazioak MCP zerbitzari urruna Streamable HTTP bidez onartu behar du. Lokalean soilik exekutatzen diren stdio zerbitzariak dituzten bezeroek ezin dute URL hau exekutatzeko komando bezala erabili. Gainera, egiaztatu zure kontuak zerbitzari pertsonalizatuak gehitzeko baimena duen.
Aplikazioak formulario bat badu, idatzi ROOTE izen gisa eta zerbitzariaren URL-a helbide gisa. McpServers formatuko fitxategi bat onartzen badu, ROOTE-k honako konfigurazio minimoa eskaintzen du:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}ROOTE-ren konexio konfigurazio ofiziala
Anonimoa edo autentifikatua sartzea hautatu
Dokumentazioak onartzen du anonimoa sartzea Authorization burukarik gabe, Free proiekzioaren eta API-ren aktibo dauden mugen menpe dagoena. Autentifikaziorako, erabili bezeroaren mekanismo segurua zure tokena Bearer buruki batean bidaltzeko.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN bezeroaren konfigurazio seguruan ordezkatu beharreko tokia da. Ez itsatsi tokena elkarrizketa batean, URL publiko batean edo artikulu batean. Token baliogabea edo baliogabetua ez da automatikoki ordezkatuko sarbide anonimo batekin.
Egiaztatu tresnak eskuragarri daudela
Konexioa egin ondoren, ireki zerbitzariaren tresnen zerrenda zure bezeroan. ROOTE dokumentazioak initialize, tools/list eta tools/call sekuentzia deskribatzen du; bezero bateragarriek normalean truke horiek automatikoki egiten dituzte zuretzat. Erabili zerbitzariak iragarria duen bertsioa eta gaitasunak.
Zerbitzariak geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions eta services_nearby tresnak eskaintzen ditu. Tresna hauek ez egoteak konektibitate arazoa, detekzioa edo zerbitzuaren aldaketa adierazten du. Beti egiaztatu zerbitzariak aurkezten duen zerrenda. Journey eta Departures oraindik ez dira bertan aurkeztuta.
Egin lehen bilaketa errepikakorra
Hasi helbide zehatz batekin: “Erabili ROOTE 10 rue de Rivoli, Paris, France bilatzeko. Adierazi hautagaiak eta haien koordinatuak.” Aztertu tresnaren emaitza, ez soilik modeloak idatzitako erantzuna.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Bloke honek dei baten izena eta argudioak erakusten ditu; ez da HTTP eskaera osoa. Zure bezeroak encapsulatzen du MCP dei hori. Hautagai posible ugari badira, aukeratu egokia puntua inguruko bilaketa aurretik.
Ondoren, probatu garraioa Bordeauxko erreferentzia puntutik inguratzen. Beheko koordinatuak testerako dira eta ez dute Parisko helbide aurrekoaren jatorri izan nahi.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Irakurri emaitza amaitu aurretik
Egiaztatu egoera, itzuli diren entitateak, estaldura, oharrak eta aplikatutako mugak. Emozio partzial batek informazio erabilgarria eduki dezake. Bilaketa huts batek ez du adierazten garraioa hutsik dagoenik hirian.
Probako emaitza espero daiteke egitura egokia duen erantzun bat edo akatsen adierazpen argi bat, ez geldialdi kopuru aurrez zehaztua. Iturriak eta estaldura alda daitezke. Geltokiak bilatzeak ez ditu euren hurrengo irteerak itzultzen.
Konexio akatsak konpondu
| Sintoma | Egiaztapen erabilgarria |
|---|---|
| Tresnarik aurkitu ez | URL zehatza, zerbitzari urruna eta bezeroaren baimena |
| Argudio akatsa | Mota, onartutako balioak eta eskema iragarriak dituen eremuak |
| Autentifikazio akatsa | Bearer baliozkotasuna eta buruki konfigurazioa |
| Muga gainditua | Mugak aktiboak, berrezarpen denbora eta deien maiztasuna |
| Emaitza hutsa edo partziala | Koordenatuak, iragazkiak, erradioa, estaldura eta oharrak |
Emaitza hutsa eta API errorea bereizi
Egin laguntzaile oso bat helbide batetik
Ulertu MCP zerbitzari baten rola
Etorkizunean: hurrengo irteerak eta ibilbide kalkulua
ROOTE-k bere MCP hurrengo irteerak eta ibilbide kalkulua sartzeko planak ditu. Funtzionalitate hauek etorkizunekoak dira eta oraindik ez daude MCP zerbitzariak eskaintzen dituen tresnen artean. Eskuragarri direnean, egiaztatu zer tresnak aurkeztu dituen zerbitzariak, haien argumentuak eta benetan itzultzen diren datuak, irteera edo ibilbide bat iragarri aurretik.
Maiz egiten diren galderak
Jeton bat behar da behingoz?
Dokumentazioak sarbide anonimo Free bat aurreikusten du. Zure sarbideak aplikatzen dituen mugak eta gaitasunak zerbitzuak ezarritakoak dira.
Zergatik nire laguntzaileak ordutegi bat iragarri du geltoki baten bilaketaren ondoren?
transit_nearby bilaketak ez ditu hurrengo irteerak ematen. Eskatu laguntzaileari egiazki itzuli diren datuak edozatu eta huts horren berri eman dezan.
Testeatu daiteke aplikaziorik egin gabe?
Bai, bezero bateragarri batekin, zerbitzari urruna gehitzeko eta haren tresnak exekutatzeko aukera ematen duena.