API-lehetőségek és MainWP Control

Melyik lehetőséget válaszd?

A MainWP többféle módon érhető el programból, automatizálásból vagy AI-ból. Így illeszkednek egymáshoz:

• A REST API a MainWP rögzített végpontfelülete (/wp-json/mainwp/v2/).
• Az Application Passwordök WordPress-hitelesítő adatok olyan eszközöknek, amelyek felhasználónévvel és jelszóval hitelesítenek.
• Az Abilities API felderíthető képességréteg (/wp-json/wp-abilities/v1/), ahol a MainWP regisztrálja a képességeit.
• Az MCP-szerver integrációs réteg, amely Application Password-hitelesítéssel éri el a MainWP-t AI-eszközökön át.
• A MainWP Control a MainWP parancssori felülete terminálból és szkriptekből való automatizáláshoz, ugyanazokkal a vezérlőpult-képességekkel.

Mire van szükséged?	Hol kezdd?
MainWP-végpontok közvetlen hívása szkriptekből vagy szolgáltatásokból	REST API
Felhasználónév és jelszó alapú API-hitelesítő adatok létrehozása vagy cseréje	Application Passwordök
Az eszközök maguktól fedezzék fel az elérhető műveleteket	Abilities API
AI-asszisztensek bekötése MCP-n át	MCP-szerver
MainWP-feladatok futtatása terminálból, szkriptből, cron-feladatból vagy CI/CD-folyamatból	MainWP Control (lent)

MainWP Control

A MainWP Control a MainWP vezérlőpult parancssori felülete. A terminálból megvizsgálhatod a webhelyeket, ellenőrizheted a frissítéseket, képességeket futtathatsz, és az ismétlődő feladatokat szkriptekben, cron-feladatokban és CI/CD-folyamatokban automatizálhatod. Az MCP-szervertől eltérően, amelyet AI-asszisztensekhez és MCP-kliensekhez terveztek, a MainWP Control közvetlen parancssori használatra való. Mindkettő az Abilities API-t használja, és a védett műveleteknél ugyanazt a biztonsági modellt követi.

Előfeltételek

• Node.js 20.18.1 vagy újabb
• MainWP vezérlőpult 6 vagy újabb
• WordPress 6.9 vagy újabb a vezérlőpulton az Abilities API miatt
• Egy WordPress-felhasználói fiók a szükséges műveletek jogosultságával
• Egy WordPress Application Password ahhoz a felhasználóhoz

Tipikus felhasználás

• Ütemezett karbantartási vagy jelentési feladatok futtatása cronból
• MainWP-műveletek használata CI/CD-folyamatokban és telepítési szkriptekben
• A vezérlőpult lekérdezése, és JSON-kimenet visszaadása más eszközöknek
• Tömeges vagy kötegelt munkafolyamatok futtatása parancssorból

Hogyan működik?

A MainWP Control csatlakozik a vezérlőpulthoz, és a mainwpcontrol paranccsal teszi elérhetővé a műveleteit. Egyszer bejelentkezel, felderíted a vezérlőpult képességeit, majd közvetlenül a terminálból futtatod őket. Ez akkor hasznos, ha böngészőalapú folyamat helyett ismételhető munkafolyamatot szeretnél: szkriptelheted a rutinellenőrzéseket, a JSON-kimenetet átadhatod más eszközöknek, és ugyanazokra a vezérlőpult-műveletekre építhetsz ütemezett feladatokat.

Vezetett beállítás a vezérlőpulton

A MainWP vezérlőpult 6.3 hozzáadja a MainWP → AI → MainWP Control oldalt. Az oldalnak négy lépése van, és kilépés nélkül létrehozhatsz rajta egy Application Passwordöt. Az oldal eléréséhez WordPress-adminisztrátori fiók kell (manage_options jogosultság).

https://minta-bolt.hu/wp-admin/admin.php?page=mainwp-control

A képen a négy lépés (Credentials, Telepítés, Test, Finish) és az első lépés Create Application Password gombja látszik.

1. Hitelesítő adat létrehozása. A Credentials lépésben kattints a Create Application Password gombra, nézd át az előre kitöltött nevet, és kattints a Create gombra. A sikerablak bezárása előtt mentsd el a létrehozott jelszót.
2. Telepítés és bejelentkezés. Válaszd a Telepítés lépést, és a Copy to clipboard gombbal másold ki a telepítő és a bejelentkező parancsot. Futtasd őket azon a gépen vagy szerveren, ahol a MainWP Controlt használni fogod. A bejelentkezés a vezérlőpult címét, a jelszó tulajdonosának WordPress-felhasználónevét és az Application Passwordöt kéri.
3. Próba csak olvasó parancsokkal. A Test lépésben másold ki a mainwpcontrol abilities list és a mainwpcontrol abilities run list-sites-v1 --json parancsot. Futtasd őket a terminálodban, és ellenőrizd a visszaadott webhelyeket.
4. Funkciók és biztonsági megoldások áttekintése. A Finish lépés hivatkozásokat és emlékeztetőket ad a profilokról, a strukturált kimenetről, az előnézetekről, a megerősítésről és a hitelesítő adatokról.

