AI-kliensek csatlakoztatása

Az MCP-szervert többféle AI-klienshez is csatlakoztathatod. A kézi beállítások mind az npx -y @mainwp/mcp parancsot futtatják a vezérlőpult címével, a WordPress-felhasználóneveddel és egy Application Passworddel. Ha a hitelesítő adatokat egy központi ~/.config/mainwp-mcp/settings.json fájlban tartod, az alábbi példákból az env blokk elhagyható (lásd A szerver beállításai).

A vezérlőpult 6.3-ban a MainWP → AI → MainWP MCP oldalon vezetett beállítás van. Az Application Password sikerüzenetének Connect an AI tool panelje előre kitöltött Claude Code, Cursor és VS Code konfigurációt ad. A jelszó látható ideje alatt másold ki a kliensednek megfelelő formátumot.

Claude Desktop: telepítés MCP-csomaggal

A Claude Desktop (macOS és Windows) a MainWP MCP-szervert egyetlen mainwp-mcp.mcpb bővítményfájlból telepíti. A vezérlőpult adatait a Configure űrlapon adod meg, így a claude_desktop_config.json fájlt nem kell szerkesztened. Ez csak a Desktop-csevegésekhez telepíti a szervert; a Claude Code bővítményének ügynökképessége és /mainwp:* parancsai a külön CLI-telepítéshez tartoznak.

Előfeltételek

• A vezérlőpultnak HTTPS-en kell elérhetőnek lennie arról a gépről, amelyen a Claude Desktop fut. A szerver elutasítja a http:// címeket, és a csomagban nincs beállítás ezek engedélyezésére. A vezérlőpult verziókövetelményei ugyanazok, mint bármely más beállításnál (lásd MCP-szerver: áttekintés és gyorsindítás).
• Application Password ahhoz a WordPress-felhasználóhoz, akinek a nevében a szerver dolgozik. A felhasználónak kell a manage_options jogosultság, amely az adminisztrátoroknál megvan. A jelszót az Access → Application Passwords oldalon (API Access) az Add Application Password gombbal, vagy a felhasználó Felhasználók → Profil oldalán hozhatod létre. A WordPress a jelszót csak egyszer mutatja, ezért másold ki, mielőtt bezárod az ablakot.
• Claude Desktop macOS-re vagy Windowsra.

A csomag Node.js 20.19-et vagy újabbat kér. Alapból a Claude Desktop beépített Node.js-én fut, és a Desktop All requirements met üzenetet ad, ezért külön Node.js-t nem kell telepítened.

A csomag telepítése

1. Töltsd le a mainwp-mcp.mcpb fájlt a MainWP MCP hivatalos kiadásából, és mentsd azon a gépen, amelyen a Claude Desktop fut.

2. Nyisd meg a Claude Desktop beállításait (macOS-en a menüsorban Claude → Settings…). Menj az Extensions → Advanced settings → Install extension helyre, és válaszd ki a mainwp-mcp.mcpb fájlt. macOS-en a fájlválasztóban a Preview gombbal megnyithatod a bővítmény részleteit.

3. Ellenőrizd, hogy a bővítmény neve MainWP, és All requirements met látszik. Nézd át a figyelmeztetést, kattints az Install gombra, majd erősítsd meg a következő ablakban. Ha a MainWP már telepítve van, az első gomb Update.

4. A Settings → Extensions → Installed on your computer listában keresd meg a MainWP-t, és kattints a Configure gombra. Add meg:

   • Dashboard URL (kötelező): a vezérlőpult teljes HTTPS-címe, például https://a-te-vezerlopultod.hu.
   • WordPress username (kötelező): annak a felhasználónak a belépési neve, akié az Application Password.
   • WordPress Application Password (kötelező): a felhasználó Application Passwordje.

   Kattints a Save gombra, és ellenőrizd, hogy a MainWP bővítmény be van kapcsolva. Meglévő kapcsolat módosításakor kapcsold ki, majd be a bővítményt.

