# API-lehetőségek és MainWP Control

> Melyik API-utat válaszd, és hogyan automatizálhatod a vezérlőpultot parancssorból a MainWP Controllal.

## 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](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-attekintes/) |
| Felhasználónév és jelszó alapú API-hitelesítő adatok létrehozása vagy cseréje | [Application Passwordök](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-alkalmazasjelszavak/) |
| Az eszközök maguktól fedezzék fel az elérhető műveleteket | [Abilities API](https://hub.hellowp.io/hu/plugins/mainwp/abilities-api-attekintes/) |
| AI-asszisztensek bekötése MCP-n át | [MCP-szerver](https://hub.hellowp.io/hu/plugins/mainwp/mcp-szerver-attekintes/) |
| 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).

![A MainWP Control vezérlőpult-oldala: az első lépés az Application Password létrehozása](./kepek/mcp-szerver-control-oldal.webp)

*A MainWP Control vezérlőpult-oldala: az első lépés az Application Password létrehozása* (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:

```bash
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:

```json
{
  "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.