# Kuinka liittää tekoälyavustaja MCP ROOTEen?

> Liitä avustaja MCP ROOTEen: palvelimen URL, HTTP-määritykset, ensimmäinen haku, tulosten lukeminen ja virheiden vianmääritys.

Source: https://www.roote.ai/fi/guides/kuinka-liittaa-tekoaly-avustaja-mcp-rooteen/
Language: fi
Author: ROOTE

Liittääksesi tekoälyavustajan MCP ROOTEen, lisää etäpalvelin https://mcp.roote.ai/mcp MCP Streamable HTTP -yhteensopivaan sovellukseen. Palvelin tarjoaa luku- eli käyttötyökaluja osoitteille, liikkumisille ja lähialueen palveluille.

Tämä opas seuraa ROOTE:n julkaisemia asetuksia ja yhteyden testausta palvelimeen. Valikon otsikot vaihtelevat asiakkaan mukaan; tarkistettava on URL-osoite, siirtotapa ja työkalujen rakenne. Palvelimen tools/list-lista voi muuttua ennen dokumentaatiota: käytä todellisia ilmoitettuja toimintoja.

## Tarkista asiakkaan yhteensopivuus

Sovelluksesi on tuettava etäistä MCP-palvelinta Streamable HTTP:n kautta. Paikallisiin stdio-palvelimiin rajoittuva asiakas ei voi käsitellä tätä URL:ää suoritettavana komentona. Tarkista myös, sallitaanko kotimainen palvelinten lisäys käyttäjätililläsi.

Jos sovellus tarjoaa lomakkeen, syötä ROOTE nimiin ja palvelimen URL osoitteeksi. Jos tukee mcpServers-muotoinen tiedosto, ROOTE-dokumentaatio tarjoaa tämän minimimäärityksen:

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

[ROOTE:n virallinen liitäntämääritys](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Valitse anonyymi tai todennettu käyttö

Dokumentaatio olettaa anonyymin pääsyn ilman Authorization-otsikkoa, joka on Free-projektiin ja API:n aktiivisiin rajoituksiin sidottu. Todennetussa käytössä käytä asiakkaan suojattua mekanismia lähettääksesi tokenisi Bearer-otsikossa.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN on korvattava arvo asiakasohjelman varmennetussa määrityksessä. Älä liitä tokenia keskusteluun, julkiseen URL:ään tai artikkeliin. Virheellinen tai peruutettu token ei automaattisesti vaihdu anonyymiin käyttöön.

## Varmista työkalujen saatavuus

Yhdistyttyäsi avaa palvelimen työkalulista asiakasohjelmassasi. ROOTE-dokumentaatio kuvaa vaiheet initialize, tools/list ja tools/call; yhteensopivat asiakkaat suorittavat nämä vaiheet automaattisesti. Hyödynnä palvelimen ilmoittamaa versiota ja toimintoja.

Palvelin tarjoaa työkalut geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions ja services_nearby. Näiden työkalujen puuttuminen viittaa yhteys-, havaitsemis- tai palvelumuutokseen. Tarkista aina palvelimen ilmoittama lista. Journey ja Departures eivät ole vielä saatavilla.

## Suorita ensimmäinen toistettavissa oleva haku

Aloita selkeällä osoitteella: "Käytä ROOTEa etsimään 10 rue de Rivoli, Pariisi, Ranska. Listaa löytyneet ehdokkaat ja niiden koordinaatit." Tarkastele työkalun tulosta, älä pelkästään mallin luomaa vastausta.

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

Tämä esimerkki näyttää kutsun nimen ja argumentit; se ei ole täydellinen HTTP-pyyntö. Asiakas kapseloi MCP-kutsun. Jos useita mahdollisia ehdokkaita löytyy, valitse oikea ennen pisteen ympäristön hakuun ryhtymistä.

Voit testata myös kuljetuksia Bordeaux'n vertailupisteen ympärillä. Alla olevia koordinaatteja käytetään testissä, ne eivät väitä olevansa edellisen pariisilaisen osoitteen tiedot.

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

## Lue tulos ennen johtopäätöstä

Tarkista tila, palautetut entiteetit, kattavuus, varoitukset ja sovelletut rajat. Osittainen vastaus voi sisältää hyödyllistä tietoa. Tyhjä haku ei todista kaupungin liikenteen fyysistä puuttumista.

Odotettu testin tulos on jäsennelty vastaus tai selvä virheilmoitus, ei ennalta määrätty pysäkki- tai asemamäärä. Lähteet ja kattavuus voivat muuttua. Pysäkkien haku ei palauta niiden seuraavia lähtöjä.

## Ratkaise yhteysvirheet

| Oireet | Hyödyllinen tarkistus |
| --- | --- |
| Työkaluja ei löydy | Tarkista tarkka URL, etäyhteys ja asiakasohjelman oikeudet |
| Argumenttivirhe | Tarkista tyypit, sallitut arvot ja tarjotun kaavan kentät |
| Todennusvirhe | Bearer-tokenin voimassaolo ja otsikkokonfiguraatio |
| Raja saavutettu | Aktiiviset rajoitukset, uudelleenkäynnistyksen viive ja kutsutiheys |
| Tyhjä tai osittainen tulos | Koordinaatit, suodattimet, säde, kattavuus ja varoitukset |

[Erottele tyhjä tulos API-virheestä](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

[Luo täydellinen avustaja osoitteen perusteella](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

[Ymmärrä MCP-palvelimen rooli](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)

## Tulossa: seuraavat lähdöt ja reitin laskenta

ROOTE suunnittelee laajentavansa MCP:tään tuleviin lähtöihin ja reitinlaskentaan. Nämä ominaisuudet ovat tulossa, eivätkä vielä kuulu palvelimen tällä hetkellä tarjoamiin työkaluihin. Saatavuuden yhteydessä tarkista palvelimen ilmoittamat työkalut, niiden argumentit ja palautetut tiedot ennen kuin ilmoitat pysähdyksen tai matkan.

## Usein kysyttyä

### Tarvitaanko aina token?

Dokumentaatio sallii anonyymin Free-käytön. Käyttöoikeuden rajoitukset ja kyvyt noudattavat palvelun soveltamia ehtoja.

### Miksi avustaja ilmoittaa aikataulun pysäkkihakujen jälkeen?

transit_nearby-haku ei anna seuraavia lähtöjä. Pyydä avustajaa näyttämään todelliset saadut tiedot ja ilmoittamaan puuttuvasta tiedosta.

### Voiko testata ilman sovellusta?

Kyllä, yhteensopivalla asiakkaalla, joka sallii etäpalvelimen lisäämisen ja työkalujen ajamisen.