Pakiranje vtičnika
Na tej strani
Lekcija je bila ponovno napisana 3. novembra 2026 na podlagi strani Package your plugin v dokumentaciji za vtičnike OpenAI. Prejšnja lekcija je opisovala gradnjo „paketa” za neobstoječo „trgovino ChatGPT” z uporabo manjkajočega manifesta. Vtičnik se pakira z manifestom
plugin.json, ki sledi shemi Agent Plugins. Vir: Package your plugin.
Zakaj pakirati
Ko si napisal svoje veščine in po potrebi zgradil strežnik MCP, je zadnji korak združevanje v namestljivo enoto. Pakiranje daje tvojemu vtičniku stabilno identiteto in sporoča ChatGPT ter Codexu, katere veščine, povezave s strežniki MCP in viri spadajo skupaj. Logika uporabniškega vmesnika in avtentikacije ostaja znotraj strežnika MCP; manifest zgolj poveže to integracijo z ostalim delom paketa.
Struktura prenosnega paketa
Prenosni vtičnik ima v korenski mapi manifest plugin.json, ki razglaša shemo Agent Plugins. Mapa lahko vsebuje tudi imenik skills/, datoteko mcp.json za strežnike MCP, ki so distribuirani z vtičnikom, in vizualna sredstva v mapi assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Najmanjši manifest zajame le nekaj vrstic. Ime, ki je stabilno in zapisano v kebab-case, služi kot identifikator in imenski prostor za komponente; veščine se samodejno odkrijejo v mapi skills/, zato jih ni treba izrecno navajati.
{
"$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"
}
Vsaka veščina se nahaja v skills/<ime>/SKILL.md, z glavo, ki navaja njeno ime in opis, sledijo pa navodila:
---
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.
Razglasitev strežnika MCP
Strežniki MCP, ki so distribuirani z vtičnikom, so razglašeni v datoteki mcp.json v korenu, z uporabo ustrezne sheme in določitvijo vrste prenosa za vsak strežnik:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Avtentikacija strežnika je razglašena v tej isti datoteki pod extensions["com.openai"].auth za vsak strežnik – spada k strežniku, ne k manifestu. Za javno predložitev oddaljiš končno točko HTTPS; lokalni strežniki sledijo ločeni poti, rezervirani za namizne vtičnike.
Metapodatki, specifični za OpenAI
Predstavitev imenika, preslikave na že registrirane strežnike MCP in kljuke (hooks) so razglašene v objektu extensions.com.openai korenske datoteke plugin.json, medtem ko prenosna identiteta (name, version, description) ostane v korenu:
{
"$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"
}
}
}
}
Poti v tem objektu so relativne glede na koren vtičnika in se začnejo z ./. Vizualna sredstva (composerIcon, logo, screenshots) naj bodo po možnosti v mapi ./assets/. Polje apps se uporablja samo za指向 na datoteko .app.json, ki vsebuje preslikave na strežnike MCP, že registrirane v ChatGPT.
Prav tako lahko razglasiš veščino za uvajanje (onboarding skill) prek extensions.com.openai.onboardingSkill (na primer ./skills/setup/SKILL.md): ta vodi uporabnika po namestitvi pri izbiri delovnega prostora ali nastavitvi preferenc. Preizkusi jo v novem pogovoru in med namestitvijo, ki je že v teku.
Starejša oblika z manifestom v .codex-plugin/plugin.json je še vedno sprejeta zaradi združljivosti: uporabi se le, če objekt extensions.com.openai ni prisoten, saj se oba ne združujeta. Novi paketi naj uporabljajo korenski plugin.json.
Hitra pot: @plugin-creator
ChatGPT in Codex vključujeta veščino @plugin-creator, ki za tebe ustvari strukturo – trenutno v združljivi obliki .codex-plugin/. Če želiš nanjo pripeti strežnik MCP, najprej poveži ta strežnik v ChatGPT (Add custom MCP server, nato Create as a plugin), zabeleži tehnični ID povezave iz URL-ja brskalnika – začne se z plugin_asdk_app – in ga posreduj veščini @plugin-creator v načinu Work (ali $plugin-creator v Codexu). Veščina lahko ustvari tudi vnos v osebno tržnico, kar ti omogoča namestitev in testiranje vtičnika neposredno iz tvoje lokalne mape.
Lokalne tržnice
Tržnica je katalog vtičnikov v formatu JSON. Služi za pisanje, testiranje in distribucijo znotraj ekipe ob javnem imeniku: v načinu Work ali v Codexu se vsaka tržnica prikaže kot izbirni vir v imeniku vtičnikov. Tako boš pred predložitvijo testiral celoten vtičnik (lekcija 9).
Kljuke (Hooks): samo za namizne aplikacije
Kljuke življenjskega cikla so podprte le za vtičnike, ročno nameščene v namizni aplikaciji Codex, in vtičnik, ki jih vsebuje, ni upravičen do javnega imenika. Če ciljaš na objavo vtičnika, jih izpusti.
Ključne ugotovitve
- Prenosni paket:
plugin.json(shema Agent Plugins),skills/,mcp.json,assets/ - Strežnik MCP je razglašen v
mcp.jsonz njegovo vrsto prenosa; tam spada tudi avtentikacija - Predstavitev, preslikave in veščina za uvajanje gredo v
extensions.com.openai @plugin-creatorustvari strukturo; lokalna tržnica služi za testiranje- Vtičnik s kljukami ni upravičen do javnega imenika