# MCP az AI-ügynökökhöz

> A Fluent Forms beépített MCP-kiszolgálója: bekapcsolás, FluentHub, alkalmazásjelszó, kliens csatlakoztatása, elérhető eszközök, WebMCP és hibaelhárítás.

A Fluent Forms beépített MCP-kiszolgálóval (Model Context Protocol) rendelkezik, amely összeköti az űrlapjaidat az AI-kliensekkel, például a Claude Code-dal, a Claude Desktoppal, a Cursorral és a Codexszel. Beállítás után az AI-asszisztensed egy beszélgetés közben megkeresi az űrlapot, elolvassa a beküldéseket, megnézi a beküldések alakulását vagy módosít egy értesítést. Nincs szükség külső közvetítő szolgáltatásra, saját üzemeltetésű szerverre vagy a WordPressen kívüli API-kulcsra.

Az MCP hidat képez az AI-kliens és a Fluent Forms között: az AI ugyanazokat a műveleteket hívja meg, amelyeket te is elvégeznél az admin felületen, csak hitelesített, biztonságos végponton keresztül.

- Minden kérés annak a WordPress-felhasználónak a nevében fut, akinek az alkalmazásjelszavát létrehoztad. Pontosan annyi Fluent Forms-hozzáférése van, mint annak a felhasználónak, ezért az ügynök olyan űrlapot sem érhet el, amelyhez a felhasználónak nincs joga.
- Az adatot módosító eszközök az írás előtt előnézetet mutatnak, és megerősítést kérnek.
- A hozzáférést bármikor visszavonhatod.

## Az MCP beállításainak helye

A **Fluent Forms Pro → Globális beállítások → MCP for AI Agents** oldalon van minden: a kapcsoló, az eszközök listája, a végpont címe és a kliensek csatlakozási kódja.

## 1. lépés: az MCP-kiszolgáló bekapcsolása

Az oldal tetején kapcsold be az **Enable MCP Server** kapcsolót. Bekapcsolva a Fluent Forms az adaptereken keresztül elérhetővé teszi a képességeit, így az AI-ügynökök a te engedélyeddel olvashatják és írhatják az űrlapadatokat.

Ha egyszerre le akarod állítani az összes csatlakozott AI-klienst, kapcsold ki ezt a kapcsolót: a végpont azonnal nem válaszol több MCP-kérésre, más módosítás nem kell.

![Az MCP for AI Agents oldal bekapcsolt kiszolgálóval és az eszközök listájával](./kepek/modulok-1-mcp-bekapcsolva.webp)