5. A konfigurációs oldalon görgess a Tool permissions részhez. A Claude Desktop itt szétválasztja a Read-only tools és a Write/delete tools csoportot. Ha át akarod nézni a módosításokat végrehajtásuk előtt, hagyd az érintett eszközöket Needs approval beállításon. Ha a Desktop-kapcsolatot csak olvasásra akarod korlátozni, állítsd a Write/delete tools csoportot Blocked értékre, és nézd át az egyes eszközöket a kivételek miatt. Elérhető még az Always allow és a Custom is.

6. Térj vissza a Claude-hoz, indíts új csevegést, és kérdezd: „Use MainWP to list all my sites. Do not change anything.” Ha a Desktop engedélyt kér egy MainWP-eszközre, kattints az Allow once gombra. Működő kapcsolatnál az asszisztens felsorolja a gyermekwebhelyeket. Kapcsolati hibánál a MainWP → Configure alatt javítsd az adatokat.

Módosítások végzése a Claude Desktopból

A Claude Desktop akkor módosíthatja a WordPress-webhelyeidet a MainWP-n át, ha a szükséges írási eszköz elérhető és engedélyezett. Az olvasásra korlátozott kapcsolat megvizsgálhatja a webhelyeket és javaslatokat készíthet, de nem hajthatja végre azokat.

1. Nyisd meg a Settings → Extensions → MainWP → Configure → Tool permissions részt.
2. A Write/delete tools alatt keresd meg a kívánt műveletet, és válaszd a Needs approval értéket. A Blocked eszköz nem futhat.
3. Új Desktop-csevegésben nevezd meg a gyermekwebhelyet és a pontos változtatást. Például, ha a Hello Dolly telepítve van, de inaktív egy tesztwebhelyen: „Activate Hello Dolly on Example Test Site. Leave every other plugin unchanged.” A példanevet cseréld a saját webhelyed nevére.
4. Nézd át a kért eszközt és a bemeneteit, majd kattints az Allow once gombra. Ez egyetlen hívást engedélyez; az Always allow az eszköz jövőbeli hívásait is engedélyezi.
5. A Hello Dolly aktiválása nem romboló műveletnek számít, ezért a példánál nincs külön MainWP-megerősítés. Ha a MainWP egy romboló műveletnél megerősítést kér, nézd át, és a csevegésben kifejezetten hagyd jóvá a leírt változtatást. A Desktop eszközjóváhagyása és a MainWP szerveroldali megerősítése két külön lépés.
6. Kérd meg a Claude-ot, hogy ellenőrizze az eredményt, majd nézd meg magán a gyermekwebhelyen is.

Desktop-eszközjogosultság	Mi történik
Needs approval	A Claude megkérdezi, mielőtt használja az eszközt. Az Allow once a függőben lévő hívást engedi.
Blocked	A Claude nem hívhatja az eszközt. A művelet kérése előtt változtasd meg a jogosultságot.
Always allow	A Claude minden alkalommal, Desktop-jóváhagyás nélkül hívhatja az eszközt. A MainWP szerveroldali szabályai továbbra is érvényesek.

A Desktop-jóváhagyás nem írja felül a MainWP szerverbeállításait: az csak olvasó eszközlista (allowlist) eltávolítja az írási eszközöket, a biztonságos mód (safe mode) pedig blokkolja a romboló műveleteket. A biztonságos mód önmagában nem jelent csak olvasást, mert néhány engedélyezett művelet módosítja a webhelyeket. Hagyd bekapcsolva a requireUserConfirmation beállítást. A csomag esetén a safeMode, allowedTools, blockedTools és requireUserConfirmation értékeket a ~/.config/mainwp-mcp/settings.json fájlba írd, mert a Configure űrlapon csak a három kapcsolati mező van. A fájl módosítása után kapcsold ki, majd be a bővítményt. Részletek: A szerver beállításai és Eszközök korlátozása.

Ha korábban kézzel felvettél egy mainwp bejegyzést a claude_desktop_config.json fájlba, töröld, és indítsd újra a Claude Desktopot, hogy ne fusson két példány. A törlés előtt mentsd el a még szükséges választható beállításokat.

A telepítési figyelmeztetésről

