pixel
Claude Code összekötése WordPress application userrel MCP-n keresztül

Claude Code összekötése WordPress application userrel MCP-n keresztül – teljes útmutató

Ha WordPress fejlesztési és integrációs megoldásaink-t üzemeltetsz és már hallottál a Claude Code-ról, Anthropic terminálból futtatható AI asszisztenséről, akkor valószínűleg felmerült benned a kérdés: hogyan lehet ezt a két eszközt összekapcsolni? Ebben a cikkben pontosan ezt mutatjuk be – lépésről lépésre, a WordPress application password létrehozásától egészen az első sikeres terminálparancsig. Az integráció alapja a Model Context Protocol (MCP), amely 2026-ra az AI-eszközök és külső rendszerek közötti kommunikáció szabványává vált.

Mi az az MCP, és miért fontos a WordPress-felhasználók számára?

A Model Context Protocol (MCP) egy nyílt szabvány, amelyet arra terveztek, hogy az AI-modellek – mint a Claude – képesek legyenek valódi eszközökkel kommunikálni. Nem csupán szövegeket generálnak, hanem ténylegesen műveleteket hajtanak végre: bejegyzéseket hoznak létre, médiatartalmat töltenek fel, beállításokat módosítanak.

A WordPress esetében ez azt jelenti, hogy Claude Code a terminálon keresztül teljes admin hozzáféréssel rendelkezhet a weboldaladon – feltéve, hogy te magad engedélyezed és pontosan beállítod. Az MCP nem varázsol, hanem egy jól definiált, biztonságos csatornán keresztül kommunikál a WordPress REST API-jával.

Fontos különbséget tenni: az MCP-alapú integráció nem a főbb admin jelszavadat használja, hanem egy ún. application password-öt, amelyet bármikor visszavonhatsz, és amelynek hatóköre pontosan szabályozható. Ez az egyik fő biztonsági előnye a megközelítésnek.

Miért érdemes Claude Code-ot használni WordPress-szel?

Mielőtt belevágnánk a technikai beállításokba, érdemes átgondolni, mi indokolja ezt az integrációt.

Tartalomkészítés DevOps automatizálási és integrációs szolgáltatásainkása. Claude Code képes piszkozatokat létrehozni, kategóriákat és tageket hozzárendelni, kiemelt képet beállítani, sőt a közzétételre is alkalmas bejegyzést publikálni – mindezt egyetlen természetes nyelven megfogalmazott utasításra. Azok számára, akik rendszeresen nagyobb mennyiségű tartalmat kezelnek, ez komoly időmegtakarítást jelent.

SEO-munka gyorsítása. Egy jól beállított integráció lehetővé teszi, hogy Claude Code végigmenjen a meglévő bejegyzéseken, azonosítsa a hiányzó meta leírásokat, a gyenge cím-tageket, vagy éppen a belső linkelési lehetőségeket.

Tömeges műveletek egyszerűsítése. Száz bejegyzés kategóriájának frissítése, hiányzó alt szövegek pótlása, vagy elavult linkek keresése – ezek mind olyan feladatok, amelyeket Claude Code az MCP-n keresztül néhány perc alatt elvégez, míg manuálisan órákat vennének igénybe.

Fejlesztői workflow integráció. Ha már amúgy is terminálban dolgozol – verziókövetés, deployment, szerver-üzemeltetés –, akkor a Claude Code becsatolása a WordPress-munkafolyamatba logikus lépés. Nem kell böngészőt nyitni, elég a terminál.

Ha WordPress-alapú weboldal fejlesztéséről, üzemeltetéséről vagy optimalizálásáról van szó, a weboldal készítés és fejlesztés terén rendelkezésre álló tapasztalat és infrastruktúra jól kiegészíthető ezzel az AI-alapú automatizálással.

Előfeltételek

