Od SDK-a za aplikacije do dodataka za ChatGPT
Na ovoj stranici
Tečaj je ponovno napisan 3. studenog 2026. na temelju OpenAI-jeve dokumentacije o dodacima (Plugins). Prethodna verzija oslanjala se na nepostojeći paket
@openai/apps-sdk(koji je sadržavaodefineAction,defineWidgeti manifestchatgpt-app.json). Sada ChatGPT aplikacije gradiš koristeći MCP protokol, njegove službene SDK-ove i standard sučelja MCP Apps. Prepisali smo svih četrnaest lekcija te uklonili nepodržane popise kompatibilnosti modela, strukture provizija i korake objavljivanja iz stare verzije. Izvori: Brzi početak · Arhitektura dodataka.
Što je dodatak?
Dodatak je paket koji otkrivaš, instaliraš, dijeliš i objavljuješ unutar ChatGPT-a i Codexa. On proširuje mogućnosti asistenta pružanjem novog znanja, alata ili oboje. OpenAI-jeva dokumentacija identificira četiri gradivna bloka:
- Vještine (Skills), koje modelu daju upute i resurse za rukovanje ponavljajućim tijekovima rada;
- MCP poslužitelj, koji izlaže alate i povezuje asistenta s vanjskim sustavima—tvojim API-jem, bazom podataka ili uslugom;
- Oboje, kada modelu trebaju i playbook i mogućnosti koje pruža tvoja infrastruktura;
- Kuke životnog ciklusa (Lifecycle hooks), naredbe koje se izvršavaju u određenim trenucima u izvršnom okruženju Codexa, uključujući unutar ChatGPT Worka.
ChatGPT i Codex dijele isti direktorij dodataka: javni dodatak objavljuje se jednom i postaje vidljiv na svim kompatibilnim površinama u oba proizvoda. Neke mogućnosti ostaju specifične za površinu—na primjer, skripta kuke mora postojati u izvršnom okruženju, pa instalacija dodatka na webu automatski ne znači njegovo raspoređivanje tamo.
A što je s „Apps SDK-om“?
Ovaj se izraz odnosi na OpenAI-jev alatni komplet za izgradnju aplikacija unutar ChatGPT-a: MCP protokol i njegove službene SDK-ove, otvoreni standard MCP Apps koji ChatGPT implementira za renderiranje sučelja, proširenja specifična za ChatGPT, dizajn sustav (@openai/apps-sdk-ui) i repozitorij primjera. Dokumentacija sada grupira ove elemente pod nazivom „ChatGPT dodaci i Apps SDK“: aplikacija se vrti oko MCP poslužitelja, uključuje neobavezno sučelje i distribuira se kao dio dodatka.
Izbor MCP-a je namjeran. Model Context Protocol otvorena je specifikacija za povezivanje AI klijenata s alatima i podacima. Poslužitelj koji napišeš za ChatGPT govori protokolom koji razumiju i drugi domaćini, a sučelje usklađeno s MCP Apps radi u bilo kojem domaćinu koji podržava taj standard.
Četiri moguća oblika
Započni s najmanjim oblikom koji pokriva tvoje slučajeve upotrebe; poslužitelj ili sučelje možeš dodati kasnije bez mijenjanja temeljne svrhe dodatka.
| Oblik | Odaberi ovo kada |
|---|---|
| Samo vještine | Postojeće upute i alati dovoljni su za rukovanje tijekovima rada |
| Samo MCP poslužitelj | Dodatku trebaju MCP alati, ali ne i dodatne upute za tijekove rada |
| Vještine i MCP poslužitelj | Vještine moraju voditi model kroz tijekove rada koji koriste tvoje alate |
| MCP poslužitelj sa sučeljem | Vizualna interakcija značajno poboljšava dio tijeka rada |
Dodatak koji izrađuje zapisnike sa sastanaka prema pravilima tvoje tvrtke možda treba samo vještine. Čim mora čitati podatke u stvarnom vremenu, autentificirati korisnika ili djelovati unutar sustava kojim upravljaš, zahtijeva MCP poslužitelj. Konačno, sučelje nikada nije obavezno: alat mora ostati koristan i bez njega.
Gdje se dodatak izvršava
U ChatGPT-u instalirani dodatak pozivaš izravno upisivanjem @ u polje za unos i njegovim odabirom. Model ga također može automatski pozvati kada zahtjev odgovara njegovim alatima ili vještinama. OpenAI-jev vodič za brzi početak preporučuje testiranje tvog prvog dodatka u ChatGPT Worku, kartici Work na web početnoj stranici ChatGPT-a. Isti se dodaci pojavljuju u Codexu, ograničeni specifičnim mogućnostima svake površine.
Što ćeš izgraditi
Ovaj tečaj slijedi putanju zacrtanu u dokumentaciji. Počet ćeš definiranjem svojih alata na temelju korisničkih potreba, povezati prvi MCP poslužitelj s ChatGPT-om, a zatim izgraditi vlastiti: dobro dokumentirane alate, sučelje MCP Apps tamo gdje donosi vrijednost, OAuth autentifikaciju za privatne podatke i, ako odgovara tvom poslovnom modelu, tijek kupnje koristeći Checkout API. Završit ćeš s pakiranjem, pravilima objavljivanja i slanjem u direktorij.
Ključne točke
- Dodatak kombinira vještine, MCP poslužitelj ili oboje; sučelje je neobavezno
- ChatGPT i Codex dijele isti direktorij dodataka
- „Apps SDK“ odnosi se na OpenAI-jeve alate za izgradnju aplikacija: MCP, standard MCP Apps, proširenja za ChatGPT i dizajn sustav
- Ne postoji paket
@openai/apps-sdk: započni sa službenim MCP SDK-ovima - Odaberi najmanji oblik dodatka koji pokriva tvoje slučajeve upotrebe