A telepítési ablak ezt a figyelmeztetést mutatja: a telepítés hozzáférést ad a bővítménynek a számítógéped minden tartalmához, és a fejlesztői adatokat az Anthropic nem ellenőrizte. A Claude Desktop ezt minden fájlból, a saját könyvtárán kívülről telepített bővítménynél megmutatja, ez nem jelenti, hogy a fájlban hibát talált. Két dolgot jelent:

• Hozzáférés a számítógéphez: a bővítmény programként fut a gépeden, a felhasználói fiókod jogosultságaival, mint bármely telepített alkalmazás. A szerver erre csatlakozik a vezérlőpulthoz. A forráskódja nyilvános a mainwp-mcp tárolóban.
• Nem az Anthropic ellenőrizte: az ablakban látható név, szerző és hivatkozások a csomagfájlból jönnek, ezért nem bizonyítják, hogy a fájlt a MainWP készítette.

Mivel az ablak nem tudja igazolni a fájl eredetét, csak a MainWP kiadási oldaláról töltsd le, és kívánság szerint ellenőrizd az alábbiak szerint.

A letöltés ellenőrzése

Minden kiadás két módot ad a mainwp-mcp.mcpb telepítés előtti ellenőrzésére.

Ellenőrzőösszeg. A kiadás tartalmaz egy mainwp-mcp.mcpb.sha256 fájlt a csomag SHA-256 hash-ével. Töltsd le ugyanabba a mappába. Ha a böngésző átnevezte a csomagot (például mainwp-mcp (1).mcpb), nevezd vissza mainwp-mcp.mcpb névre. macOS-en a Terminálban, abban a mappában:

shasum -a 256 -c mainwp-mcp.mcpb.sha256

Egyezésnél a kimenet mainwp-mcp.mcpb: OK. Windowson PowerShellben, abban a mappában:

$expected = ((Get-Content .\mainwp-mcp.mcpb.sha256 -Raw).Trim() -split '\s+')[0]
if ((Get-FileHash .\mainwp-mcp.mcpb -Algorithm SHA256).Hash -eq $expected) { 'OK' } else { 'MISMATCH' }

Egyezésnél OK, eltérésnél MISMATCH az eredmény. Az ellenőrzőösszeg a sérült vagy hiányos letöltést fogja meg. Ugyanabból a kiadásból származik, mint a csomag, ezért nem bizonyítja, ki építette a fájlt. Ezt a build-igazolás (attestation) teszi.

Build-igazolás. Minden csomaghoz tartozik egy aláírt build-igazolás, amelyet a kiadási folyamat hoz létre a GitHubon a fájl építésekor, és amely a fájlt a mainwp/mainwp-mcp tárolóhoz és a létrehozó futáshoz köti. Telepítsd a GitHub CLI-t, jelentkezz be a gh auth login paranccsal, majd futtasd a csomag mappájából:

gh attestation verify mainwp-mcp.mcpb --repo mainwp/mainwp-mcp

A parancs hibát ad, ha a fájlt a build után módosították, vagy nem a mainwp/mainwp-mcp tárolóban építették.

A kapcsolati adatok módosítása

1. A Settings → Extensions alatt, az Installed on your computer listában keresd meg a MainWP-t, és kattints a Configure gombra.
2. Módosítsd a Dashboard URL-t, a felhasználónevet vagy az Application Passwordöt.
3. Kattints a Save gombra.
4. Kapcsold ki, majd be a bővítményt, hogy a szerver az új értékekkel induljon újra.

Mező	Mit írj bele
Dashboard URL	A vezérlőpult HTTPS-címe, például https://a-te-vezerlopultod.hu. Ha a WordPress almappában van, add meg az útvonalat is, például https://a-te-vezerlopultod.hu/wp. A záró perjel nem gond.
WordPress username	Az Application Password tulajdonosának belépési neve vagy e-mail-címe. A megjelenített név nem jó.
WordPress Application Password	Az ehhez a kapcsolathoz létrehozott Application Password, nem a felhasználó belépési jelszava. A csoportok közti szóközök nem gond. A Claude Desktop érzékeny mezőként kezeli, és az operációs rendszer biztonságos tárában tárolja: macOS-en a Kulcskarikán, Windowson a Hitelesítőadat-kezelőben.