*Az MCP for AI Agents oldal bekapcsolt kiszolgálóval és az eszközök listájával* (https://minta-bolt.hu/wp-admin/admin.php?page=fluent_forms_settings)

A képen a kapcsoló mellett a „23 tools available” felirat és a kibontott **Available tools** lista látszik.

## 2. lépés: a FluentHub telepítése

Az MCP-kliensek (Claude, Cursor, Codex) csatlakoztatásához a Fluent Forms egy kis kiegészítő bővítményt, a **FluentHub**-ot használja. Amíg nincs telepítve és aktiválva, az eszközlista alatt egy figyelmeztetés és az **Install FluentHub** gomb látszik.

1. Kattints az **Install FluentHub** gombra.
2. A WordPress a háttérben telepíti és aktiválja a bővítményt.
3. Az oldal frissül, és megjelennek a végpont mezői.

Kézzel is telepítheted: töltsd le a FluentHub zip-fájlt, majd a **Bővítmények → Bővítmény hozzáadása → Bővítmény feltöltése** oldalon töltsd fel és aktiváld. Ezután térj vissza az MCP-oldalra.

A FluentHub csak a külső MCP-kliensek csatlakoztatásához kell. Maguk az eszközök a WordPress Abilities REST API-n (`/wp-abilities/v1`) keresztül is működnek, ezért minden kliens, amely a WordPressből tud képességeket olvasni, felfedezheti és futtathatja őket. Ilyenkor is a hitelesített WordPress-felhasználó jogai érvényesek.

## 3. lépés: az eszközök és a végpont ellenőrzése

Ha a kapcsoló be van kapcsolva, az oldalon ezeket látod:

| Mező | Mit mutat |
|---|---|
| **tools available** | A kapcsoló mellett az elérhető MCP-eszközök száma. |
| **Available tools** | Az összes eszköz neve, mindegyik **Read** (olvasás) vagy **Write** (írás) címkével, így látod, mit módosíthat az ügynök. A Pro eszközök **Pro** címkét is kapnak. |
| **Endpoint URL** | Az a cím, amelyre az AI-kliens csatlakozik, általában `https://a-te-oldalad.hu/wp-json/fluentform/mcp`. A **Copy** gombbal másolhatod. |

Ha az eszközök száma 0, valószínűleg nincs bekapcsolva a kiszolgáló, vagy a FluentHub nem aktív.

## 4. lépés: WordPress alkalmazásjelszó létrehozása

Az AI-kliensek WordPress alkalmazásjelszóval jelentkeznek be. Ez a WordPress 5.6 óta beépített funkció, nincs szükség hozzá bővítményre. Minden alkalmazásnak külön jelszava van, ezért egy AI-klienst úgy vonhatsz vissza, hogy a saját belépésed és a többi eszközöd nem érintett.

Az MCP-beállítóoldalról közvetlenül a megfelelő képernyőre ugorhatsz a végpont címe alatti **Create application password** hivatkozással. Kézzel így csinálhatod:

1. A WordPress adminban nyisd meg a **Felhasználók → Adatlap** oldalt, és görgess az **Alkalmazásjelszavak** részhez.
2. Adj nevet a kapcsolatnak, például `mcp`, `Claude Code` vagy `Cursor`. A név később a táblázatban segít megkülönböztetni a kapcsolatokat.
3. Kattints az **Új alkalmazásjelszó hozzáadása** gombra.

A WordPress egy egyszer látható jelszót ad `xxxx xxxx xxxx xxxx xxxx xxxx` formában. Másold ki és tedd biztos helyre: később nem kérhető le újra.

## 5. lépés: az AI-kliens csatlakoztatása

Az MCP-oldalon görgess a csatlakozási mezőkhöz. A Fluent Forms kódolja a hitelesítő adataidat, és a választott klienshez kész, beilleszthető kódrészletet állít elő.

1. A WordPress-felhasználónév mezőbe írd be azt a felhasználónevet, amelyikhez a jelszót létrehoztad.
2. Az alkalmazásjelszó mezőbe illeszd be a jelszót (szóközökkel vagy anélkül is jó).
3. Válaszd ki a kliensednek megfelelő fület: **Claude Code**, **Claude Desktop**, **Cursor**, **Codex** vagy **Other / curl**.
4. Kattints a **Copy snippet** gombra.

A Basic hitelesítési fejléc base64 kódolását a böngésző végzi el, ezért nincs kézi kódolás, és a jelszavad nem hagyja el az oldalt.

**Figyelem:** a generált kódrészlet már tartalmazza a kódolt hitelesítő adatokat. Kezeld úgy, mint egy jelszót: ne illeszd be nyilvános tárhelyre, közös csevegésbe vagy képernyőképre.

### Node.js és npx

Egyes kliensekhez kell a Node.js (benne az `npx`) a gépeden:

| Kliens | Kell Node.js/npx? |
|---|---|
| Claude Code | Igen, maga a kliens npm-en keresztül települ. |
| Claude Desktop | Igen, egy kis `npx` segédprogramon át éri el az oldalad. |
| Codex | Igen, ha a kódrészleted `npx`-szel kezdődik. |
| Cursor | Nem, közvetlenül az URL-re csatlakozik. |

Az ellenőrzéshez nyiss egy terminált (macOS) vagy parancssort (Windows), és futtasd:

```bash
node -v
```

Ha verziószámot látsz (például `v20.11.0`), minden rendben. Ha „command not found” hibát kapsz, töltsd le az LTS telepítőt a nodejs.org oldalról, telepítsd, majd zárd be és nyisd meg újra a terminált. Ha nem érzed magad otthon a terminálban, kérd meg az AI-ügynököt, hogy ellenőrizze és telepítse.

### Claude Code

1. **Másold ki a kódrészletet.** A felhasználónév és a jelszó kitöltése után válaszd a **Claude Code** fület, és kattints a **Copy snippet** gombra. A kód így néz ki:

```bash
claude mcp add \
  --transport http \
  fluentform https://a-te-oldalad.hu/wp-json/fluentform/mcp \
  --header "Authorization: Basic <kodolt-hitelesito-adatok>"
```

2. **Futtasd a terminálban.** Illeszd be a kódot abba a terminálba, ahol a Claude Code telepítve van, és nyomj Entert.
3. **Nézd meg a visszajelzést.** A Claude Code jelzi, hogy a `fluentform` MCP-kiszolgáló bekerült a helyi beállításokba, a végpontodra mutat, a Basic hitelesítési fejléccel.

A kapcsolatot bármikor ellenőrizheted a `claude mcp list` vagy a `claude mcp get fluentform` paranccsal.

### Claude Desktop

A Claude Desktop az MCP-kiszolgálókat egy beállításfájlból olvassa, és a fájlt meg is nyitja neked.

1. Nyisd meg a **Settings → Developer → Edit Config** pontot. Ha a fájl még nincs meg, a Claude Desktop létrehozza, és megmutatja az elérési útját: macOS-en `~/Library/Application Support/Claude/claude_desktop_config.json`, Windowson `%APPDATA%\Claude\claude_desktop_config.json`.
2. Nyisd meg a fájlt egyszerű szövegszerkesztőben (macOS-en TextEdit, Windowson Jegyzettömb).
3. Illeszd be a Fluent Forms **Claude Desktop** füléről a kódrészletet. Ha már vannak más kiszolgálók a fájlban, a JSON maradjon érvényes.
4. Mentsd a fájlt, majd teljesen lépj ki a Claude Desktopból, és indítsd újra. Az ablak bezárása nem elég: a menüsorból (macOS) vagy a tálcáról (Windows) lépj ki.

### Cursor

1. A Cursorban nyisd meg a parancspalettát, keress rá a **Cursor Settings** pontra, majd a bal oldali menüben válaszd a **Tools & MCPs** részt.
2. Az **Installed MCP Servers** alatt kattints a **New MCP Server** gombra. A Cursor megnyitja az `mcp.json` beállításfájl szerkesztőjét.
3. Illeszd be a Fluent Forms **Cursor** füléről a kódrészletet.
4. Mentsd az `mcp.json` fájlt, és töltsd újra a Cursort. A **Tools & MCPs** oldalon megjelenik a Fluent Forms kiszolgáló az összes elérhető eszközével.

## 6. lépés: a működés ellenőrzése

Nyisd meg az AI-klienst, és kérdezz valamit, amit csak a Fluent Forms tud. Például:

> Sorold fel az összes Fluent Forms űrlapomat, és azt is, hogy mindegyikhez hány beküldés van.

Az ügynök meghívja a végpontot, lekéri az adatokat, és az űrlapjaiddal és a beküldések számával válaszol. Ha valódi adatot látsz a válaszban, a kapcsolat él és hitelesített.

## Mit tud az AI-ügynök

Csatlakozás után az AI-kliens hozzáfér a Fluent Forms eszközeihez. Az eszközöket nem kell névvel hívnod: az AI a természetes nyelvű kérésed alapján választja ki a megfelelőt. Az eszközök témakörönként:

### Űrlapok

| Eszköz | Típus | Mit csinál |
|---|---|---|
| Get Forms Context | Olvasás | Összefoglalót ad az űrlapokról, hogy az ügynök értse, mi van a webhelyen. |
| List Forms | Olvasás | Listázza az űrlapokat az állapotukkal és a beküldéseik számával. |
| Get Form | Olvasás | Egy űrlap mezőit, beállításait és konfigurációját mutatja. |
| Űrlap létrehozása | Írás | A leírásod alapján új űrlapot készít. |

Példa kérések: „Listázd az összes közzétett űrlapomat és a beküldéseik számát.” „Készíts egy egyszerű kapcsolatfelvételi űrlapot név, e-mail és üzenet mezővel.”

### Beküldések

| Eszköz | Típus | Mit csinál |
|---|---|---|
| List Submissions | Olvasás | Egy űrlap beküldéseit listázza szűrőkkel (állapot, időszak). |
| Get Submission | Olvasás | Egy beküldés teljes adatát mutatja. |
| Update Submission Status | Írás | Módosítja egy beküldés állapotát, például olvasottra, olvasatlanra vagy kedvencre. |
| Add Submission Note | Írás | Belső jegyzetet fűz egy beküldéshez. |
| Delete Submission | Írás | Töröl egy beküldést. |
| Bulk Update Submissions | Írás | Több beküldés állapotát módosítja egyszerre. |

Példa kérések: „Mutasd a Kapcsolat űrlap utolsó 10 beküldését.” „Jelöld olvasottnak az összes olvasatlan beküldést az Álláspályázat űrlapon.”

### Jelentések és statisztikák

| Eszköz | Típus | Mit csinál |
|---|---|---|
| Get Form Stats | Olvasás | Egy űrlap beküldéseinek számát, megtekintéseit és konverziós arányát adja. |
| Get Submissions Trend | Olvasás | Megmutatja, hogyan alakultak a beküldések egy időszakban. |
| Get Payment Summary | Olvasás | Összesíti az űrlapon át beérkezett fizetéseket. |
| Get Submissions Report | Olvasás | Részletesebb bontást ad a beküldésekről. |
| Get Revenue Analysis | Pro, olvasás | Bevételelemzés. |
| Get Completion Rate | Pro, olvasás | Kitöltési arány. |
| Get Subscription Report | Pro, olvasás | Előfizetési jelentés. |

Az adatok megegyeznek a [Jelentések irányítópult](https://hub.hellowp.io/hu/plugins/fluentform-signature/bejegyzesek-jelentesek-iranyitopult/) és a [Fizetési jelentések](https://hub.hellowp.io/hu/plugins/fluentform-signature/fizetesek-jelentesek/) adataival. Példa kérések: „Hogyan alakultak a Hírlevél űrlap beküldései az elmúlt 30 napban?” „Mennyi adomány gyűlt össze ebben a hónapban?”

### Stílus, mezők és integrációk

| Eszköz | Típus | Mit csinál |
|---|---|---|
| List Integrations | Olvasás | Az űrlaphoz kapcsolt integrációkat listázza. |
| Get Form Styling | Olvasás | Az űrlap stílusbeállításait olvassa. |
| Update Form Styling | Írás | Módosítja az űrlap stílusát, ugyanazokat a beállításokat, mint a stílusszerkesztő. |
| Update Form Fields | Írás | Mezőket ad hozzá, szerkeszt vagy átrendez egy űrlapon. A mezőket helyes típussal hozza létre. |

Példa kérések: „Milyen integrációk vannak a Kapcsolat űrlaphoz kötve?” „Adj egy telefonszám mezőt a Regisztráció űrlaphoz az e-mail mező után.”

### E-mail értesítések

| Eszköz | Típus | Mit csinál |
|---|---|---|
| List Email Notifications | Olvasás | Az űrlap beállított értesítéseit listázza. |
| Create or Update Email Notification | Írás | Új értesítést hoz létre vagy meglévőt módosít, ugyanúgy, mint az [E-mail értesítések](https://hub.hellowp.io/hu/plugins/fluentform-signature/ertesitesek-email-ertesitesek/) beállításai. |

Példa kérések: „Milyen e-mail értesítések vannak a Kapcsolat űrlapon?” „Adj egy admin értesítést a Visszajelzés űrlaphoz, ami minden beküldésnél e-mailt küld nekem.”

## Egy űrlap leírása az AI-böngészőknek (WebMCP)

Az MCP az egész webhely kezelését lehetővé teszi az AI-asszisztensnek. Az **AI Agents (WebMCP)** ettől különbözik: űrlaponként állítható beállítás, amely egyetlen űrlapot ír le az AI-alapú böngészőknek, hogy megbízhatóan ki tudják tölteni, és ne a mezőneveket találgassák. Csak leíró adatot (metaadatot) ad hozzá, az ügynök nem tudja vele önállóan beküldeni az űrlapot.

1. Nyisd meg az űrlapot, és lépj a **Beállítások és integrációk → Beállítások** oldalra.
2. Keresd meg az **AI Agents (WebMCP)** kártyát.
3. Jelöld be az **Expose this form to AI agents** négyzetet. Alapértelmezetten ki van kapcsolva.
4. Állítsd be a **Tool Name** értékét. Alapértelmezetten az űrlap címe.
5. A **Tool Description** mezőbe írj egy mondatban arról, mit csinál az űrlap.
6. Mentsd a beállításokat.

Az egyes mezők címkéjéből és súgóüzenetéből áll össze a mezők leírása a böngésző számára, ezért az érthető címkék jobb eredményt adnak.

## Biztonság és a hozzáférés visszavonása

Az alkalmazásjelszavak egy-egy kapcsolathoz tartoznak, így az egyik visszavonása csak az adott AI-klienst választja le. A saját WordPress-belépésed és a többi csatlakoztatott alkalmazás érintetlen marad.

- **Egy MCP-kapcsolat visszavonása:** a **Felhasználók → Adatlap → Alkalmazásjelszavak** részen keresd meg a sort a neve alapján, és kattints a **Visszavonás** gombra.
- **Az MCP teljes kikapcsolása:** kapcsold ki az **Enable MCP Server** kapcsolót a beállítóoldalon. A végpont azonnal nem válaszol több MCP-kérésre.
- **Hitelesítő adatok cseréje:** vond vissza a régi jelszót, hozz létre újat, majd másold ki újra a kódrészletet a beállítóoldalról, és illeszd be az AI-kliensedbe.
- **Az írás felülvizsgálat alatt marad:** minden **Write** címkés eszköz előnézetet mutat és megerősítést kér, így az ügynök nem változtathat meg űrlapot vagy beküldést a jóváhagyásod nélkül.

Adj minden AI-kliensnek külön alkalmazásjelszót (egyet a Cursornak, egyet a Claude Desktopnak és így tovább). Így egy klienst úgy vonhatsz vissza, hogy a többi tovább működik.

## Hibaelhárítás

- **Az eszközök száma 0.** Ellenőrizd, hogy az **Enable MCP Server** be van kapcsolva, és a FluentHub aktív. A szám az adapter újracsatlakozásakor azonnal frissül.
- **Az Install FluentHub figyelmeztetés a telepítés után is látszik.** Frissítsd erőből az oldalt (hard refresh). Ha továbbra is megmarad, a **Bővítmények** oldalon nézd meg, hogy a FluentHub telepítve és aktív-e.
- **„Unauthorized” hiba az AI-kliensben.** A felhasználónév vagy az alkalmazásjelszó hibás. Hozz létre új jelszót, másold ki azonnal, illeszd be a beállítóoldalra, majd másold újra a kódrészletet a kliensbe.
- **A Fluent Forms eszközök nem jelennek meg az AI-kliensben.** A csatlakoztató parancs futtatása vagy a beállításfájl mentése után indítsd újra teljesen a klienst. Az ablak bezárása általában nem elég: a Claude Desktopot a menüsorból vagy a tálcáról lépj ki, és nyisd meg újra.
- **A Claude Desktop vagy a Codex „server failed to start” hibát ad.** Valószínűleg hiányzik a Node.js. Futtasd a `node -v` parancsot a terminálban, és ha „command not found” választ kapsz, telepítsd az LTS kiadást a nodejs.org oldalról, majd indítsd újra a klienst.
- **A Claude Desktop egy szerkesztés után elveszti az összes MCP-kiszolgálóját.** A `claude_desktop_config.json` fájlban JSON-szintaktikai hiba van, jellemzően hiányzó vagy felesleges vessző. Másold be a fájlt az AI-ügynöködnek, és kérd meg, hogy javítsa ki.
- **A kapcsolat helyben működik, éles oldalon nem.** Ellenőrizd, hogy a végpont címe ugyanazt a sémát (`http` vagy `https`) és domaint használja, mint amire az AI-kliens be van állítva. A WordPress alkalmazásjelszavakhoz elérhető REST API is kell a `/wp-json/` címen.