A Composer használata Secure MCP Tunnelen és ChatGPT-n keresztül
A ChatGPT távoli MCP-szerverekhez kapcsolódik. Ha a Composer végpontjának privátnak kell maradnia, az OpenAI Secure MCP Tunnel csak kimenő kapcsolatot használó útvonalat biztosít anélkül, hogy bejövő tűzfalportokat kellene megnyitni vagy közzétenni a privát szerver URL-jét.
Az alagút opcionális. A Composer és a WordPress MCP Adapter a közvetlenül csatlakozó kompatibilis MCP-klienseket is támogatja.
Az Agent Composer áttekintése bemutatja a teljes, ügynökségtől a vázlaton át az éles kiadásig tartó munkafolyamatot. Az alagút csak azt módosítja, hogyan éri el egy hitelesített kliens a Composert; nem változtatja meg, ki tervezi a webhelyet, mit enged az aktív szerződés, illetve hogyan történik a vázlat felülvizsgálata és kiadása.
A privát WordPress privát maradhat
Helyi vagy tűzfallal védett WordPress-környezetnél az alagút kimenő kapcsolatot létesít a támogatott ügynökintegrációval. Kizárólag az ügynök kedvéért nem kell bejövő WordPress- vagy MCP-végpontot megnyitni.
Az átvitel biztonsága és a műveletek engedélyezése továbbra is elkülönül. A sikeres alagútkapcsolat nem ad korlátlan WordPress-hozzáférést: a Composer a külső felhasználó Cognito access tokenjét, csoportját, OAuth-kliensének jogosultsági plafonját, az aktív Config Setet, a Blueprint szabályait, a vázlat tulajdonjogát, az ellenőrzést és az auditvezérlőket is érvényesíti a WordPressben.
Architektúra és bizalmi határok
ChatGPT or another supported OpenAI product
|
OpenAI-hosted tunnel endpoint
|
outbound HTTPS polling
|
tunnel-client inside your network
|
private Composer MCP endpoint
|
Composer Cognito authentication + contract authorization
A tunnel-client hitelesíti magát az OpenAI alagútvezérlési síkján, és továbbítja a HTTP MCP-forgalmat a hosztolt alagútvégpont és a privát WordPress-szerver között. A Composer ettől függetlenül hitelesíti a külső felhasználót a továbbított bearer tokenből, majd érvényesíti a csoport-, kliens-, scope-, contract-, tulajdonosi, validációs és humán jóváhagyási szabályokat.
Előfeltételek
Először végezze el a közvetlen MCP beállítását, és ellenőrizze a Composer-szervert a privát hálózaton belülről.
Ezekre is szükséged lesz:
- az OpenAI Platform alagútbeállításainál létrehozott alagútra;
- Tunnels Read + Manage jogosultságra a létrehozásához vagy szerkesztéséhez;
- Tunnels Read + Use jogosultságra a futtatásához vagy kiválasztásához;
- kizárólag az alagútgazdagépen tárolt futásidejű API-kulcsra;
- kimenő HTTPS-hozzáférésre az
api.openai.com:443címhez; - a ChatGPT fejlesztői módjához való hozzáférésre az aktuális csomag és munkaterületi szabályzat szerint.
A Platform alagútjogosultságai és a ChatGPT munkaterületi jogosultságai különállók. Társítsa az alagutat minden olyan Platform-szervezethez és ChatGPT-munkaterülethez, amelynek engedélyezni szeretné a felderítését.
A tunnel-client telepítése és konfigurálása
Töltse le az aktuális tunnel-client programot a Platform alagútbeállításaiból vagy a hivatalos OpenAI kiadási tárolóból. Egy konkrét bináris verzió üzemeltetési dokumentumba rögzítése helyett kövesse a legújabb kiadás hivatkozását.
A Composer védett OAuth-eléréséhez HTTP tunnel-profil szükséges. A cél lehet nyilvános URL, privát hostnév vagy kizárólag a tunnel hostról elérhető cím; nem kell a nyilvános internetről elérhetőnek lennie. A Composer külön HTTP MCP-végpontjára kell mutatnia.
export CONTROL_PLANE_API_KEY="<runtime-api-key>"
tunnel-client init \
--sample sample_mcp_with_dcr \
--profile <connector-profile> \
--tunnel-id <tunnel-id> \
--mcp-server-url "https://<wordpress-host>/wp-json/mcp/smartcloud-agent-composer"
tunnel-client doctor --profile <connector-profile> --explain
tunnel-client run --profile <connector-profile>
A sample_mcp_with_dcr mintát csak akkor használja, ha a Composer feloldott
identity providerrel rendelkezik, és OAuth protected-resource metadata-t
hirdet. Ha a végpont szándékosan Open módban marad identity provider nélkül,
használja helyette a sample_mcp_remote_no_auth mintát. Az Open végpont 404-et
ad az OAuth metadata-jelöltekre, így a hitelesítés nélküli HTTP-profil ready
állapotba kerülhet. A védett OAuth későbbi bekapcsolásakor generálja újra a
profilt a sample_mcp_with_dcr mintával.
A folyamatot csak akkor futtassa felügyelt szolgáltatásként, ha a doctor egészséges és kész állapotot jelez. A tunnel helyi admin felületén ellenőrizze, hogy a fő csatorna transport_kind: http-streamable állapotú, és az OAuth-metadata felderíthető. Az STDIO mcp.command profil nem képes továbbítani a HTTP WWW-Authenticate challenge-et és a külső felhasználó bearer tokenjét; csak helyi fejlesztéshez vagy a Composer visszafelé kompatibilis Open módjához használja.
Mielőtt eszközöket keres a ChatGPT-ben, vizsgálja meg a futó alagútfolyamatot vagy annak helyi /ui felületét, és ellenőrizze, hogy a smartcloud-agent-composer szervert célozza. A sikeres állapotellenőrzés azt igazolja, hogy a démon fut, de nem bizonyítja, hogy a profil a kívánt WordPress MCP-szervert választotta. A felderített eszközöknek a smartcloud-agent-composer-* előtagot kell használniuk, és Blueprint-, tervezésikörnyezet-, ellenőrzési, vázlat- és előnézeti műveleteket kell tartalmazniuk. Strukturálttartalom-munkafolyamatoknál azt is ellenőrizze, hogy a katalógus tartalmazza a szabványos
smartcloud-agent-composer/get-content-field-contract,
smartcloud-agent-composer/search-relation-targets,
smartcloud-agent-composer/update-content-fields és
smartcloud-agent-composer/inspect-content-fields Abilityket.
A smartcloud-agent-composer/list-content-drafts is jelen lehet, de szerkeszthető vagy átvehető tartalom felderítésére szolgál, nem kapcsolati célpontok feloldására.
Taxonómiát használó munkafolyamatnál ellenőrizze a szabványos
smartcloud-agent-composer/get-taxonomy-contract,
smartcloud-agent-composer/search-taxonomy-terms,
smartcloud-agent-composer/create-taxonomy-term,
smartcloud-agent-composer/assign-taxonomy-terms és
smartcloud-agent-composer/inspect-taxonomy-terms eszközöket is. A létrehozás nem pótléka a bizonytalan egyezésnek: a kliensnek először keresnie kell, és csak indokolt új nyilvános navigációs kifejezéshez kérhet kifejezett megerősítést.
Egyéni ChatGPT MCP-alkalmazás/bővítmény létrehozása
Az OpenAI felülete és a csomagok elérhetősége változhat; kövesse az aktuális fejlesztői mód útmutatóját és a bővítménycsatlakoztatási útmutatót.
A jelenlegi folyamat:
- Engedélyezze a Developer mode-ot a ChatGPT munkaterületi szabályzata által engedélyezett helyen.
- Nyissa meg a ChatGPT Plugins/Apps oldalát, és hozzon létre egy fejlesztői módú alkalmazást.
- Adjon meg egyértelmű nevet és leírást, például Agent Composer és Governed WordPress Gutenberg draft creation and preview.
- Kapcsolattípusként válassza a Tunnel lehetőséget.
- Válassza ki a társított alagutat, vagy adja meg a
<tunnel-id>értékét. - Vizsgálja át az eszközöket, és kérés esetén fejezd be a hitelesítést.
- Az alkalmazás létrehozása előtt tekints át minden felderített eszközt és annak írási/módosítási jelölését.
Az egyéni MCP írási támogatása és a fejlesztői mód elérhetősége a ChatGPT-csomagtól és a munkaterületi szabályzattól függ. A kapcsolatot csak akkor nevezd OpenAI által ellenőrzött integrációnak, ha átesett a vonatkozó OpenAI-felülvizsgálaton.
Biztonságos tesztelés
Indítson új beszélgetést, csak a Composer alkalmazást engedélyezze, és használjon szűkre szabott utasítást:
Load the active Composer design context, then the blueprint for <page-type> and
approved patterns, validate a minimal plan, create one agent-owned
WordPress draft, and return its preview. Do not publish, delete normal content,
upload media, or change plugins, themes, users, or configuration.
Ellenőrizze, hogy:
- a ChatGPT a várt sorrendben választja ki a Blueprint-, tervezésikörnyezet-, minta-, ellenőrzési, vázlat- és előnézeti eszközöket;
- a WordPress közzétett elem helyett vázlatot tartalmaz;
- az előnézet ellenőrzési jelentése hibamentes;
- a Composer auditnaplója rögzíti a hitelesített szereplőt és az eredményt;
- a nem támogatott közzétételi vagy törlési kérések nem eredményeznek végrehajtható Composer-eszközt.
Hibaelhárítás
- Az alagút nem jelenik meg a ChatGPT-ben: ellenőrizze a munkaterület társítását és a Tunnels Read + Use jogosultságot.
- A ChatGPT szerint a szerver nem valósít meg OAuthot: ellenőrizze a helyi tunnel UI
/api/statusés/api/oauthadatait. Az STDIO profilt vagymetadata_source: not_advertisederedményt cserélje a/wp-json/mcp/smartcloud-agent-composervégpontra mutató HTTP/DCR profilra, majd indítsa újra a webhelyspecifikus tunnel szolgáltatást. - Az eszközvizsgálat meghiúsul: hagyja aktívan futni a
tunnel-client runfolyamatot, ellenőrizze a helyi/uifelületet, és futtassa adoctor --explainparancsot. - Az átvitel működik, de a WordPress elutasítja a hívásokat: ellenőrizze a Composerben a Cognito issuert, az App Client allowlistet, a csoportnév pontos egyezését és a token scope-jait; ne kerülje meg a Site Contractot, és ne adjon rendszergazdai hozzáférést.
- Régi, hiányzó vagy oda nem tartozó eszközök jelennek meg: először ellenőrizze, hogy az alagútprofil a
--server=smartcloud-agent-composerparaméterrel indul-e. Composer-frissítés után indítsa újra a megfelelő PHP-futásidőt, a webhelyspecifikus MCP/alagút szolgáltatást és a felügyelt alagútfolyamatot. Frissítse az alkalmazás műveleteit, vizsgálja át az eszközdefiníciók eltérését, erősítse meg a várt szabványos Abilityket, és indítson új beszélgetést. Ha az aktuális ChatGPT-csomag nem engedi a közzétett alkalmazás frissítését, hozza létre és tegye közzé újra. - A hívások időtúllépnek: ellenőrizze az OpenAI vezérlési síkjához való kimenő hozzáférést, valamint az alagútgazdagép és a
<mcp-endpoint>közötti helyi elérhetőséget. - A Composer ellenőrzése meghiúsul: szerződés- vagy aktívtéma-eltérésként kezelje, ne alagúthibaként.
Csak megbízható MCP-szervereket csatlakoztasson. A promptinjektálás és a túl széles eszközjogosultságok akkor is alkalmazásszintű kockázatok maradnak, ha a hálózati útvonal privát.
