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_agentszerepkö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:
- Töltse be az aktív tervezési környezetet és a kért
page_typeBlueprintjét. - Töltse be a
smartcloud-agent-composer/get-content-field-contractműveletet, ha a Blueprint regisztrált mezőket használ. - 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.
- Mentés nélkül állítsa össze és ellenőrizze a javasolt dokumentumot vagy strukturált rekordot.
- Egyedi idempotenciakulccsal hozzon létre az ügynök tulajdonában lévő vázlatot.
- Minden kapcsolati mezőhöz hívja meg a
smartcloud-agent-composer/search-relation-targetsműveletet, és kizárólag a visszaadottmatches[].idértékeket használja. Kapcsolatkereséshez ne használja asmartcloud-agent-composer/list-content-draftsműveletet. - Ha a taxonómia-hozzáférés engedélyezett, töltse be a
smartcloud-agent-composer/get-taxonomy-contractszerződést, keressen asearch-taxonomy-termsművelettel, használja újra a pontosmatches[].term_idtalálatot, és csak akkor hozzon létre kifejezést, ha nincs megfelelő, és acreate-taxonomy-termműveletet kifejezetten megerősítették. - Olvassa be a vázlat aktuális konkurenciavezérlési tokenjeit, írja a jóváhagyott mezőket a
smartcloud-agent-composer/update-content-fieldsművelettel, a szabályzat által engedélyezett kifejezésazonosítókat pedig rendelje hozzá asmartcloud-agent-composer/assign-taxonomy-termsművelettel. - Ellenőrizze a strukturált értékeket a
smartcloud-agent-composer/inspect-content-fields, a kifejezések hozzárendelését pedig asmartcloud-agent-composer/inspect-taxonomy-termsművelettel. - 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_agentszerepkö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-draftsnem kapcsolatfeloldó. Olvassa be a tartalmimező-szerződést, majd hívja meg asmartcloud-agent-composer/search-relation-targetsmű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.