Az integráció megkezdése előtt győződj meg arról, hogy rendelkezésre áll a következő:

  1. Működő WordPress-weboldal – önálló hosztolt (self-hosted) WordPress telepítés, amelyhez adminisztrátori hozzáféréssel rendelkezel. A WordPress 5.6 óta beépített az Application Passwords funkció, tehát különösebb extra pluginre nincs szükség az alap hitelesítéshez.
  2. Node.js – a Claude Code telepítéséhez szükséges, legalább 18-as verzió ajánlott.
  3. Claude Code – Anthropic termináleszköze, amelyet npm-mel lehet telepíteni.
  4. MCP-kompatibilis plugin a WordPressben – az alap REST API-n felül az MCP szervert egy plugin biztosítja, a legegyszerűbb megoldás az AI Engine (Meow Apps), de működik a hivatalos WordPress MCP Adapter is.

A WordPress application password létrehozása

Ez az egyik legkritikusabb lépés, és egyben a legkönnyebben elrontható is, ha valaki egyszerűsít és a főjelszót akarja használni. Ne tedd. Az application password kifejezetten erre a célra készült.

  1. Lépj be a WordPress adminfelületedre.
  2. Menj a Felhasználók → Profil menüpontra (vagy a saját profilodra).
  3. Görgess le az Application Passwords szekcióhoz. Ha nem látod, ellenőrizd, hogy az oldalad HTTPS-en fut-e – HTTP esetén a WordPress biztonsági okokból nem jeleníti meg ezt a részt.
  4. Az Add New Application Password mezőbe írj be egy leíró nevet, például: claude-code-mcp.
  5. Kattints a Add New Application Password gombra.
  6. A generált jelszót azonnal másold ki és mentsd el biztonságos helyre – a WordPress többé nem jeleníti meg újra. A formátuma valami ilyesmi lesz: xxxx xxxx xxxx xxxx xxxx xxxx.

Fontos: az application password szóközöket tartalmaz, de a hitelesítési fejlécbe kerülő base64-kódolt változatban ezeket is figyelembe kell venni. A Claude Code parancsban a szóközöket el kell távolítani, vagy az egészet idézőjelbe kell tenni.

Az MCP plugin beállítása WordPressben

Az alap WordPress REST API önmagában nem elegendő az MCP-kompatibilis kommunikációhoz. Szükséges egy plugin, amely MCP-végpontot biztosít.

AI Engine plugin esetén:

  1. Telepítsd az AI Engine plugint a WordPress plugin-könyvtárból.
  2. Aktiválás után menj az AI Engine → Settings → MCP menüpontra.
  3. Kapcsold be az MCP szervert az engedélyező kapcsolóval.
  4. Állíts be egy Bearer Token-t – ez egy általad választott titkos string, minimum 32 karakter hosszú legyen, lehetőleg véletlenszerű karakterekből álljon. Ez lesz a Claude Code hitelesítési kulcsa.
  5. Válaszd ki, milyen funkciókat engedélyezel: WordPress core alapból aktív, de engedélyezhetsz Plugins, Themes, és egyéb kategóriákat is.
  6. Mentsd a beállításokat.

Az MCP-végpont URL-je ekkor: https://WEBOLDALAM.hu/wp-json/mcp/v1/http

Hivatalos WordPress MCP Adapter esetén:

Telepítsd a wordpress/mcp-adapter plugint (WordPress 6.9+ szükséges), és aktiváld. Ez automatikusan elérhetővé teszi az MCP-végpontot. Ebben az esetben nem Bearer Token, hanem az application password alapú hitelesítés a szokásos megközelítés.

Claude Code telepítése és konfigurálása

Ha még nincs fenn a Claude Code, telepítsd globálisan npm-mel:

npm install -g @anthropic-ai/claude-code

Ezt követően add hozzá a WordPress MCP szervert a Claude Code konfigurációjához. Az AI Engine plugin esetén:

claude mcp add wordpress-site https://WEBOLDALAM.hu/wp-json/mcp/v1/http 
  --transport http 
  --header "Authorization: Bearer SAJÁT_BEARER_TOKENEM"

Ha a hivatalos MCP Adapter plugint és application password-öt használsz, a hitelesítés így néz ki:

claude mcp add wordpress-site https://WEBOLDALAM.hu/wp-json/mcp/v1 
  --transport http 
  --header "Authorization: Basic $(echo -n 'felhasznalonev:alkalmazasjelszó' | base64)"

Ahol az alkalmazasjelszó a WordPress által generált application password, szóközök nélkül.

Kritikus megjegyzés: ne szerkeszd kézzel a ~/.claude/settings.json fájlt. A claude mcp add parancs nemcsak a konfigurációs fájlt módosítja, hanem belső nyilvántartásokat is frissít, amelyek kézzel nem reprodukálhatók megbízhatóan.

Az MCP szerver hozzáadása után ellenőrizd a listát:

claude mcp list

A wordpress-site névnek meg kell jelennie a listában.

Az első kapcsolat tesztelése

Indítsd el a Claude Code-ot:

claude

A megnyíló interaktív terminálban próbálj egy egyszerű parancsot:

Listázd ki az utolsó 5 WordPress bejegyzésemet.

Ha minden rendben van, Claude Code lekéri a bejegyzéseket az MCP-n keresztül, és listában megjeleníti a terminálban. Ha ez sikerül, az integráció működik.

Ezután már komplexebb feladatokra is kiadhatsz utasítást:

Hozz létre egy piszkozat bejegyzést a következő témában: 
"10 tipp a WordPress weboldal sebességének növeléséhez". 
Add hozzá a "WordPress" és "optimalizálás" tageket, 
és állítsd be a kategóriát IT Blogra.

A weboldal üzemeltetésére és optimalizálására vonatkozó feladatokhoz érdemes áttekinteni a felhő üzemeltetési szolgáltatások körét is, amelyek kiegészítik az automatizált tartalomkezelést.

Biztonsági szempontok

Az MCP teljes admin hozzáférést biztosíthat Claude Code számára. Ez hatalmas előny a hatékonyság szempontjából, de komoly felelősséggel jár.

Amit mindenképp be kell tartani:

  • Soha ne éles weboldal application password-jét oszd meg senkivel, és ne tárold verziókezelőben (pl. Git-repóban).
  • A Bearer Tokent rendszeresen cseréld le, különösen ha mások is hozzáférnek a rendszerhez.
  • Korlátozd az engedélyezett MCP-funkciókat a minimálisan szükségesre – ha csak cikkeket akarsz írni, a plugin- és témaadminisztrációt nem kell engedélyezni.
  • Éles oldalon először csak olvasási parancsokat tesztelj, mielőtt írási műveleteket engednél.
  • Az application password bármikor visszavonható a WordPress adminból – ha gyanús aktivitást észlelsz, azonnal tedd meg.

A szervered és weboldalad biztonságának fenntartásához érdemes elolvasni a szerver biztonsági checklist cikkünket is, amely részletesen tárgyalja az alapvető védelmi intézkedéseket.

Troubleshooting – a leggyakoribb hibák és megoldásaik

1. „Couldn’t reach the MCP server” hiba

Ez a leggyakoribb hibaüzenet. Lehetséges okai:

  • Az MCP-végpont URL nem elérhető. Nyisd meg böngészőben a https://WEBOLDALAM.hu/wp-json/mcp/v1/http URL-t. Ha 404-et vagy üres oldalt kapsz, az MCP plugin nincs aktiválva, vagy a permalinkek nincsenek frissítve. Menj a WordPress adminban a Beállítások → Permalinkek menüpontra, és kattints a mentés gombra frissítés nélkül is – ez újragenerálja a .htaccess szabályokat.
  • Helyi fejlesztői környezet. Ha a WordPress localhoston fut, a Claude Code nem tudja elérni, mert az MCP HTTP transzport külső URL-t vár. Használj ngrokot vagy hasonló tunneling megoldást, vagy válts STDIO transzportra WP-CLI segítségével.
  • WAF vagy tűzfal blokkolja. Egyes hosting-szolgáltatók (pl. WP Engine, Kinsta) agresszív WAF-szabályokat alkalmaznak, amelyek blokkolhatják az MCP-kéréseket. Fehérlistázd a Claude Code IP-tartományát, vagy kapcsold ki ideiglenesen a WAF-ot tesztelés idejére.