A szerver a felhasználó WordPress-jogosultságaival dolgozik. A MainWP-eszközökhöz a manage_options jogosultság kell, ezért ennek hiányában minden MainWP-eszközhívás jogosultsági hibát ad. Érdemes külön WordPress-felhasználót használni az AI-hozzáféréshez: átlátható marad a vezérlőpult naplója, és könnyű visszavonni. A csomag a három értéket MAINWP_URL, MAINWP_USER és MAINWP_APP_PASSWORD néven adja át a szervernek. Más beállításokhoz nincs mező: a biztonságos módot és az eszközszűrést a ~/.config/mainwp-mcp/settings.json fájlban add meg. A csomag kapcsolati értékei elsőbbséget élveznek a fájlban lévő kapcsolati értékekkel szemben. A szerver először a munkakönyvtárában lévő ./settings.json fájlt keresi, utána a központit, és csak az elsőként talált fájlt használja; a két fájlt nem egyesíti.

A csomag frissítése

A Claude Desktop nem frissíti automatikusan a fájlból telepített csomagokat. Új szerververziónál:

1. Töltsd le a mainwp-mcp.mcpb fájlt a legújabb kiadásról.
2. Telepítsd ugyanúgy, mint az elsőt.
3. Kattints a MainWP bővítmény Configure gombjára, ellenőrizd, hogy a három mezőben még ott van a vezérlőpult címe, a felhasználónév és az Application Password, majd kérd meg a Claude-ot, hogy listázza a webhelyeidet.

A csomag eltávolítása

1. A Claude Desktopban a Settings → Extensions alatt nyisd meg a MainWP bővítmény ⋯ menüjét az Installed on your computer listában, és válaszd az Uninstall lehetőséget.
2. A vezérlőpulton az Access → Application Passwords oldalon kattints a Claude Desktophoz létrehozott jelszó Revoke gombjára. A visszavonás után a jelszó minden másolata használhatatlan lesz, bárhol is tárolod.

Hibaelhárítás: Claude Desktop-csomag

A szerver indítási üzeneteit és hibáit a Settings → Developer alatt olvashatod: válaszd a MainWP-t a Local MCP servers között, és kattints a View logs gombra.

„dashboardUrl uses HTTP which transmits credentials in plain text”. A teljes üzenet: dashboardUrl uses HTTP which transmits credentials in plain text. Use HTTPS, or set allowHttp=true to allow insecure connections (not recommended). A Dashboard URL http://-vel kezdődik, ezért a szerver indításkor leáll, nehogy titkosítatlanul küldje az Application Passwordöt. Kapcsold be a HTTPS-t a vezérlőpulton, és a Dashboard URL mezőbe az https:// címet írd. Az üzenetben említett allowHttp nem mező a csomagban: elszigetelt helyi fejlesztéshez a ~/.config/mainwp-mcp/settings.json fájlban állítható. Hálózaton elért vezérlőpultnál ne használd.

„Invalid dashboardUrl: is not a valid URL”. A Dashboard URL mező nem teljes webcímet tartalmaz. Add meg a teljes címet az https:// előtaggal.

A Claude csak a mainwp_get_setup_status és a mainwp_configure eszközt látja. A szerver elindult, de nem tudott csatlakozni, ezért telepítési módban van, és a MainWP-eszközök rejtve maradnak. Kérd meg a Claude-ot, hogy ellenőrizze a MainWP-kapcsolat állapotát: ő a mainwp_get_setup_status eszközt hívja, amely az alábbi állapotok egyikét jelenti:

• credentials_rejected: a vezérlőpult elutasította a felhasználónevet vagy az Application Passwordöt. A jelentés megnevezi a felhasználót, és megmondja a valószínű okot, például The Dashboard has no user "..." (invalid_username), ha megjelenített nevet írtál be belépési név helyett, vagy The Dashboard rejected the application password for user "..." (incorrect_password), ha a fiók belépési jelszavát adtad meg. Ha a felhasználónév úgy néz ki, mint egy Application Password, a jelentés jelzi, hogy a két mező felcserélődhetett. Javítsd az értékeket a Configure alatt, majd kapcsold ki és be a bővítményt.
• degraded: a vezérlőpult nem érhető el, vagy nem hitelesítési hibával válaszolt, például TLS-hibával, HTTP 5xx-szel vagy egy tűzfal puszta HTTP 403 válaszával. Ellenőrizd, hogy a vezérlőpult működik és elérhető erről a gépről, majd kérd meg a Claude-ot, hogy ellenőrizze újra a kapcsolatot. A szerver a már meglévő adatokkal újra próbálkozik.

