# Hoe verbind je een AI-assistent met het MCP ROOTE?

> Verbind een assistent met het MCP ROOTE: server-URL, HTTP-configuratie, eerste zoekopdracht, resultaten lezen en foutoplossing.

Source: https://www.roote.ai/nl/guides/hoe-verbind-je-een-ai-assistent-met-het-mcp-roote/
Language: nl
Author: ROOTE

Om een AI-assistent te verbinden met het MCP ROOTE, voeg je de externe server https://mcp.roote.ai/mcp toe in een applicatie die MCP Streamable HTTP ondersteunt. De server biedt tools voor het lezen van adressen, mobiliteit en nabijheidsdiensten.

Deze handleiding volgt de door ROOTE gepubliceerde configuratie en een verbindingscontrole met de server. De menu-indelingen verschillen per cliënt; de URL, het transport en het schema van de tools zijn de te controleren elementen. De lijst tools/list van de server kan veranderen vóór de documentatie: gebruik de daadwerkelijk aangekondigde mogelijkheden.

## Controleer de compatibiliteit van de client

Uw applicatie moet een externe MCP-server via Streamable HTTP accepteren. Een client die beperkt is tot lokale stdio-servers kan deze URL niet gebruiken als uitvoerbare opdracht. Controleer ook of uw account het toevoegen van aangepaste servers toestaat.

Als de applicatie een formulier biedt, vul dan ROOTE in als naam en de server-URL als adres. Als een bestand in het mcpServers-formaat wordt geaccepteerd, biedt de ROOTE-documentatie deze minimale configuratie:

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

[Officiële ROOTE verbindingsconfiguratie](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Kies anonieme of geauthenticeerde toegang

De documentatie voorziet in anonieme toegang zonder Authorization-header, onderworpen aan de Free projectie en de actieve API-limieten. Voor geauthenticeerde toegang gebruikt u het beveiligde mechanisme van de client om uw token via een Bearer-header te versturen.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN is een plaatsaanduiding die u moet vervangen in de beveiligde clientconfiguratie. Plak het token niet in een gesprek, publieke URL of artikel. Een ongeldig of ingetrokken token wordt niet automatisch vervangen door anonieme toegang.

## Bevestig dat de tools beschikbaar zijn

Na verbinding opent u de lijst met tools van de server in uw client. De ROOTE-documentatie beschrijft de sequentie initialize, tools/list en vervolgens tools/call; compatibele clients voeren deze uitwisselingen doorgaans automatisch uit. Gebruik de versie en functies die de server aankondigt.

De server biedt geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions en services_nearby aan. Het ontbreken van deze tools duidt op een verbindingsprobleem, detectieprobleem of een wijziging in de dienst. Controleer altijd de door de server aangekondigde lijst. Journey en Departures worden nog niet aangeboden.

## Voer een eerste reproduceerbare zoekopdracht uit

Begin met een expliciet adres: "Gebruik ROOTE om 10 rue de Rivoli, Parijs, Frankrijk te zoeken. Geef de gevonden kandidaten en hun coördinaten aan." Bekijk het resultaat van de tool, niet alleen het antwoord dat door het model is opgesteld.

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

Deze sectie toont de naam en argumenten van een oproep; dit is geen volledige HTTP-aanvraag. Uw client verpakt de MCP-aanroep. Als meerdere plausibele kandidaten terugkomen, kies dan de juiste voordat u rond dat punt zoekt.

U kunt daarna het transport rond een referentiepunt in Bordeaux testen. De onderstaande coördinaten dienen voor de test en pretenderen niet afkomstig te zijn van het eerder genoemde Parijse adres.

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

## Bekijk het resultaat voordat u conclusies trekt

Controleer de status, teruggegeven entiteiten, dekking, waarschuwingen en toegepaste limieten. Een gedeeltelijk antwoord kan nuttige informatie bevatten. Een lege zoekopdracht betekent niet dat er fysiek geen vervoer in de stad is.

Het verwachte testresultaat is een gestructureerd antwoord of een duidelijke foutmelding, geen vooraf bepaald aantal haltes. Bronnen en dekking kunnen wijzigen. Het zoeken naar haltes retourneert niet hun aankomende vertrekken.

## Los verbindingsfouten op

| Symptoom | Handige controle |
| --- | --- |
| Geen tools gevonden | Exacte URL, extern transport en toestemming van de client |
| Argumentfout | Types, toegestane waarden en velden van het aangekondigde schema |
| Authenticatiefout | Geldigheid van de Bearer en headerconfiguratie |
| Limiet bereikt | Actieve limieten, hersteltijd en oproepfrequentie |
| Leeg of deels resultaat | Coördinaten, filters, straal, dekking en waarschuwingen |

[Maak onderscheid tussen een leeg resultaat en een API-fout](https://www.roote.ai/nl/guides/geen-resultaat-of-api-fout-verschil-maken/)

[Maak een volledige assistent vanuit een adres](https://www.roote.ai/nl/guides/hoe-een-assistent-te-maken-die-mobiliteit-rond-een-adres-vindt/)

[Begrijp de rol van een MCP-server](https://www.roote.ai/nl/guides/wat-is-een-mcp-server-en-wat-doet-het/)

## Komend: komende vertrekken en routeberekening

ROOTE is van plan om zijn MCP uit te breiden met aankomende vertrekken en routeberekening. Deze functionaliteiten worden toegevoegd en maken nog geen deel uit van de momenteel door de MCP-server aangeboden tools. Controleer bij beschikbaarheid welke tools de server meldt, hun argumenten en de daadwerkelijk geretourneerde informatie voordat u een passage of reis aankondigt.

## Veelgestelde vragen

### Is een token altijd verplicht?

De documentatie voorziet anonieme Free-toegang. De limieten en mogelijkheden van uw toegang blijven die van de service.

### Waarom geeft mijn assistent een dienstregeling aan na een haltezoekopdracht?

Een transit_nearby-zoekopdracht levert geen aankomende vertrekken op. Vraag de assistent de daadwerkelijk geretourneerde gegevens te benoemen en deze afwezigheid te signaleren.

### Kan ik testen zonder een applicatie aan te maken?

Ja, met een compatibele client die het toevoegen van externe servers en het uitvoeren van hun tools toelaat.