Az oldal szerkeszthető parancsokat ad. Nem futtatja őket, nem telepíti a parancssori programot, és nem ellenőrzi helyetted a kapcsolatot. Az Application Password sikerablakában lévő Connect an AI tool panel az MCP-kliensekhez való; a parancssori programhoz a Control oldal Telepítés és Test lépéseit kövesd.

Telepítés terminálból

A MainWP Control a mainwpcontrol parancsként települ. Egy szokásos indulás:

npm install -g @mainwp/control
mainwpcontrol login
mainwpcontrol abilities list

A vezérlőpulthoz csatlakozás után megnézheted, milyen képességeket kínál a vezérlőpultod, és futtathatod, amelyikre szükséged van. A MainWP Control a profilokon át több vezérlőpultos munkafolyamatot is támogat, ami akkor hasznos, ha külön tesztkörnyezetet és éles vezérlőpultot kezelsz. A kimenet JSON-ként is kérhető, így jól használható shellszkriptekben, felügyeletben és CI/CD-feladatokban.

Bejelentkezés jelszókérés nélkül

A mainwpcontrol login a MAINWP_APP_PASSWORD környezeti változót használja jelszókérés helyett, ha az be van állítva. Állítsd be a MAINWP_DASHBOARD_URL változót is arra a vezérlőpultra, amelyhez a jelszó tartozik, és add meg a hozzá tartozó címet és felhasználónevet a --url és --username kapcsolóval. Ha a bejelentkezés jelzi, hogy a hitelesítő adatok nem kerültek a rendszer kulcstartójába, tartsd elérhetőn mindkét változót a későbbi parancsokhoz.

A HTTP-kérések időkorlátjának módosítása

Az alapértelmezett HTTP-időkorlát 30 másodperc. Ha egy kérés lejár, megnövelheted a settings.json fájl timeout értékét. Az érték ezredmásodpercben van; például a 120000 kérésenként legfeljebb 120 másodpercet enged:

{
  "timeout": 120000
}

Add hozzá vagy módosítsd ezt a tulajdonságot, a többi beállítást ne töröld. Az alapértelmezett fájl a saját mappádban a .config/mainwpcontrol/settings.json. Ha az XDG_CONFIG_HOME be van állítva, a fájl az alatta lévő mainwpcontrol/settings.json. A mainwpcontrol config show paranccsal nézheted meg az érvényes beállításokat.

A frissítési eredmények olvasása

A --json strukturált kimenetet ad szkriptekhez és más eszközökhöz. Ha az abilities run parancsból elhagyod a --json kapcsolót, az eredmény akkor is JSON-ként jelenik meg; a frissítési eredményeket nem alakítja táblázattá. A list-updates-v1 képességgel jelentést építve a page és a per_page paraméterrel kérd le az összes oldalt. A total mező az összes egyező frissítést számolja, ezért nagyobb lehet, mint az aktuális oldal updates tömbjének elemszáma. A jelentést csak akkor tekintsd teljesnek, ha megnézted a visszaadott errors mezőt. A mainwpcontrol abilities info list-updates-v1 paranccsal megnézheted, milyen bemeneti séma érhető el a vezérlőpulton. A frissítéslista a vezérlőpultban már tárolt adatokat tükrözi; a listázás nem indít új webhelyszinkront.

MainWP Control és MCP-szerver

A MainWP Controlt válaszd, ha ezekre van szükséged:

• Parancssori felület szkriptekhez, ütemezett feladatokhoz és shellalapú automatizáláshoz
• Strukturált kimenet, JSON is, folyamatokhoz és felügyelethez
• Kifejezett parancsok természetes nyelvű kérések helyett

Az MCP-szervert válaszd, ha ezt szeretnéd:

• Claude, Cursor, OpenAI Codex, VS Code Copilot vagy más MCP-kliens hívja a MainWP-eszközöket
• Beszélgetésalapú hozzáférés a MainWP-hez egy AI-asszisztensen át

Biztonsági modell

A MainWP Control ugyanazt a MainWP-képességmodellt használja, mint az MCP-szerver. Az olvasó műveletek közvetlenül futtathatók, a védett vagy romboló műveleteknél a folyamat kifejezett előnézetet és megerősítést kér. Ezért a parancssor jobban illik az automatizáláshoz, mint az eseti böngészős műveletek: ismételhető munkafolyamatokat építhetsz egyértelmű parancsviselkedésre.