A mainwp_configure eszközzel végzett csevegésalapú beállítás a csomagnál nem alkalmazható: a csomag környezeti változóként adja a kapcsolati értékeket, a mainwp_configure pedig nem ment el olyan adatot, amelyet a környezeti változók felülírnának. Az értékeket a Configure alatt javítsd. További részletek: Elutasított hitelesítő adatok.

SSL-tanúsítvány hiba. Az UNABLE_TO_VERIFY_LEAF_SIGNATURE jellegű hibák azt jelentik, hogy a szerver nem tudta ellenőrizni a vezérlőpult tanúsítványát. Telepítsd a teljes tanúsítványláncot a vezérlőpultra, és ellenőrizd, hogy a tanúsítvány egyezik a domainnel, és nem járt le.

Önaláírt vagy helyi tanúsítványú vezérlőpult. A csomag alapból ellenőrzi a tanúsítványt. Az önaláírt vagy helyi hitelesítésszolgáltatótól származó tanúsítvánnyal rendelkező vezérlőpult (például egy helyi fejlesztői webhely) nem csatlakozik, és a naplóban fetch failed vagy tanúsítványhibakód látszik. Elszigetelt helyi fejlesztői vezérlőpultnál a csomag a központi konfigurációs fájl skipSslVerify beállítását olvassa (lásd SSL). Csak elszigetelt fejlesztői környezetben használd; éles vezérlőpultnak nyilvánosan megbízható tanúsítvány kell.

Claude Code CLI

A Claude Code bővítmény tartalmazza az MCP-szervert, a mainwp-dashboard ügynökképességet (agent skill) és tíz /mainwp:* munkafolyamat-parancsot.

Előfeltételek

Telepített és bejelentkezett Claude Code CLI, Node.js 20.19 vagy újabb az npx-szel, és HTTPS-kapcsolat a vezérlőpulthoz. Hozz létre egy WordPress Application Passwordöt egy olyan vezérlőpult-felhasználónak, akinek megvan a manage_options jogosultsága (ez az adminisztrátoroké).

Telepítés

1. Nyisd meg a terminált, és futtasd:

   claude plugin marketplace add mainwp/mainwp-mcp
   claude plugin install mainwp@mainwp-mcp

   Ha már van nyitott, interaktív Claude Code-munkamenet, ott a slash-parancsokat használd:

   /plugin marketplace add mainwp/mainwp-mcp
   /plugin install mainwp@mainwp-mcp

   A két forma ugyanazt a bővítményt telepíti: azt válaszd, amelyik ott van, ahol dolgozol.

2. Add meg a vezérlőpult címét, a WordPress-felhasználónevet és az Application Passwordöt abban a környezetben, amely a Claude Code-ot indítja, vagy a központi settings.json fájlban (lásd alább).

3. Indíts új Claude Code-munkamenetet a claude paranccsal. Ha már nyitva volt egy munkamenet, a kapcsolati beállítások módosítása után indítsd újra. Ha csak a bővítményt telepítetted, és a kapcsolati beállítások nem változtak, a meglévő munkamenetben elég a /reload-plugins.

4. Futtasd a /mainwp:setup parancsot, majd kérdezd: „List all my sites”. Működő kapcsolatnál a Claude név és webcím szerint felsorolja a gyermekwebhelyeket. A /mainwp:tools parancs megmutatja, milyen képességeket kínál a vezérlőpultod.

Hitelesítő adatok és beállítások

