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

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.

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:

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:

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 és a Fizetési jelentések 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 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.