Közvetlen csatlakozás a Composer MCP-szerveréhez

A Composer WordPress Abilityket és egy dedikált MCP-szervert regisztrál. A különálló WordPress MCP Adapter biztosítja az MCP-átvitelt, amelyen keresztül a kompatibilis kliensek felderítik és meghívják ezeket az Abilityket.

Ez az Agent Composer áttekintésében bemutatott szabályozott tartalmi műveleti modell közvetlen átviteli módja. A kliens végzi a következtetést és a tartalom-előállítást; a Composer korlátozza a WordPress-műveletet, és emberi felülvizsgálatra ellenőrzött vázlatot hoz létre.

A Composer végpontja:

<wordpress-url>/wp-json/mcp/smartcloud-agent-composer

Előfeltételek

  • WordPress 6.9 vagy újabb és PHP 8.1 vagy újabb.
  • Telepített és aktív SmartCloud Agent Composer.
  • Legalább egy Blueprintet tartalmazó, ellenőrzött és aktív Config Set.
  • Telepített és aktív hivatalos WordPress MCP Adapter.
  • Külön WordPress-felhasználó smartcloud_agent szerepkörrel.
  • HTTPS minden távoli HTTP-kapcsolathoz.

A WordPress magja a 6.9-es verziótól tartalmazza az Abilities API-t. Az MCP Adapter aktuális kiadási utasításait kövesse, ne egy tetszőleges fejlesztési ágat töltsön le. Az elsődleges csomagtelepítési mód a composer require wordpress/mcp-adapter; a hivatalos tároló a hagyományos bővítménykiadási útvonalat is dokumentálja.

A végrehajtási identitás létrehozása

Hozzon létre egy külön WordPress-fiókot, például <agent-user> néven, és rendeld hozzá a smartcloud_agent szerepkört. Ne használjon újra rendszergazdai fiókot.

A szerepkör engedélyezi a Composer vázlatműveleteit és a szűken korlátozott, Composer által felügyelt távolikép-beolvasást. Nem adja meg a WordPress általános upload_files képességét, a közzétételt, normál tartalom törlését, bővítmények vagy témák kezelését, felhasználókezelést, illetve szűretlen HTML használatát. A hitelesítő adatokat tartsa a Config Set JSON-ján, a naplókon, képernyőképeken, utasításokon és forráskódkezelésen kívül.

A WordPress Application Passwords funkcióját támogató HTTP-kliensekhez hozzon létre alkalmazásjelszót ennek a külön fióknak, és tárolja a kliens titoktárában. Soha ne illessze be nyilvános MCP-konfigurációs példába.

A szerver ellenőrzése a kliens csatlakoztatása előtt

Rendszergazdaként nyissa meg a SmartCloud -> Agent Composer -> Overview oldalt, és ellenőrizze:

  • a várt aktív Config Setet;
  • a végpont útvonalát;
  • a kizárólag vázlatokon végzett műveletek készenlétét;
  • az aktuális téma és szolgáltatók készenlétét.

Ezután vizsgálja meg a szervert kompatibilis MCP-vizsgálóval vagy klienssel. A WordPress MCP Adapter tárolója a HTTP- és a helyi WP-CLI/stdio átvitelt is dokumentálja. Egy általános HTTP-kliens konfigurációja a következőket tartalmazza:

Server URL: <wordpress-url>/wp-json/mcp/smartcloud-agent-composer
Username: <agent-user>
Password/token: <stored-application-password>

A pontos hitelesítési mezők a klienstől függnek. Ne tegye névtelenül elérhetővé a végpontot, és ne helyezz hosszú élettartamú hitelesítő adatokat a parancselőzményekbe.

A szabályozott munkafolyamat elvárt menete