A bővítmény nem hordoz hitelesítő adatokat. Az általa indított szerver a Claude Code környezetéből örökli a MAINWP_URL, MAINWP_USER és MAINWP_APP_PASSWORD változókat, ezért exportáld ezeket abban a shellprofilban vagy indítóban, amely a Claude Code-ot elindítja. A központi ~/.config/mainwp-mcp/settings.json is működik. A szerver először a munkakönyvtárában lévő ./settings.json fájlt nézi, és csak az elsőként talált fájlt használja, ezért a Claude Code indítási mappájában lévő fájl elsőbbséget élvez a központival szemben; a fájlok nem egyesülnek. A választható beállítások (például a biztonságos mód vagy az eszközszűrők) ugyanebből a környezetből vagy a központi settings.json fájlból jöhetnek. A környezeti változók elsőbbséget élveznek a fájlbeállításokkal szemben. A bővítmény saját env térképet nem hoz.

Csak olvasás és módosítás

A bővítmény telepítése nem teszi csak olvashatóvá a vezérlőpultot. Hogy a Claude mit tehet, az a szerver által mutatott eszközöktől, a szerver beállításaitól és annak a WordPress-felhasználónak a jogosultságaitól függ, akinek az Application Passwordjét használod. A Claude Code saját eszközjogosultságai is megakadályozhatnak egy hívást.

Beállítás	Mit tehetsz a Claude Code-ban
Csak olvasó eszközlista (allowlist)	Webhelyeket vizsgálhatsz, problémákat diagnosztizálhatsz, jelentéseket és terveket készíthetsz. A Claude nem hajthat végre változtatást, mert az írási eszközök nem érhetők el.
Biztonságos mód (safeMode: true)	Adatot olvashatsz, és a vezérlőpult által nem rombolónak minősített műveleteket használhatod. A bővítmények és témák aktiválása és a webhelyek szinkronizálása így is módosíthatja a webhelyeket. A romboló hívások blokkolva vannak, a 6.3-as és újabb vezérlőpultnál a frissítések is.
Normál működés (safeMode: false, az alapérték)	A Claude-tól kérhetsz változtatásokat a rendelkezésre álló eszközökkel. A romboló műveleteknél a szerver megerősítési folyamata lép működésbe, ha a requireUserConfirmation be van kapcsolva (alapból be van).

Szigorúan csak olvasó hozzáféréshez az csak olvasó eszközlistát használd. A biztonságos mód önmagában nem csak olvasás: a 6.3 előtti vezérlőpultokon a frissítéseket is engedi. Egy módosítás végrehajtásához a művelet eszközének elérhetőnek kell lennie: ha allowedTools-t használsz, vedd bele, és a blockedTools ne zárja ki. Romboló művelethez a biztonságos módnak kikapcsolva kell lennie. Hagyd bekapcsolva a requireUserConfirmation beállítást, nézd át az előnézetet vagy a megerősítési kérést, és hagyd jóvá az adott műveletet, mielőtt a Claude végrehajtja. A jóváhagyás nem írja felül a biztonságos módot, az eszközszűrőket és a WordPress-jogosultságokat.

A legtöbb /mainwp:* parancs adatot vizsgál vagy tervet készít. A /mainwp:update-workflow például frissítési tervet állít össze átnézésre, és nem alkalmazza automatikusan a frissítéseket. A terv átnézése után kérd meg a Claude-ot a kívánt módosítások végrehajtására. Csak olvasó munkamenetben előbb módosítanod kell a szerver beállításait, hogy az írási eszközök elérhetők legyenek, majd újra kell indítanod a Claude Code-ot.

Ha már kézzel felvettél mainwp szervert

A Claude Code elnyomja azt a bővítményszervert, amely megegyezik egy kézzel beállítottal (a parancs és az argumentumok alapján). A kézzel felvett, szabványos npx -y @mainwp/mcp parancsú mainwp bejegyzés csendben nyer: a bővítmény szervere el sem indul, a bővítmény viszont továbbra is adja a parancsait és az ügynökképességet. Ha a kézi bejegyzés másik parancsot futtat (rögzített verzió, helyi másolat), az nem duplikátum, ezért mindkét szerver elindul. A bővítmény példánya az indító környezetét és az első talált settings.json fájlt olvassa, a környezeti változók elsőbbségével. Mielőtt egy beállításra támaszkodnál, a claude mcp list paranccsal, vagy a Claude Code-munkamenetben az /mcp paranccsal nézd meg, melyik MainWP-szerver aktív. A bővítmény szerverére váltás:

