För att ansluta en AI-assistent till MCP ROOTE, lägg till fjärrservern https://mcp.roote.ai/mcp i en applikation som är kompatibel med MCP Streamable HTTP. Servern tillhandahåller läsverktyg för adresser, mobilitet och närliggande tjänster.
Denna handledning följer den konfiguration som publicerats av ROOTE och en anslutningskontroll till servern. Menynamnet kan variera med klient; det är URL:en, transporten och verktygsschemat som ska kontrolleras. Serverns lista tools/list kan ändras före dokumentationen: använd de faktiskt annonserade funktionerna.
Kontrollera klientens kompatibilitet
Din applikation måste kunna ansluta till en fjärr-MCP-server via Streamable HTTP. En klient begränsad till lokala stdio-servrar kan inte använda denna URL som en exekverbar kommando. Kontrollera också om ditt konto tillåter att lägga till anpassade servrar.
Om applikationen erbjuder ett formulär, ange ROOTE som namn och serverns URL som adress. Om den accepterar en fil i mcpServers-format föreslår ROOTE-dokumentationen denna minimala konfiguration:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Officiell ROOTE-anslutningskonfiguration
Välj anonym eller autentiserad åtkomst
Dokumentationen tillåter anonym åtkomst utan Authorization-header, vilket är begränsat till Free-projektionen och API:ets aktiva gränser. För autentiserad åtkomst använder du klientens säkra mekanism för att skicka din token i en Bearer-header.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN är en plats för att ersätta i klientens säkra konfiguration. Klistra inte in token i en chatt, offentlig URL eller artikel. En ogiltig eller återkallad token ersätts inte automatiskt med anonym åtkomst.
Bekräfta att verktygen är tillgängliga
Efter anslutningen, öppna listan över serverns verktyg i din klient. ROOTE-dokumentationen beskriver sekvensen initialize, tools/list sedan tools/call; kompatibla klienter hanterar vanligtvis dessa utbyten åt dig. Använd version och kapacitet som servern rapporterar.
Servern exponerar geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions och services_nearby. Avsaknad av dessa verktyg indikerar ett anslutningsproblem, upptäcktsproblem eller en förändring av tjänsten. Kontrollera alltid listan som annonseras av servern. Journey och Departures exponeras ännu inte där.
Gör en första reproducerbar sökning
Börja med en tydlig adress: "Använd ROOTE för att söka 10 rue de Rivoli, Paris, Frankrike. Lista de hittade kandidaterna och deras koordinater." Undersök verktygets resultat, inte bara det svar som modellen genererat.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Detta block visar namn och argument för ett anrop; det är inte en fullständig HTTP-förfrågan. Din klient kapslar in MCP-anropet. Om flera rimliga kandidater återkommer, välj rätt innan du söker runt punkten.
Du kan sedan testa transport runt en referenspunkt i Bordeaux. Koordinaterna nedan är för test och representerar inte adressen i Paris ovan.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Läs resultatet innan du drar slutsatser
Kontrollera status, returnerade entiteter, täckning, varningar och tillämpade begränsningar. Ett delvis svar kan innehålla användbar information. En tom sökning visar inte nödvändigtvis att det saknas kollektivtrafik i staden.
Det väntade testresultatet är ett strukturerat svar eller ett explicit fel, inte ett förutbestämt antal hållplatser. Källor och täckning kan förändras. Sökning efter hållplatser visar inte deras kommande avgångar.
Felsök anslutningsfel
| Symptom | Nytta av kontroll |
|---|---|
| Inga verktyg upptäckta | Exakt URL, fjärrtransport och klientbehörighet |
| Argumentfel | Typer, tillåtna värden och schemafält enligt servern |
| Autentiseringsfel | Bearertoken giltighet och header-inställningar |
| Begränsning nådd | Aktiva gränser, återupptagningstid och anropsfrekvens |
| Tomt eller delvis resultat | Koordinater, filter, radie, täckning och varningar |
Skilj mellan tomt resultat och API-fel
Bygg en komplett assistent från en adress
Kommande: kommande avgångar och ruttberäkning
ROOTE planerar att utöka sin MCP med Kommande Avgångar och Reseberäkning. Dessa funktioner är på väg och ingår ännu inte i de verktyg som för närvarande exponeras av MCP-servern. När de blir tillgängliga, kontrollera verktygen som annonseras av servern, deras argument och de faktiska återgivna uppgifterna innan du meddelar en passage eller resa.
Vanliga frågor
Är en token alltid nödvändig?
Dokumentationen tillåter anonym Free-åtkomst. Begränsningar och kapaciteter för din åtkomst styrs av tjänsten.
Varför visar min assistent en tidtabell efter en hållplatssökning?
En transit_nearby-sökning ger inte kommande avgångar. Be assistenten att redovisa faktiskt returnerad data och påpeka detta saknade.
Kan man testa utan att skapa en applikation?
Ja, med en kompatibel klient som stödjer att lägga till en fjärrserver och köra dess verktyg.