A kliensnek sorrendben a következő lépéseket kell végrehajtania:

  1. Töltse be az aktív tervezési környezetet és a kért page_type Blueprintjét.
  2. Töltse be a smartcloud-agent-composer/get-content-field-contract műveletet, ha a Blueprint regisztrált mezőket használ.
  3. Sorolja fel a jóváhagyott mintákat, és olvassa be a jóváhagyott referencia-tartalmat vagy meglévő médiát, ha a Blueprint Gutenberg-tartalmat használ.
  4. Mentés nélkül állítsa össze és ellenőrizze a javasolt dokumentumot vagy strukturált rekordot.
  5. Egyedi idempotenciakulccsal hozzon létre az ügynök tulajdonában lévő vázlatot.
  6. Minden kapcsolati mezőhöz hívja meg a smartcloud-agent-composer/search-relation-targets műveletet, és kizárólag a visszaadott matches[].id értékeket használja. Kapcsolatkereséshez ne használja a smartcloud-agent-composer/list-content-drafts műveletet.
  7. Ha a taxonómia-hozzáférés engedélyezett, töltse be a smartcloud-agent-composer/get-taxonomy-contract szerződést, keressen a search-taxonomy-terms művelettel, használja újra a pontos matches[].term_id találatot, és csak akkor hozzon létre kifejezést, ha nincs megfelelő, és a create-taxonomy-term műveletet kifejezetten megerősítették.
  8. Olvassa be a vázlat aktuális konkurenciavezérlési tokenjeit, írja a jóváhagyott mezőket a smartcloud-agent-composer/update-content-fields művelettel, a szabályzat által engedélyezett kifejezésazonosítókat pedig rendelje hozzá a smartcloud-agent-composer/assign-taxonomy-terms művelettel.
  9. Ellenőrizze a strukturált értékeket a smartcloud-agent-composer/inspect-content-fields, a kifejezések hozzárendelését pedig a smartcloud-agent-composer/inspect-taxonomy-terms művelettel.
  10. Töltse be az előnézetet, majd jelentse az ellenőrzési eredményeket és URL-eket emberi felülvizsgálatra.

Biztonságos első kérés:

Using page type <page-type>, load the active design context and blueprint, list
approved patterns, validate a minimal content plan, create an agent-owned draft,
and return its preview. Do not publish, delete normal content, upload media, or
change WordPress configuration.

Ellenőrizze a WordPressben, hogy az eredmény Vázlat, és egyetlen közzétett tartalom sem változott.

Vázlat frissítése

A Composer a frissítésekhez az aktuális modified_gmt értéket és revíziós tokent kéri. A kliensnek közvetlenül a módosítás előtt be kell olvasnia a vázlatot, majd változatlanul el kell küldenie ezeket az értékeket. Ha egy másik szerkesztő előbb mentette a vázlatot, a Composer ütközést jelez; töltse újra és vizsgálja át, ne próbálkozzon újra elavult tokenekkel.

Hibaelhárítás

  • Hiányzó végpont: ellenőrizze, hogy az MCP Adapter és a Composer aktív-e, majd az elavult PHP-folyamatok törlése után töltse újra a WordPresst.
  • Nincs jogosultság vagy tiltott hozzáférés: a külön felhasználóként hitelesíts, és ellenőrizze a smartcloud_agent szerepkört; ne rendszergazdai jogosultság megadásával oldja meg.
  • Nincs aktív konfiguráció: ellenőrizzen és kifejezetten aktiváljon egy Config Setet.
  • A Blueprint nem található: az aktív készletben konfigurált pontos, stabil page_type értéket használja.
  • Hiányzó minta vagy blokk: vizsgálja át újra a webhelyet, ellenőrizze a regisztrációt, és frissíts egy klónozott, munkaként használt Config Setet.
  • A szolgáltató nem áll készen: ellenőrizze a Theme & providers oldalt és a szolgáltatói bővítmény saját konfigurációját.
  • A cím szerinti keresés találatokat jelez, de nem ad vissza szerkeszthető elemeket: a smartcloud-agent-composer/list-content-drafts nem kapcsolatfeloldó. Olvassa be a tartalmimező-szerződést, majd hívja meg a smartcloud-agent-composer/search-relation-targets műveletet a megadott kapcsolati mezőhöz.
  • Egy taxonómiai eszköz hiányzik vagy elutasítja a taxonómiát: vizsgálja át újra a webhely képességeit, klónozza az aktív Config Setet, engedélyezze a regisztrált taxonómiát a Composer taxonomy access területén, ellenőrizze és aktiválja az utódkészletet, majd indítsa újra az MCP-t és frissítse a kliens katalógusát.
  • Ütközés: töltse újra a vázlatot, és használja az aktuális konkurenciavezérlési tokenjeit.
  • Érvénytelen előnézet: olvassa el az ellenőrzési jelentést; ne tegye közzé a tartalmat, és ne kerülje meg a sikertelen korlátozást.

A közvetlen MCP-útvonal a konfigurált kliens és a WordPress között továbbítja a kéréseket. Ehhez a munkafolyamathoz magának a Composernek nincs szüksége OpenAI-fiókra, Connector-alagútra vagy WP Suite-előfizetésre.