1. Vidd át a kézi bejegyzés env blokkjának teljes tartalmát (a hitelesítő adatokat és a MAINWP_* beállításokat, például a biztonságos módot vagy az eszközszűrőket) a Claude Code-ot indító környezetbe, vagy az első betöltendő settings.json megfelelő mezőibe. A szerver a munkakönyvtárában lévő ./settings.json fájlt keresi előbb, utána a ~/.config/mainwp-mcp/settings.json fájlt; a fájlok nem egyesülnek.
2. Töröld a kézi bejegyzést.

A bővítmény szándékosan nem hoz env térképet. A kézi bejegyzés törlése előtt mentsd el ezeket az értékeket a szerver által betöltött környezetben vagy fájlban, különben a bővítmény szervere hitelesítő adatok nélkül, vagy a korábbitól eltérő beállításokkal indulhat.

Az ügynökképesség

A mainwp-dashboard ügynökképesség (skill) automatikusan betöltődik, amikor egy feladat webhelyek MainWP-n át kezelésével jár. Megtanítja az ügynöknek a szerver működését: az eszközkatalógus futásidőben a vezérlőpultból jön, és verziótól, kiegészítőktől és szűréstől függően változik; a romboló műveletek felhasználói megerősítésnél megállnak; a biztonságos mód végrehajtáskor blokkolja a romboló hívásokat; az eszközszűrés szándékosan eltávolíthat eszközöket, és az ügynök ezt jelzi, ahelyett hogy megkerülné.

Munkafolyamat-parancsok

Parancs	Mit csinál
/mainwp:setup	Az MCP-kapcsolat és a konfiguráció diagnosztizálása titkok felfedése nélkül
/mainwp:tools	A vezérlőpult által kínált képességek megmutatása csoportosítva
/mainwp:network-summary	Vezetői összefoglaló a hálózatról: webhelyszám, frissítések összesen, állapot
/mainwp:site-report	Részletes jelentés egy webhelyről: áttekintés, frissítések, állapot, következő lépések
/mainwp:troubleshoot-site	Egy webhely diagnosztizálása: kapcsolat, szinkronállapot, függő frissítések, hibák
/mainwp:update-workflow	Biztonságos frissítési kör megtervezése: mit, milyen sorrendben, mely webhelyeken
/mainwp:security-audit	Biztonsági felmérés: elavult mag, bővítmények, témák
/mainwp:backup-status	A mentések lefedettsége és frissessége a kezelt webhelyeken
/mainwp:maintenance-check	Karbantartási átvizsgálás minden webhelyen, sürgősség szerint rangsorolva
/mainwp:performance-check	Teljesítménymutatók egy webhelyre vagy a hálózatra, a vezérlőpult adataiból

A /mainwp:site-report és a /mainwp:troubleshoot-site webhelyazonosítót vagy nevet fogad. Argumentum nélkül felsorolja a kezelt webhelyeket, és megkérdezi, melyiket szeretnéd. A /mainwp:backup-status, a /mainwp:security-audit és a /mainwp:update-workflow webhelyazonosítókat vagy az all értéket várja a webhelyek körének megadásához. A /mainwp:performance-check egy webhelyazonosítót vagy az all értéket kér. Az üres webhelykör minden kezelt webhelyet jelent. A parancsok a kért webhelyeket a vezérlőpultoddal egyeztetik, és megállnak, ha egy megadott webhely nem található.

Kézi beállítás más kliensekhez

Az alábbi beállításokat használd más AI-klienshez, vagy ha kézi szerverkapcsolatot szeretnél. A Claude Desktop és a Claude Code ajánlott módja a fenti telepítés; a következők csak a kézi konfigurációs alternatívák.

Claude Desktop (kézi konfiguráció)

A konfigurációs fájl helye macOS-en ~/Library/Application Support/Claude/claude_desktop_config.json, Windowson %APPDATA%\Claude\claude_desktop_config.json. A mcpServers blokkba (ha nincs fájl, hozd létre):

