Hvordan koble en AI-assistent til MCP ROOTE?

For å koble en AI-assistent til MCP ROOTE, legg til den eksterne serveren https://mcp.roote.ai/mcp i en applikasjon som støtter MCP Streamable HTTP. Serveren tilbyr verktøy for lesing av adresser, mobilitet og tjenester i nærheten.

Denne veiledningen følger konfigurasjonen publisert av ROOTE og en tilkoblingssjekk mot serveren. Menyoverskriftene varierer etter klient; URL, transport og verktøyskjema er elementene som må kontrolleres. Listene tools/list fra serveren kan endres før dokumentasjonen oppdateres: bruk de funksjonene som faktisk annonseres.

Sjekk klientkompatibilitet

Applikasjonen din må godta en ekstern MCP-server via Streamable HTTP. En klient som kun støtter lokale stdio-servere kan ikke bruke denne URL-en som en kjørbar kommando. Sjekk også om kontoen din tillater å legge til tilpassede servere.

Hvis applikasjonen tilbyr et skjema, skriv inn ROOTE som navn og server-URL som adresse. Hvis den støtter en fil i mcpServers-format, tilbyr ROOTE-dokumentasjonen denne minimale konfigurasjonen:

{
  "mcpServers": {
    "roote": { "url": "https://mcp.roote.ai/mcp" }
  }
}

Offisiell ROOTE-tilkoblingskonfigurasjon

Velg anonym eller autentisert tilgang

Dokumentasjonen tillater anonym tilgang uten Authorization-header, underlagt Free-projeksjonen og API-begrensninger. For autentisert tilgang, bruk klientens sikre mekanisme for å sende token i en Bearer-header.

Authorization: Bearer YOUR_API_TOKEN

YOUR_API_TOKEN er en plassholder i klientens sikre konfigurasjon. Ikke lim inn token i en samtale, offentlig URL eller artikkel. Ugyldig eller tilbakekalt token erstattes ikke automatisk med anonym tilgang.

Bekreft at verktøyene er tilgjengelige

Etter tilkobling, åpne serverens verktøysliste i klienten. ROOTE-dokumentasjonen beskriver sekvensen initialize, tools/list, deretter tools/call; kompatible klienter håndterer vanligvis disse utvekslingene automatisk. Bruk versjon og funksjonalitet som serveren angir.

Serveren eksponerer geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions og services_nearby. Fravær av disse verktøyene indikerer et tilkoblingsproblem, oppdagelsesproblem eller en endring i tjenesten. Kontroller alltid listen som serveren annonserer. Journey og Departures er ennå ikke eksponert.

Utfør et første replikerbart søk

Start med en eksplisitt adresse: «Bruk ROOTE for å søke 10 rue de Rivoli, Paris, Frankrike. Oppgi kandidater funnet og deres koordinater.» Undersøk verktøyets resultat, ikke bare modellens tekstlige svar.

{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}

Denne blokken viser navnet og argumentene til et kall; det er ikke en full HTTP-forespørsel. Din klient pakker inn MCP-kallet. Om flere plausible kandidater returneres, velg riktig før du søker rundt punktet.

Du kan deretter teste transport rundt et referansepunkt i Bordeaux. Koordinatene nedenfor brukes til testing og er ikke ment å være basert på den tidligere paris-adressen.

{
  "name": "transit_nearby",
  "arguments": {
    "lat": 44.8416106,
    "lon": -0.5810938,
    "radius": 600,
    "modes": ["bus", "tram"],
    "limit": 10
  }
}

Les resultatet før konklusjon

Sjekk status, returnerte enheter, dekning, advarsler og anvendte begrensninger. Et delvis svar kan inneholde nyttig informasjon. Et tomt søk betyr ikke nødvendigvis fravær av transport i byen.

Forventet testresultat er et strukturert svar eller en eksplisitt feil, ikke et forhåndsdefinert antall stopp. Kilder og dekning kan endres. Søk etter stopp gir ikke deres neste avganger.

Feilsøk tilkoblingsfeil

Skille mellom tomt resultat og API-feil

Lag en fullstendig assistent fra en adresse

Forstå rollen til en MCP-server

Kommer snart: kommende avganger og ruteplanlegging

ROOTE planlegger å utvide MCP med kommende avganger og ruteplanlegging. Disse funksjonene kommer snart og er ikke ennå en del av de verktøyene som MCP-serveren eksponerer. Når de blir tilgjengelige, sjekk hvilke verktøy serveren annonserer, deres argumenter og informasjon som faktisk returneres før du publiserer en passering eller reise.

Ofte stilte spørsmål

Trenger jeg nødvendigvis en token?

Dokumentasjonen tillater anonym Free-tilgang. Begrensninger og kapasiteter for ditt tilgangsnivå styres av tjenesten.

Hvorfor sier assistenten min et tidspunkt etter søk på stopp?

Et transit_nearby-søk gir ikke kommende avganger. Be assistenten oppgi faktisk returnerte data og påpeke mangelen.

Kan jeg teste uten å lage en applikasjon?

Ja, med en kompatibel klient som tillater å legge til ekstern server og kjøre dens verktøy.