For at forbinde en AI-assistent til MCP ROOTE tilføj fjernserveren https://mcp.roote.ai/mcp i en applikation, der understøtter MCP Streamable HTTP. Serveren eksponerer læseværktøjer for adresser, mobilitet og nærliggende serviceydelser.
Denne vejledning følger konfigurationen offentliggjort af ROOTE og en forbindelsestest til serveren. Menunavne varierer efter klient; URL, transport og værktøjernes skema er det, der skal verificeres. Serverens tools/list kan ændre sig før dokumentationen: brug de faktisk annoncerede kapaciteter.
Kontrollér klientkompatibilitet
Din applikation skal understøtte en fjern MCP-server via Streamable HTTP. En klient begrænset til lokale stdio-servere kan ikke bruge denne URL som en eksekverbar kommando. Tjek også om din konto tillader tilføjelse af brugerdefinerede servere.
Hvis applikationen har en formular, angiv ROOTE som navn og serverens URL som adresse. Hvis den accepterer en fil i mcpServers-format, foreslår ROOTE-dokumentationen denne minimale konfiguration:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Officiel ROOTE-forbindelses konfiguration
Vælg anonym eller autentificeret adgang
Dokumentationen beskriver anonym adgang uden Authorization-header, underlagt Free-planens begrænsninger og API'ens aktive grænser. Til autentificeret adgang brug klientens sikre mekanisme til at sende dit token i en Bearer-header.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN er en plads i klientens sikre konfiguration, der skal udskiftes. Indsæt ikke token i samtaler, offentlige URLs eller artikler. Et ugyldigt eller tilbagekaldt token bliver ikke automatisk erstattet af anonym adgang.
Bekræft, at værktøjerne er tilgængelige
Efter tilslutning åbn serverens værktøjsliste i din klient. ROOTE-dokumentationen beskriver processen initialize, tools/list og tools/call; kompatible klienter håndterer normalt disse kald automatisk. Benyt serverens version og oplyste kapaciteter.
Serveren udstiller geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions og services_nearby. Manglen på disse værktøjer indikerer forbindelse- eller opdagelsesproblemer eller en tjenesteopdatering. Kontroller altid den liste, serveren annoncerer. Journey og Departures er endnu ikke udstillet.
Foretag en reproducerbar første søgning
Start med en præcis adresse: 'Brug ROOTE for at søge 10 rue de Rivoli, Paris, Frankrig. Angiv fundne kandidater og deres koordinater.' Undersøg værktøjets output, ikke kun modellens skrevne svar.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Denne blok illustrerer navnet og argumenterne til et kald; det er ikke en komplet HTTP-forespørgsel. Din klient indkapsler MCP-kaldet. Hvis flere plausible kandidater returneres, vælg den korrekte inden du søger omkring punktet.
Du kan derefter teste transport omkring et referencepunkt i Bordeaux. Koordinaterne nedenfor bruges til testen og stammer ikke fra den tidligere nævnte adresse i Paris.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Læs resultatet inden konklusion
Tjek status, returnerede enheder, dækning, advarsler og anvendte grænser. Et delvist svar kan indeholde nyttige oplysninger. En tom søgning beviser ikke fysisk mangel på transport i byen.
Det forventede testresultat er en struktureret respons eller en tydelig fejl, ikke et forudbestemt antal stop. Kilder og dækning kan ændre sig. Søgning efter stop inkluderer ikke deres kommende afgange.
Fejlfinding af tilslutningsproblemer
| Symptom | Nyttig kontrol |
|---|---|
| Ingen værktøjer opdaget | Nøjagtig URL, fjerntransport og klienttilladelse |
| Argumentfejl | Typer, tilladte værdier og skemafelter |
| Godkendelsesfejl | Gyldighed af Bearer-token og header-konfiguration |
| Grænse overskredet | Aktive grænser, tilbageførselstid og kaldfrekvens |
| Tomt eller delvist resultat | Koordinater, filtre, radius, dækning og advarsler |
Skel mellem tomt resultat og API-fejl
Opret en fuld assistent ud fra en adresse
Kommende: næste afgange og ruteplanlægning
ROOTE planlægger at udvide sin MCP med kommende afgange og ruteplanlægning. Disse funktioner er på vej og en del af de værktøjer, der endnu ikke findes på MCP-serveren. Når de bliver tilgængelige, skal du kontrollere de udstillede værktøjer, deres argumenter og de faktisk returnerede oplysninger, før du annoncerer en passage eller rejse.
Ofte stillede spørgsmål
Er et token obligatorisk?
Dokumentationen tillader anonym Free-adgang. Dine adgangsgrænser og kapaciteter bestemmes af den anvendte tjeneste.
Hvorfor oplyser min assistent en tid efter en stop-søgning?
En transit_nearby-søgning returnerer ikke kommende afgange. Bed assistenten om at angive faktisk returnerede data og notere denne manglende information.
Kan man teste uden at oprette en applikation?
Ja, med en kompatibel klient der tillader tilføjelse af en fjernserver og afvikling af dens værktøjer.