{
  "mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "env": {
        "MAINWP_URL": "https://a-te-vezerlopultod.hu",
        "MAINWP_USER": "admin",
        "MAINWP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Cseréld a címet, a felhasználónevet és a jelszót a sajátodra (a jelszó szóközzel és anélkül is jó). Mentés után indítsd újra a Claude Desktopot.

Claude Code CLI (kézi hozzáadás)

A bővítményt, az ügynökképességet és a munkafolyamat-parancsokat nem telepíti, csak az MCP-szervert veszi fel a terminálból:

claude mcp add --transport stdio --scope user mainwp \
  --env MAINWP_URL=https://a-te-vezerlopultod.hu \
  --env MAINWP_USER=admin \
  --env MAINWP_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \
  -- npx -y @mainwp/mcp

Központi beállításfájllal elég a rövid forma:

claude mcp add --transport stdio --scope user mainwp -- npx -y @mainwp/mcp

A user hatókör az összes projektben elérhetővé teszi a szervert. A parancs a jelszót is tartalmazza, ezért bent maradhat a shell előzményeiben. Ugyanezt a szervert megadhatod a ~/.claude.json fájlban is.

Cursor

Add hozzá globálisan a ~/.cursor/mcp.json fájlhoz. A konfiguráció jelszót tartalmaz, ezért ne tedd egy megosztott projekt .cursor/mcp.json fájljába:

{
  "mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "env": {
        "MAINWP_URL": "https://a-te-vezerlopultod.hu",
        "MAINWP_USER": "admin",
        "MAINWP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

A Cursor a ${env:VAR_NAME} helyőrzőket is támogatja, ha a rendszer környezeti változóira szeretnél hivatkozni.

VS Code Copilot

Add hozzá a projekt .vscode/mcp.json fájljához (VS Code 1.101 vagy újabb szükséges, Agent Mode-dal):

{
  "servers": {
    "mainwp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "env": {
        "MAINWP_URL": "https://a-te-vezerlopultod.hu",
        "MAINWP_USER": "admin",
        "MAINWP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

A VS Code futásidőben is kérheti a jelszót, így az sosem kerül a fájlba:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "mainwp_password",
      "description": "MainWP Application Password",
      "password": true
    }
  ],
  "servers": {
    "mainwp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "env": {
        "MAINWP_URL": "https://a-te-vezerlopultod.hu",
        "MAINWP_USER": "admin",
        "MAINWP_APP_PASSWORD": "${input:mainwp_password}"
      }
    }
  }
}

OpenAI Codex

Add hozzá a ~/.codex/config.toml fájlhoz:

[mcp_servers.mainwp]
command = "npx"
args = ["-y", "@mainwp/mcp"]

[mcp_servers.mainwp.env]
MAINWP_URL = "https://a-te-vezerlopultod.hu"
MAINWP_USER = "admin"
MAINWP_APP_PASSWORD = "xxxx xxxx xxxx xxxx xxxx xxxx"

ZenCoder

VS Code-ban a settings.json fájl zencoder.mcpServers kulcsa alá vedd fel:

{
  "zencoder.mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "env": {
        "MAINWP_URL": "https://a-te-vezerlopultod.hu",
        "MAINWP_USER": "admin",
        "MAINWP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

JetBrainsben a Settings → Tools → Zencoder → MCP Servers alatt használd ugyanezt a JSON-szerkezetet.

Más MCP-gazdák

A Windsurf és a legtöbb MCP-gazda ugyanezt a JSON-mintát használja:

• command: npx
• args: ["-y", "@mainwp/mcp"]
• env: MAINWP_URL, MAINWP_USER és MAINWP_APP_PASSWORD

Az MCP-konfiguráció helyét az adott gazda leírásában találod.

Több vezérlőpult kezelése

Adj minden vezérlőpultnak külön mappát a saját settings.json fájljával, és a cwd beállítással mutass minden szerverbejegyzést a megfelelő mappára:

{
  "mcpServers": {
    "mainwp-production": {
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "cwd": "/path/to/production-credentials"
    },
    "mainwp-staging": {
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "cwd": "/path/to/staging-credentials"
    }
  }
}

A szerver a munkakönyvtárában lévő ./settings.json fájlt olvassa elsőként, így minden bejegyzés a saját hitelesítő adatait veszi fel.