Balíček zásuvného modulu
Na této stránce
Lekce přepsána 3. listopadu 2026 na základě stránky Package your plugin v dokumentaci zásuvných modulů OpenAI. Předchozí lekce popisovala vytváření „balíčku“ pro neexistující „Obchod ChatGPT“ pomocí chybějícího manifestu. Zásuvný modul se balí s manifestem
plugin.jsonpodle schématu Agent Plugins. Zdroj: Package your plugin.
Proč balit
Jakmile jsi napsal své dovednosti a v případě potřeby sestavil server MCP, posledním krokem je jejich sestavení do instalovatelné jednotky. Zabalení dává tvému zásuvnému modulu stabilní identitu a sděluje ChatGPT a Codexu, které dovednosti, připojení k serverům MCP a zdroje k sobě patří. Logika uživatelského rozhraní a ověřování zůstává uvnitř serveru MCP; manifest pouze propojuje tuto integraci se zbytkem balíčku.
Struktura přenosného balíčku
Přenosný zásuvný modul má ve svém kořeni manifest plugin.json, který deklaruje schéma Agent Plugins. Složka může také obsahovat adresář skills/, soubor mcp.json pro servery MCP distribuované se zásuvným modulem a vizuální aktiva v assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Minimální manifest se vejde do několika řádků. Název, stabilní a ve formátu kebab-case, slouží jako identifikátor i jako jmenný prostor pro komponenty; dovednosti jsou v skills/ objeveny automaticky bez nutnosti explicitního declaration.
{
"$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"
}
Každá dovednost žije v skills/<název>/SKILL.md, s hlavičkou poskytující její název a popis, následovanou instrukcemi:
---
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.
Deklarace serveru MCP
Servery MCP distribuované se zásuvným modulem jsou deklarovány v mcp.json v kořeni, pomocí odpovídajícího schématu a specifikací typu transportu pro každý server:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Ověřování serveru je deklarováno v tomto stejném souboru pod extensions["com.openai"].auth pro každý server – patří k serveru, nikoli k manifestu. Pro veřejné odeslání předkládáš vzdálený koncový bod HTTPS; lokální servery následují samostatnou cestu vyhrazenou pro desktopové zásuvné moduly.
Metadata specifická pro OpenAI
Prezentace adresáře, mapování na již registrované servery MCP a hooky jsou deklarovány v objektu extensions.com.openai kořenového plugin.json, zatímco přenosná identita (name, version, description) zůstává v kořeni:
{
"$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"
}
}
}
}
Cesty v tomto objektu jsou relativní ke kořeni zásuvného modulu a začínají ./. Vizuální aktiva (composerIcon, logo, screenshots) by měla přednostně směřovat do ./assets/. Pole apps se používá pouze k odkazu na soubor .app.json obsahující mapování na servery MCP již registrované v ChatGPT.
Můžeš také deklarovat uvítací dovednost (onboarding skill) prostřednictvím extensions.com.openai.onboardingSkill (například ./skills/setup/SKILL.md): ta uživatele po instalaci provede výběrem pracovního prostoru nebo nastavením preferencí. Otestuj ji v nové konverzaci a během probíhající instalace.
Starší formát s manifestem v .codex-plugin/plugin.json je stále přijímán pro kompatibilitu: používá se pouze tehdy, pokud objekt extensions.com.openai chybí, protože se tyto dva formáty neslučují. Nové balíčky by měly používat kořenový plugin.json.
Rychlá cesta: @plugin-creator
ChatGPT a Codex zahrnují dovednost @plugin-creator, která za tebe vygeneruje strukturu – aktuálně ve formátu kompatibility .codex-plugin/. Abys k ní připojil server MCP, nejprve tento server připoj v ChatGPT (Add custom MCP server, poté Create as a plugin), zaznamenej si technické ID připojení z URL adresy prohlížeče – začíná plugin_asdk_app – a poskytni jej @plugin-creator v režimu Work (nebo $plugin-creator v Codexu). Tato dovednost může také vytvořit záznam v osobním tržišti, což ti umožní nainstalovat a otestovat zásuvný modul ze zdrojového adresáře na tvém lokálním počítači.
Lokální tržiště
Tržiště je katalog zásuvných modulů ve formátu JSON. Slouží k psaní, testování a distribuci v týmu vedle veřejného adresáře: v režimu Work nebo v Codexu se každé tržiště zobrazuje jako volitelný zdroj v adresáři zásuvných modulů. Takto otestuješ kompletní zásuvný modul před jeho odesláním (lekce 9).
Hooky: pouze pro desktop
Hooky životního cyklu jsou podporovány pouze pro zásuvné moduly ručně nainstalované v desktopové aplikaci Codex a zásuvný modul, který je obsahuje, není způsobilý pro veřejný adresář. Pokud cílíš na publikaci svého zásuvného modulu, vynech je.
Klíčové poznatky
- Přenosný balíček:
plugin.json(schéma Agent Plugins),skills/,mcp.json,assets/ - Server MCP je deklarován v
mcp.jsonse svým typem transportu; ověřování patří také tam - Prezentace, mapování a uvítací dovednost jdou do
extensions.com.openai @plugin-creatorgeneruje strukturu; lokální tržiště slouží k testování- Zásuvný modul s hooky není způsobilý pro veřejný adresář