2. 401 Unauthorized hiba

A hitelesítés nem sikerült. Ellenőrizd:

  • A Bearer Token pontosan megegyezik-e azzal, amit az AI Engine beállításaiban megadtál. Másolj-beillesztés helyett írd be újra, ha gyanakszol elírásra.
  • Application password esetén: a base64-kódolás a felhasznalonev:jelszó formátumot várja, ahol a jelszóban a szóközöket el kell távolítani (az application password szóközzel jelenik meg a WordPressben, de kódoláskor szóköz nélkül kell megadni).
  • Az oldalad HTTPS-en fut-e? HTTP esetén az application passwordök nem működnek.

3. 403 Forbidden hiba

A hitelesítés sikerült, de az engedély hiányzik:

  • A WordPress-felhasználó, akinek az application password-jét használod, rendelkezik-e a szükséges jogosultságokkal? Tartalomkezeléshez legalább editor szintű jog szükséges, plugin- és témaadminisztrációhoz administrator.
  • Az AI Engine MCP beállításaiban engedélyezve vannak-e a kívánt funkciók?

4. Claude Code nem látja az MCP szervert indítás után

Ez akkor fordulhat elő, ha a konfigurációt kézzel szerkeszted. Megoldás:

claude mcp remove wordpress-site
claude mcp add wordpress-site https://WEBOLDALAM.hu/wp-json/mcp/v1/http 
  --transport http 
  --header "Authorization: Bearer SAJÁT_TOKENEM"

A teljes törlés-újrahozzáadás megbízhatóbb, mint a kézi javítás.

5. SSL/TLS tanúsítványhiba

Ha önaláírt tanúsítványt használsz (helyi fejlesztői környezetben), Claude Code elutasítja a kapcsolatot. Éles oldalon ezt nem szabad tapasztalni – ha mégis előfordul, ellenőrizd, hogy a tanúsítványod érvényes-e és a teljes tanúsítványlánc telepítve van-e a szerveren.

6. Időtúllépés nagy műveleteknél

Ha Claude Code egy nagy műveletet hajt végre (pl. 50 bejegyzés átnézése), előfordulhat, hogy az MCP szerver időtúllépéssel válaszol. Megoldás: bontsd kisebb részfeladatokra az utasításokat, pl. „Listázd az első 10 bejegyzést” helyett tízenként dolgozz végig.

7. A wp-json végpont le van tiltva

Egyes biztonsági pluginek (pl. Wordfence, iThemes Security) letilthatják a REST API-t. Ellenőrizd a beállításaikat, és engedélyezd a REST API-t legalább hitelesített felhasználók számára.

Összefoglalás

A Claude Code és a WordPress összekötése MCP-n keresztül – WordPress application password segítségével – nem bonyolult folyamat, de pontos végrehajtást igényel. A legfontosabb lépések: egy dedikált application password létrehozása a WordPress profilban, egy MCP-kompatibilis plugin (pl. AI Engine) beállítása, majd a claude mcp add parancs futtatása a terminálban.

Az integráció elkészülte után Claude Code képes cikkeket írni, piszkozatokat kezelni, médiatartalmat feltölteni és számos adminisztratív feladatot elvégezni – mindössze természetes nyelven megfogalmazott utasításokra. Ez különösen hasznos lehet azok számára, akik rendszeres tartalomkészítéssel foglalkoznak, vagy nagyobb WordPress-projekten dolgoznak.

Ha a WordPress-weboldal üzemeltetésével, fejlesztésével vagy az automatizálási lehetőségek kibővítésével kapcsolatban kérdésed merül fel, a Professional IT Services tartalomkészítési és weboldal-fejlesztési szolgáltatásai segítséget nyújtanak a következő lépésekben.

Külső referenciák:

Shopping Cart
Scroll to Top