# Hogyan csatlakoztassunk egy IA asszisztenst az MCP ROOTE-hoz?

> Csatlakoztasson egy asszisztenst az MCP ROOTE-hoz: szerver URL, HTTP beállítások, első keresés, eredmények olvasása és hibakeresés.

Source: https://www.roote.ai/hu/guides/hogyan-csatlakoztassunk-ia-asszisztenst-mcp-roote-hoz/
Language: hu
Author: ROOTE

Az IA asszisztens MCP ROOTE-hoz történő csatlakoztatásához adja hozzá a https://mcp.roote.ai/mcp című távoli szervert egy MCP Streamable HTTP-kompatibilis alkalmazásban. A szerver lekérdezi az eszközöket címekhez, mobilitáshoz és közeli szolgáltatásokhoz.

Ez az útmutató a ROOTE által közzétett konfigurációt követi és a szerverkapcsolat ellenőrzését végzi. A menüpontok nevei kliensenként változhatnak; az URL-t, a transzportot és az eszközök sémaját szükséges ellenőrizni. A szerver tools/list listája a dokumentáció előtt változhat: használja a ténylegesen bejelentett képességeket.

## Kliens kompatibilitás ellenőrzése

Az alkalmazásnak támogatnia kell egy távoli MCP Streamable HTTP szerver kezelését. Egy kizárólag helyi stdio szervereket támogató kliens nem tudja ezt az URL-t futtatható parancsként használni. Ellenőrizze, hogy a fiókja engedélyezi-e egyedi szerverek hozzáadását.

Ha az alkalmazás űrlapot kínál, adja meg a ROOTE-ot névként és a szerver URL-jét címként. Ha mcpServers formátumú fájlt fogad el, a ROOTE dokumentációja minimális konfigurációt javasol:

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

[ROOTE hivatalos csatlakozási beállítása](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Név nélküli vagy hitelesített hozzáférés választása

A dokumentáció névtelen hozzáférést ír elő Authorization fejléc nélkül, a Free projekció és az API aktív korlátjai érvényesek. Hitelesített hozzáféréshez használja a kliens biztonságos mechanizmusát, amely a Bearer fejlécben továbbítja az Ön tokenjét.

```
Authorization: Bearer YOUR_API_TOKEN
```

A YOUR_API_TOKEN helyet kell kicserélni a kliens biztonságos konfigurációjában. Ne illessze be a tokent beszélgetésbe, nyilvános URL-be vagy cikkbe. Az érvénytelen vagy visszavont token nem váltódik át automatikusan névtelen hozzáféréssé.

## Ellenőrizze, hogy az eszközök elérhetőek-e

Csatlakozás után nyissa meg a szerver eszközlistáját a kliensében. A ROOTE dokumentáció az initialize, tools/list majd tools/call sorrendet írja elő; a kompatibilis kliensek ezt általában önállóan végrehajtják. Használja a szerver által jelzett verziót és képességeket.

A szerver biztosítja a geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions és services_nearby eszközöket. Ezek hiánya kapcsolat-, felfedezés- vagy szolgáltatásfejlesztési problémára utalhat. Mindig ellenőrizze a szerver által bejelentett listát. A Journey és Departures még nem elérhetőek.

## Végezzen el egy ismételhető első keresést

Kezdje egy pontos címmel: „Használja a ROOTE-ot a párizsi 10 rue de Rivoli cím keresésére Franciaországban. Mutassa meg az előjelölt helyeket és koordinátáikat.” Nézze meg az eszköz eredményét, ne csak a modell által megfogalmazott választ.

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

Ez a rész a hívás nevét és argumentumait mutatja; nem egy teljes HTTP kérés. Az Ön kliense csomagolja az MCP hívást. Ha több lehetséges jelölt visszatér, válassza ki a megfelelőt, mielőtt a környezetében keresne.

Ezután tesztelheti egy referencia pont körüli szállítást Bordeaux-ban. Az alábbi koordináták tesztelési célt szolgálnak, nem állítják, hogy a korábbi párizsi címről származnának.

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

## Olvassa el az eredményt a következtetés előtt

Ellenőrizze a státuszt, visszakapott entitásokat, lefedettséget, figyelmeztetéseket és a szabályozott korlátokat. A részleges válasz hasznos információkat tartalmazhat. Az üres keresés nem bizonyítja a közlekedési eszközök fizikai hiányát a városban.

A teszt elvárt eredménye egy strukturált válasz vagy világos hiba, nem egy előre meghatározott megállószám. A források és lefedettség változhatnak. A megállók keresése nem adja vissza azok következő indulásait.

## Csatlakozási hibák elhárítása

| Tünet | Hasznos ellenőrzés |
| --- | --- |
| Nincsenek eszközök felfedezve | Pontos URL, távoli transzport és kliens engedélyezés |
| Argumentum hiba | Típusok, megengedett értékek és bejelentett séma mezői |
| Hitelesítési hiba | Bearer érvényessége és fejléc beállítások |
| Korlát elérése | Aktív korlátok, újrapróbálati idő és hívások gyakorisága |
| Üres vagy részleges eredmény | Koordináták, szűrők, sugár, lefedettség és figyelmeztetések |

[Különböztesse meg az üres eredményt az API hibától](https://www.roote.ai/hu/guides/nincs-eredmeny-vagy-api-hiba-hogyan-kulonboztessuk-meg/)

[Teljes asszisztens létrehozása egy cím alapján](https://www.roote.ai/hu/guides/mobilitasi-asszisztens-csinalasa-cim-kozeli-lehetosegekhez/)

[MCP szerver szerepének megértése](https://www.roote.ai/hu/guides/mi-az-mcp-szerver-es-mire-szolgal/)

## Hamarosan: következő indulások és útvonaltervezés

A ROOTE tervezi MCP-jének bővítését a közelgő indulások és az útvonaltervezés funkcióival. Ezek a szolgáltatások hamarosan érkeznek, jelenleg még nem részei a MCP szerveren elérhető eszközöknek. Elérhetőségük esetén mindig ellenőrizze a szerver által bejelentett eszközöket, azok paramétereit és a ténylegesen visszaadott információkat, mielőtt járatot vagy utazást jelentene be.

## Gyakori kérdések

### Szükséges-e feltétlenül token?

A dokumentáció névtelen Free hozzáférést ír elő. Az Ön hozzáférésének korlátai és képességei az adott szolgáltatás által érvényesítettek.

### Miért jelzi az asszisztens az indulási időt megálló keresés után?

A transit_nearby keresés nem adja vissza a következő indulásokat. Kérje meg az asszisztenst, hogy idézze fel a ténylegesen visszaadott adatokat és jelezze az hiányt.

### Lehet-e tesztelni alkalmazás létrehozása nélkül?

Igen, egy kompatibilis kliens használatával, amely engedi távoli szerver hozzáadását és eszközeinek futtatását.