Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Pakiranje dodatka

Lekcija 10 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Zašto pakirati
  2. Struktura prijenosnog paketa
  3. Deklariranje MCP poslužitelja
  4. Metapodaci specifični za OpenAI
  5. Brzi put: @plugin-creator
  6. Lokalna tržišta
  7. Hookovi: samo za računala
  8. Ključne točke

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.json koji 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.json s vrstom transporta; tamo ide i autentifikacija
  • Prezentacija, mapiranja i vještina za uvođenje idu u extensions.com.openai
  • @plugin-creator generira strukturu; lokalno tržište služi za testiranje
  • Dodatak s hookovima nije prihvatljiv za javni direktorij