# AI-asszisztens csatlakoztatása

> Lépésről lépésre: WordPress-alkalmazásjelszó, az Amelia MCP-végpontja az MCP-kliens beállításában, tesztelés, támogatott műveletek és hibaelhárítás.

Egy AI-asszisztenst úgy csatlakoztatsz az Ameliához, hogy létrehozol egy WordPress-alkalmazásjelszót, és az asszisztens MCP-szerverbeállításába beírod az Amelia MCP-végpontját. A csatlakozás után az asszisztens felfedezi az Amelia támogatott eszközeit, és azokat a műveleteket hajthatja végre, amelyeket a hitelesített WordPress-felhasználó is elvégezhetne. A technológiai háttérről az [AI-asszisztens integrációk](https://hub.hellowp.io/hu/plugins/ameliabooking/integraciok-ai-asszisztens/) fejezet szól.

Az integráció az Amelia minden licencében elérhető, és külön beállítás nélkül működik, ezért nincs **Bekapcsolás** gomb. Hogy az asszisztens mihez fér hozzá, azt a csatlakozáshoz használt WordPress-felhasználó jogosultságai döntik el.

## Mi kell a csatlakozáshoz?

- hozzáférés ahhoz a WordPress-felhasználói profilhoz, amely engedélyezi a kapcsolatot,
- jogosultság alkalmazásjelszó létrehozására,
- MCP-kompatibilis AI-kliens, például a Claude Desktop,
- Node.js a kliens számítógépén,
- annak a webhelynek a teljes URL-je, ahol az Amelia fut.

A Node.js adja az `npx` parancsot, amelyet a kapcsolat használ. Ha nincs telepítve, töltsd le a nodejs.org oldalról a Windows, macOS vagy Linux verziót. A telepítés után zárd be teljesen az MCP-klienst, és nyisd meg újra, hogy érzékelje az új parancsot.

## Alkalmazásjelszó létrehozása

Az alkalmazásjelszót annak a WordPress-felhasználónak a profiljában hozod létre, aki az AI-asszisztenst engedélyezi.

1. Nyisd meg a **Felhasználók → Profil** oldalt.
2. Görgess az **Alkalmazás jelszavak** részhez.
3. Add meg az **Új alkalmazás jelszó név** mezőben a kapcsolat nevét, hogy felismerd, melyik kliens használja.
4. Kattints az **Alkalmazás-jelszó hozzáadása** gombra.
5. Másold ki a létrejött jelszót, és tárold biztonságosan. A WordPress csak egyszer mutatja meg.

![Az Alkalmazás jelszavak rész a WordPress-profilban](./kepek/integraciok-ai-alkalmazasjelszo.webp)

*Az Alkalmazás jelszavak rész a WordPress-profilban* (https://minta-bolt.hu/wp-admin/profile.php)

A képen az alkalmazásjelszó nevének mezője és a hozzáadó gomb látszik.

Fontos, hogy az alkalmazásjelszót használd, ne a felhasználó szokásos belépési jelszavát. Kezeld titokként, ne tedd képernyőképre, és vond vissza a profilból, ha a kapcsolatra már nincs szükség.

## Az Amelia felvétele a Claude Desktopba

Az Amelia felvételéhez egy MCP-szerverbejegyzést kell létrehoznod, amely a WordPress távoli MCP-csomagját futtatja, és az Amelia végpontjára mutat. Nyisd meg a kliens helyi MCP-beállítófájlját, és az `mcpServers` objektumba írd be az alábbi bejegyzést. A példában szereplő webhelyet, felhasználónevet és jelszót cseréld a sajátodra.

```json
"mcpServers": {
  "kapcsolat-neve": {
    "command": "npx",
    "args": [
      "-y",
      "@automattic/mcp-wordpress-remote@latest"
    ],
    "env": {
      "WP_API_URL": "https://a-te-weboldalad.hu/wp-json/mcp/amelia-mcp-server",
      "WP_API_USERNAME": "wordpress-felhasznalonev",
      "WP_API_PASSWORD": "alkalmazasjelszo"
    }
  }
}
```

- A **kapcsolat neve** tetszőleges, így fogja az AI-eszköz címkézni a kapcsolatot.
- A `WP_API_URL` értékében csak a domaint cseréld ki, az útvonal mindig `/wp-json/mcp/amelia-mcp-server` marad.
- A `WP_API_USERNAME` a WordPress-felhasználóneved, a `WP_API_PASSWORD` az előbb létrehozott alkalmazásjelszó.
- Ha a fájlban már vannak más MCP-szerverek, csak az új bejegyzést add hozzá a meglévő `mcpServers` objektumhoz, ne cseréld le az egész fájlt.

## A kapcsolat tesztelése

A kapcsolatot úgy ellenőrzöd, hogy elmented a beállítást, újraindítod a klienst, és kérsz egy csak olvasó műveletet. Ha az asszisztens Amelia-adatokat ad vissza, a végpont, a hitelesítés és az eszközfelfedezés működik.

1. Mentsd el az MCP-kliens beállítását.
2. Zárd be, majd indítsd újra a klienst.
3. Ellenőrizd, hogy az Amelia eszközei megjelennek a kliens elérhető eszközei között.
4. Kérd meg az asszisztenst, hogy sorolja fel az Ameliában beállított szolgáltatásokat.
5. Hasonlítsd össze a visszakapott szolgáltatásokat az Amelia háttérfelületén lévő rekordokkal.
6. Írási műveletet csak azután próbálj ki, hogy az olvasási kérés sikerült.

## Milyen műveleteket végezhet az asszisztens?

A csatlakoztatott asszisztens lekérhet bizonyos Amelia-adatokat, és az alábbi támogatott műveleteket hajthatja végre. Az eredményt továbbra is a hitelesített felhasználó WordPress-jogosultságai szabják meg.

- szolgáltatások listázása,
- munkavállalók listázása,
- vásárlók listázása,
- események listázása,
- időpontok listázása,
- szolgáltatás hozzáadása,
- vásárló hozzáadása,
- időpont létrehozása,
- esemény létrehozása,
- vásárló regisztrálása eseményre,
- szolgáltatás elérhetőségének ellenőrzése,
- foglalás lemondása.

Az integráció csak ezeket a műveleteket teszi elérhetővé. Nem ad korlátlan hozzáférést az Ameliához, és közvetlen adatbázis-hozzáférést sem.

## Mit tegyek, ha nem sikerül a csatlakozás?

A hibák többnyire hiányzó helyi függőségből, érvénytelen hitelesítő adatokból, hibás beállításból, kiszolgálói hitelesítési szabályokból vagy elégtelen WordPress-jogosultságból erednek. Keresd meg a kliens hibaüzenetét az alábbiak között.

### Az MCP-kliens nem találja az npx parancsot

Ez akkor fordul elő, ha a Node.js hiányzik, vagy a telepítési mappája nem érhető el a kliens számára. Windowson az `npx is not recognized`, macOS-en és Linuxon az `npx: command not found` hiba jelenhet meg, bármelyik rendszeren pedig a `spawn npx ENOENT`. Telepítsd a Node.js-t, zárd be teljesen a klienst, és nyisd meg újra.

Ha a hiba marad, futtasd a terminálban a `node --version` és az `npx --version` parancsot, hogy mindkettő elérhető-e. Ha a terminálban működnek, de a kliens mégsem találja őket, indítsd újra a számítógépet.

### „incorrect_password” hiba

Ez általában azt jelenti, hogy a beállításban a felhasználó szokásos belépési jelszava szerepel alkalmazásjelszó helyett. Hozz létre új alkalmazásjelszót a WordPress-profilban, írd át a `WP_API_PASSWORD` értékét, mentsd a beállítást, és indítsd újra a klienst.

### 403 Forbidden válasz

Egy nyers 403 Forbidden oldal azt jelezheti, hogy a webszerver eltávolítja az `Authorization` fejlécet, mielőtt a kérés a WordPressig érne. Ez többnyire a szerver vagy az Apache beállításából ered, nem az Ameliából. Kérd meg a tárhelyszolgáltatót vagy a szerver üzemeltetőjét, hogy az Authorization fejlécet adják át a WordPressnek.

### Az Amelia eszközei nem jelennek meg

Ha a kapcsolat elindul, de az Amelia eszközei hiányoznak, ellenőrizd, hogy a végpont `/wp-json/mcp/amelia-mcp-server` végű-e, hogy a JSON-szerkezet érvényes-e, és hogy az Amelia-bejegyzés az `mcpServers` objektumon belül van-e. Minden módosítás után mentsd a fájlt, és indítsd újra a klienst.

### Az asszisztens olvasni tud, de foglalást nem hoz létre és nem mond le

Ha az olvasás működik, de az írási műveletek nem, a csatlakozott WordPress-felhasználónak valószínűleg hiányoznak a szükséges Amelia-jogosultságai. Az asszisztens a hitelesített felhasználó jogosultságait követi, ezért olyan felhasználóval csatlakozz, akinek a jogosultságai megfelelnek a kívánt műveleteknek.

## Mire figyelj a foglalások AI-val való kezelésekor?

Az AI-támogatott műveletek akkor működnek jól, ha a kérés konkrét, és egyetlen világos feladatra korlátozódik. Minden olyan művelet után, amely foglalási adatot hoz létre vagy módosít, nézd át az eredményt az Ameliában, különösen ha az asszisztens szolgáltatást, eseményt, időpontot vagy eseményfoglalást hozott létre.

- Az AI-asszisztenssel létrehozott szolgáltatások és események alapértékeket kapnak az olyan beállításokra, mint a szín, a láthatóság és az előleg.
- Az AI-asszisztenssel létrehozott foglalásokról jelenleg nem megy vásárlói értesítés.
- Az egyszerre több műveletet összekapcsoló összetett kérések kevésbé megbízhatók, mint az egyfeladatos kérések.
- Nagy időpontlista lekérése hibázhat, ha nem adsz meg dátumtartományt.
- Az Amelia **Munkavállaló** szerepkörét jelenleg nem érdemes AI-támogatott foglaláshoz használni, mert a jogosultságkezelése nincs teljesen támogatva.

## Ajánlott gyakorlat

Tartsd a kéréseket konkrétan, ellenőrizd a fontos változtatásokat az Amelia háttérfelületén, és védd a kapcsolathoz használt hitelesítő adatokat.

- Kezdj csak olvasó kéréssel, mielőtt adatot módosító műveletet próbálsz ki.
- Időpontok lekérésekor adj meg konkrét dátumtartományt.
- Nézd át az AI által létrehozott szolgáltatásokat, eseményeket, időpontokat és foglalásokat.
- Olyan WordPress-felhasználót használj, akinek a jogosultságai megfelelnek a tervezett műveleteknek.
- Vond vissza a már nem használt alkalmazásjelszavakat a WordPress-profilból.
- Ne tegyél valódi hitelesítő adatot képernyőképre, dokumentációba vagy megosztott beállításpéldába.
- Ne feltételezd, hogy a vásárlók értesítést kaptak az AI által létrehozott foglalásról.
- Ne kapcsolj össze egymásra épülő foglalási műveleteket egyetlen kérésben, ha külön kérések átláthatóbbak.