Pakiranje dodatka
Na ovoj stranici
Lekcija je prepisana 3. studenog 2026. na temelju stranice Package your plugin iz dokumentacije o OpenAI dodacima. Prethodna lekcija opisivala je izradu „paketa“ za nepostojeću „ChatGPT Trgovinu“ koristeći nedostajući manifest. Dodatak se pakira s manifestom
plugin.jsonkoji slijedi shemu Agent Plugins. Izvor: Package your plugin.
Zašto pakirati
Nakon što si napisao svoje vještine i, ako je potrebno, izgradio MCP poslužitelj, posljednji korak je njihovo sastavljanje u instalacijsku cjelinu. Pakiranje tvom dodatku daje stabilan identitet i govori ChatGPT-u i Codexu koje vještine, veze s MCP poslužiteljima i resursi pripadaju zajedno. Logika korisničkog sučelja i autentifikacije ostaje unutar MCP poslužitelja; manifest jednostavno povezuje tu integraciju s ostatkom paketa.
Struktura prijenosnog paketa
Prijenosni dodatak ima manifest plugin.json u svom korijenu, koji deklarira shemu Agent Plugins. Mapa može sadržavati i direktorij skills/, datoteku mcp.json za MCP poslužitelje distribuirane s dodatkom te vizualne resurse u mapi assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Minimalni manifest stane u samo nekoliko redaka. Ime, stabilno i u kebab-case formatu, služi i kao identifikator i kao imenski prostor za komponente; vještine se automatski otkrivaju u mapi skills/ bez potrebe za eksplicitnim deklariranjem.
{
"$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"
}
Svaka vještina nalazi se u skills/<ime>/SKILL.md, s zaglavljem koje sadrži njezino ime i opis, nakon čega slijede upute:
---
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.
Deklariranje MCP poslužitelja
MCP poslužitelji distribuirani s dodatkom deklariraju se u mcp.json u korijenu, koristeći odgovarajuću shemu i specificirajući vrstu transporta za svaki poslužitelj:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Autentifikacija poslužitelja deklarira se u istoj datoteci, pod extensions["com.openai"].auth za svaki poslužitelj – ona pripada poslužitelju, a ne manifestu. Za javnu predaju šalješ udaljenu HTTPS adresu; lokalni poslužitelji slijede zaseban put rezerviran za dodatke za računala.
Metapodaci specifični za OpenAI
Prezentacija direktorija, mapiranja na već registrirane MCP poslužitelje i hookovi deklariraju se u objektu extensions.com.openai korijenskog plugin.json, dok prijenosni identitet (name, version, description) ostaje u korijenu:
{
"$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"
}
}
}
}
Putanje u ovom objektu su relativne u odnosu na korijen dodatka i počinju s ./. Vizualni resursi (composerIcon, logo, screenshots) trebali bi po mogućnosti ići u ./assets/. Polje apps koristi se samo za ukazivanje na .app.json datoteku koja sadrži mapiranja na MCP poslužitelje već registrirane u ChatGPT-u.
Također možeš deklarirati vještinu za uvođenje putem extensions.com.openai.onboardingSkill (na primjer, ./skills/setup/SKILL.md): ona vodi korisnika nakon instalacije kako bi odabrao radni prostor ili postavio preferencije. Testiraj je u novom razgovoru i tijekom instalacije u tijeku.
Stariji format, s manifestom u .codex-plugin/plugin.json, i dalje je prihvaćen radi kompatibilnosti: koristi se samo ako objekt extensions.com.openai nije prisutan, jer se ta dva ne spajaju. Novi paketi trebali bi koristiti korijenski plugin.json.
Brzi put: @plugin-creator
ChatGPT i Codex uključuju vještinu, @plugin-creator, koja generira strukturu za tebe – trenutno u kompatibilnom formatu .codex-plugin/. Da bi joj pridružio MCP poslužitelj, prvo poveži taj poslužitelj u ChatGPT-u (Add custom MCP server, zatim Create as a plugin), zabilježi tehnički ID veze iz URL-a preglednika – počinje s plugin_asdk_app – i proslijedi ga alatu @plugin-creator u Work načinu rada (ili $plugin-creator u Codexu). Vještina može stvoriti i unos za osobno tržište, što ti omogućuje instalaciju i testiranje dodatka iz izvornog lokalnog direktorija.
Lokalna tržišta
Tržište je JSON katalog dodataka. Služi za pisanje, testiranje i distribuciju unutar tima uz javni direktorij: u Work načinu rada ili u Codexu, svako se tržište pojavljuje kao odabirni izvor u direktoriju dodataka. Tako ćeš testirati cijeli dodatak prije podnošenja (Lekcija 9).
Hookovi: samo za računala
Hookovi životnog ciklusa podržani su samo za dodatke ručno instalirane u aplikaciji Codex za računala, a dodatak koji ih sadrži nije prihvatljiv za javni direktorij. Ako tvoj dodatak cilja na objavu, izostavi ih.
Ključne točke
- Prijenosni paket:
plugin.json(shema Agent Plugins),skills/,mcp.json,assets/ - MCP poslužitelj deklarira se u
mcp.jsons vrstom transporta; tamo ide i autentifikacija - Prezentacija, mapiranja i vještina za uvođenje idu u
extensions.com.openai @plugin-creatorgenerira strukturu; lokalno tržište služi za testiranje- Dodatak s hookovima nije prihvatljiv za javni direktorij