Chcete-li připojit IA asistenta k MCP ROOTE, přidejte vzdálený server https://mcp.roote.ai/mcp do aplikace kompatibilní s MCP Streamable HTTP. Server nabízí nástroje pro čtení adres, mobility a služeb v okolí.
Tento tutoriál sleduje konfiguraci publikovanou ROOTE a ověření připojení k serveru. Názvy menu se mění podle klienta; URL, transport a schéma nástrojů jsou prvky ke kontrole. Seznam tools/list serveru se může měnit před dokumentací: používejte skutečně oznamované funkce.
Ověření kompatibility klienta
Vaše aplikace musí podporovat vzdálený MCP server přes Streamable HTTP. Klient omezený na lokální servery stdio nemůže tuto URL použít jako spustitelný příkaz. Také ověřte, zda váš účet umožňuje přidávat vlastní servery.
Pokud aplikace nabízí formulář, zadejte ROOTE jako název a URL serveru jako adresu. Pokud akceptuje soubor ve formátu mcpServers, dokumentace ROOTE nabízí tuto minimální konfiguraci:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Oficiální konfigurace připojení ROOTE
Volba anonymního nebo autentizovaného přístupu
Dokumentace umožňuje anonymní přístup bez hlavičky Authorization, podléhající projekci Free a aktivním limitům API. Pro autentizovaný přístup použijte zabezpečený mechanismus klienta pro předání tokenu v hlavičce Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN je místo pro nahrazení ve zabezpečené konfiguraci klienta. Nevkládejte token do konverzace, veřejné URL nebo článku. Neplatný nebo zrušený token se automaticky nenahradí anonymním přístupem.
Potvrzení dostupnosti nástrojů
Po připojení otevřete v klientu seznam nástrojů serveru. Dokumentace ROOTE popisuje sekvenci initialize, tools/list a poté tools/call; kompatibilní klienti tyto výměny provádějí automaticky. Použijte verzi a funkce oznámené serverem.
Server vystavuje geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions a services_nearby. Nepřítomnost těchto nástrojů znamená problém s připojením, objevováním nebo změnu služby. Vždy kontrolujte seznam oznamovaný serverem. Journey a Departures dosud nejsou zveřejněny.
Proveďte první reprodukovatelné vyhledávání
Začněte explicitní adresou: „Použij ROOTE k vyhledání 10 rue de Rivoli, Paříž, Francie. Uveď nalezené kandidáty a jejich souřadnice.“ Prohlédněte si výsledek nástroje, nejen odpověď modelu.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Tato sekce ilustruje název a argumenty volání; nejde o kompletní HTTP požadavek. Váš klient zapouzdří MCP volání. Pokud se vrátí více vhodných kandidátů, vyberte ten správný před dalším vyhledáváním v okolí bodu.
Poté můžete testovat transport kolem referenčního bodu v Bordeaux. Níže uvedené souřadnice slouží k testu a nepocházejí z předchozí pařížské adresy.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Přečtěte výsledek před závěrem
Zkontrolujte stav, vrácené entity, pokrytí, varování a aplikované limity. Částečná odpověď může obsahovat užitečné informace. Prázdné vyhledávání nedokazuje fyzickou nepřítomnost dopravy ve městě.
Očekávaný výsledek testu je strukturovaná odpověď nebo jasná chyba, nikoli předem stanovený počet zastávek. Zdroje a pokrytí se mohou měnit. Vyhledávání zastávek nevrací jejich nadcházející odjezdy.
Řešení chyb připojení
| Příznak | Užitečná kontrola |
|---|---|
| Nebyly nalezeny žádné nástroje | Přesná URL, vzdálený transport a oprávnění klienta |
| Chyba argumentů | Typy, povolené hodnoty a pole ve zveřejněném schématu |
| Chyba autentizace | Platnost Bearer tokenu a konfigurace hlaviček |
| Limit dosažen | Aktivní limity, doba obnovení a frekvence volání |
| Prázdný nebo částečný výsledek | Souřadnice, filtry, poloměr, pokrytí a varování |
Rozlišení mezi prázdným výsledkem a chybou API
Vytvoření kompletního asistenta z adresy
Co přijde: nadcházející odjezdy a výpočet trasy
ROOTE plánuje rozšířit svůj MCP o nadcházející odjezdy a výpočet trasy. Tyto funkce jsou připravovány a dosud nejsou součástí nástrojů zveřejněných serverem MCP. Po jejich zpřístupnění zkontrolujte nástroje oznamované serverem, jejich argumenty a skutečně vrácené informace před oznámením průchodu nebo cesty.
Často kladené otázky
Je token nezbytný?
Dokumentace poskytuje anonymní Free přístup. Limity a možnosti vašeho přístupu závisí na aplikovaných pravidlech služby.
Proč můj asistent oznamuje jízdní řád po vyhledání zastávky?
Vyhledávání transit_nearby neposkytuje nadcházející odjezdy. Požádejte asistenta, aby uvedl skutečně vrácená data a upozornil na jejich absenci.
Je možné testovat bez vytvoření aplikace?
Ano, s kompatibilním klientem, který umožňuje přidat vzdálený server a spouštět jeho nástroje.