Para ikonekta ang isang AI assistant sa MCP ROOTE, idagdag ang malayuang server na https://mcp.roote.ai/mcp sa isang aplikasyon na compatible sa MCP Streamable HTTP. Nagbibigay ang server ng mga tool para sa pagbabasa ng mga address, mga mobility, at mga serbisyo sa paligid.
Sinasaliksik ng tutorial na ito ang setup na inilathala ng ROOTE at kasama ang isang connection check sa server. Nag-iiba ang mga pangalan ng menu depende sa client; ang URL, transport, at schema ng mga tool ang mga elementong dapat i-verify. Maaaring magbago ang listahan tools/list ng server bago ang dokumentasyon: gamitin ang mga kapasidad na tunay na inia-advertise.
Suriin ang pagiging compatible ng kliyente
Dapat tanggapin ng iyong aplikasyon ang isang malayuang MCP server gamit ang Streamable HTTP. Ang kliyenteng limitado lamang sa lokal na stdio servers ay hindi maaaring gamitin ang URL na ito bilang isang executable na utos. Suriin din kung pinapayagan ng iyong account ang pagdaragdag ng pasadyang server.
Kung may form ang aplikasyon, ilagay ang ROOTE bilang pangalan at ang URL ng server bilang address. Kung tinatanggap nito ang isang mcpServers na file format, nagmumungkahi ang dokumentasyon ng ROOTE ng ganitong minimum na setup:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Opisyal na setup para sa koneksyon sa ROOTE
Piliin ang anonymous o authenticated na access
Nagbibigay ang dokumentasyon ng anonymous access na walang Authorization header, na inaayon sa Free projection at sa mga aktibong limitasyon ng API. Para sa authenticated access, gamitin ang secure na mekanismo ng kliyente upang ipadala ang iyong token sa Bearer header.
Authorization: Bearer YOUR_API_TOKENAng YOUR_API_TOKEN ay isang placeholder na kailangang palitan sa secure na setup ng kliyente. Huwag idikit ang token sa usapan, pampublikong URL o artikulo. Ang invalid o na-revoke na token ay hindi awtomatikong papalitan ng anonymous access.
Kumpirmahin na available ang mga tool
Pagkatapos ng koneksyon, buksan ang listahan ng mga tool ng server sa iyong kliyente. Inilalarawan ng dokumentasyon ng ROOTE ang sequence na initialize, tools/list at tools/call; karaniwang ginagawa ito ng compatible na mga kliyente para sa iyo. Gamitin ang bersyon at kakayahan na inihayag ng server.
Ipinapakita ng server ang geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions, at services_nearby. Ang kakulangan ng mga tool na ito ay nagpapahiwatig ng problema sa koneksyon, discovery, o pagbabago sa serbisyo. Palaging i-verify ang listahan na inai-anunsyo ng server. Hindi pa ipinapakita ang Journey at Departures sa listahan.
Gumawa ng isang unang ulit-ulit na paghahanap
Magsimula sa isang malinaw na address: "Gamitin ang ROOTE para maghanap ng 10 rue de Rivoli, Paris, France. Ipakita ang mga kandidato na nahanap at ang kanilang mga koordinasyon." Suriin ang resulta ng tool, hindi lang ang sagot na ginawa ng modelo.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Ipinapakita ng block na ito ang pangalan at mga argumento ng isang tawag; hindi ito kumpletong HTTP request. Sinasakup ng iyong kliyente ang tawag sa MCP. Kung maraming posibleng kandidato ang bumalik, piliin ang tama bago maghanap sa paligid ng lugar.
Maaari mong subukan ang transportasyon sa paligid ng isang reference point sa Bordeaux. Ginagamit ang mga koordinatong nasa ibaba para sa pagsubok at hindi nangangahulugang galing ito sa naunang address sa Paris.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Basahin ang resulta bago magtapos
Suriin ang status, mga naibalik na entidad, coverage, mga babala at mga ipinatupad na limitasyon. Maaaring maglaman ang partial na sagot ng kapaki-pakinabang na impormasyon. Ang walang laman na paghahanap ay hindi nagpapatunay ng kawalan ng pisikal na transportasyon sa lungsod.
Inaasahang resulta ng pagsubok ay isang istrukturadong sagot o malinaw na error, hindi isang paunang tinukoy na bilang ng mga hintuan. Maaaring magbago ang mga pinagmulan at coverage. Ang paghahanap ng hintuan ay hindi nagpapakita ng mga susunod na pag-alis nito.
Ayusin ang mga error sa koneksyon
| Sintomas | Mahahalagang pagsusuri |
|---|---|
| Walang natuklasang tool | Eksaktong URL, malayuang transport at pahintulot sa kliyente |
| Error sa mga argumento | Mga uri, pinapayagang halaga at mga field ng inihayag na schema |
| Error sa awtentikasyon | Kahusayan ng Bearer at setup ng mga header |
| Naabot ang limitasyon | Aktibong mga limitasyon, delay sa pag-resume at dalas ng mga tawag |
| Walang laman o partial na resulta | Mga koordinasyon, filter, radius, coverage at mga babala |
Ihiwalay ang walang laman na resulta mula sa error ng API
Gumawa ng kumpletong assistant mula sa isang address
Unawain ang papel ng isang MCP server
Darating: mga susunod na pag-alis at pagpaplano ng ruta
Planong palawakin ng ROOTE ang kanyang MCP para sa mga susunod na Departure at pagku-compute ng ruta. Ang mga tampok na ito ay darating pa lamang at hindi pa bahagi ng mga tool na kasalukuyang ipinapakita ng MCP server. Sa kanilang availability, siguraduhing suriin ang mga tool na inia-advertise ng server, ang kanilang mga argumento, at ang mga impormasyong totoong naibabalik bago ianunsyo ang isang stop o isang Journey.
Mga madalas itanong
Kailangan ba ng token?
Nagbibigay ang dokumentasyon ng libreng anonymous na access. Ang mga limitasyon at kakayahan ng iyong access ay naaayon sa serbisyong ginagamit.
Bakit nagsasabi ang assistant ng iskedyul pagkatapos ng paghahanap ng hintuan?
Ang transit_nearby na paghahanap ay hindi nagbibigay ng mga susunod na pag-alis. Sabihin sa assistant na ipakita ang totoong data na naibalik at sabihin ang kawalan nito.
Puwede bang subukan nang hindi gumagawa ng aplikasyon?
Oo, sa isang compatible na kliyente na nagpapahintulot magdagdag ng malayuang server at gamitin ang mga tool nito.