# AI-kliensek csatlakoztatása > A MainWP MCP-szerver telepítése Claude Desktopba és Claude Code-ba, kézi beállítás Cursorhoz, VS Code-hoz, Codexhez és más kliensekhez. 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](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-beallitasok/)). 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](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-attekintes/#követelmények)). - 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](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-beallitasok/) és [Eszközök korlátozása](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-beallitasok/#elérhető-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: ```bash shasum -a 256 -c mainwp-mcp.mcpb.sha256 ``` Egyezésnél a kimenet `mainwp-mcp.mcpb: OK`. Windowson PowerShellben, abban a mappában: ```powershell $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: ```bash 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](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-beallitasok/#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](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-beallitasok/#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: ```bash 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: ```text /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](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-beallitasok/#kész-konfigurációk) 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): ```json { "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: ```bash 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: ```bash 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: ```json { "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): ```json { "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: ```json { "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: ```toml [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: ```json { "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: ```json { "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.