A bővítmény csomagolása
Ezen az oldalon
A leckét 2026. november 3-án írtuk át az OpenAI bővítményekkel foglalkozó dokumentációjának Package your plugin oldala alapján. Az előző lecke egy nem létező „ChatGPT Store“ számára készülő „csomag“ létrehozását írta le egy hiányzó manifest fájl segítségével. Egy bővítményt a
plugin.jsonmanifest fájllal csomagolunk, amely az Agent Plugins sémát követi. Forrás: Package your plugin.
Miért szükséges a csomagolás?
Miután megírtad a készségeket (skills), és szükség esetén felépítetted az MCP szervert, az utolsó lépés ezek egyetlen telepíthető egységbe történő összeállítása. A csomagolás stabil identitást ad a bővítményednek, és tájékoztatja a ChatGPT-t és a Codexet arról, mely készségek, MCP szerverkapcsolatok és erőforrások tartoznak össze. A felhasználói felület és a hitelesítési logika az MCP szerveren belül marad; a manifest csupán összeköti ezt az integrációt a csomag többi részével.
Egy hordozható csomag felépítése
Egy hordozható bővítmény gyökérkönyvtárában található egy plugin.json manifest fájl, amely deklarálja az Agent Plugins sémát. A mappa tartalmazhat még egy skills/ könyvtárat, egy mcp.json fájlt a bővítménnyel terjesztett MCP szerverek számára, valamint vizuális eszközöket az assets/ könyvtárban.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
A minimális manifest mindössze néhány sorból áll. A név, amely stabil és kebab-case formátumú, egyszerre szolgál azonosítóként és a komponensek névtereként; a készségeket a rendszer automatikusan fedezi fel a skills/ könyvtárban, nincs szükség explicit deklarálásukra.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes"
}
Minden készség a skills/<név>/SKILL.md útvonalon helyezkedik el, ahol egy fejléc tartalmazza a nevet és a leírást, ezt követik pedig az utasítások:
---
name: compte-rendu
description: Drafts meeting minutes from team notes.
---
Retrieve meeting notes using list_notes, group them by topic,
then draft a summary: decisions, action items with owners, and open points.
Az MCP szerver deklarálása
A bővítménnyel terjesztett MCP szervereket a gyökérkönyvtárban lévő mcp.json fájlban deklaráljuk, a megfelelő séma használatával, és minden szerverhez megadjuk a transzport típust:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
A szerver hitelesítését ebben ugyanabban a fájlban deklaráljuk, minden szerver esetében az extensions["com.openai"].auth alatt – ez a szerverhez tartozik, nem a manifesthez. Nyilvános beküldés esetén a távoli HTTPS végpontot adjuk meg; a helyi szerverek egy külön útvonalat követnek, amely az asztali bővítmények számára van fenntartva.
OpenAI-specifikus metaadatok
A könyvtár megjelenítését, a már regisztrált MCP szerverekhez való hozzárendeléseket és a hookokat a gyökér plugin.json fájl extensions.com.openai objektumában deklaráljuk, míg a hordozható identitás (name, version, description) a gyökérszinten marad:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes",
"extensions": {
"com.openai": {
"interface": {
"displayName": "Team Notes",
"shortDescription": "Notes and meeting minutes",
"developerName": "Your Team",
"category": "Productivity",
"capabilities": ["Read", "Write"],
"websiteURL": "https://example.com",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": ["Use Team Notes to draft Monday's meeting minutes."],
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
}
}
}
}
Az ebben az objektumban található elérési utak a bővítmény gyökeréhez viszonyítottak, és ./ jellel kezdődnek. A vizuális eszközöket (composerIcon, logo, screenshots) célszerű a ./assets/ könyvtárba helyezni. Az apps mezőt kizárólag arra használjuk, hogy egy .app.json fájlra mutasson, amely a ChatGPT-ben már regisztrált MCP szerverekhez való hozzárendeléseket tartalmazza.
Deklarálhatsz egy bevezető készséget (onboarding skill) is az extensions.com.openai.onboardingSkill segítségével (például: ./skills/setup/SKILL.md): ez a telepítés után segíti a felhasználót egy munkaterület kiválasztásában vagy a preferenciák beállításában. Teszteld ezt egy új beszélgetésben és egy folyamatban lévő telepítés során is.
Egy régebbi formátum, amelyben a manifest a .codex-plugin/plugin.json helyen található, még mindig elfogadott kompatibilitási okokból: csak akkor használjuk, ha az extensions.com.openai objektum hiányzik, mivel a kettő nem egyesül. Az új csomagoknál a gyökér plugin.json fájlt kell használni.
A gyors út: @plugin-creator
A ChatGPT és a Codex tartalmaz egy @plugin-creator nevű készséget, amely generálja neked a struktúrát – jelenleg még a kompatibilitási .codex-plugin/ formátumban. Ahhoz, hogy egy MCP szervert csatlakoztass hozzá, először csatlakoztasd azt a szervert a ChatGPT-hez (Add custom MCP server, majd Create as a plugin), jegyezd fel a technikai kapcsolati azonosítót a böngésző URL-címéből – ez plugin_asdk_app karakterlánccal kezdődik –, és add meg ezt a @plugin-creator számára Work módban (vagy a $plugin-creator számára a Codexben). A készség képes létrehozni egy személyes piactéri bejegyzést is, lehetővé téve, hogy a bővítményt a helyi könyvtár forrásából telepítsd és teszteld.
Helyi piacterek
A piactér egy JSON formátumú katalógus a bővítményekről. Írásra, tesztelésre és csapatokon belüli terjesztésre szolgál a nyilvános könyvtár mellett: Work módban vagy a Codexben minden piactér választható forrásként jelenik meg a bővítménykönyvtárban. Így tesztelheted a teljes bővítményt, mielőtt beküldenéd azt (9. lecke).
Hookok: csak asztali verzióhoz
Az életciklus-hookok kizárólag a Codex asztali alkalmazásába manuálisan telepített bővítmények esetén támogatottak, és egy ilyen hookokat tartalmazó bővítmény nem jogosult a nyilvános könyvtárba való felvételre. Ha a bővítményed célja a közzététel, hagyd ki ezeket.
Főbb megállapítások
- Egy hordozható csomag:
plugin.json(Agent Plugins séma),skills/,mcp.json,assets/ - Az MCP szervert a
mcp.jsonfájlban deklaráljuk a transzport típusával; a hitelesítés is ide kerül - A megjelenítés, a hozzárendelések és a bevezető készség az
extensions.com.openairészben találhatók - A
@plugin-creatorgenerálja a struktúrát; a helyi piactér tesztelésre szolgál - A hookokat tartalmazó bővítmény nem jogosult a nyilvános könyvtárba