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

Arhitektura: Alati, resursi i sučelje

Lekcija 2 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Pregled
  2. Što MCP poslužitelj izlaže
  3. Tijek zahtjeva
  4. Prijenos i autorizacija
  5. Sučelje: Opcionalni sloj
  6. Vještine: Sloj radnog tijeka
  7. Što je s trgovinom?
  8. Ključne točke

Lekcija je ponovno napisana 3. studenog 2026. na temelju stranica MCP poslužitelj, Arhitektura dodataka i Vještine u dokumentaciji OpenAI dodataka. Naslijeđena arhitektura „akcije, widgeti, trgovina“ opisivala je SDK koji više ne postoji. Izvori: MCP poslužitelj · Arhitektura dodataka · Vještine.

Pregled

Dodatak se sastoji od neovisnih slojeva. Vještine pružaju plan igre, MCP poslužitelj osigurava mogućnosti, a sučelje nudi vizualni način interakcije kada je to potrebno.

Plugin
├── Skills
└── MCP Server (optional)
    ├── Tools and structured results
    └── Interface resources (optional)

Svaki sloj ima različitu ulogu. Dokumentacija sažima granicu na sljedeći način: MCP poslužitelj osigurava podatke, autentifikaciju, autorizaciju i radnje; vještina pruža ponovno upotrebljive upute, primjere i predloške dokumenata.

Što MCP poslužitelj izlaže

MCP poslužitelj može izložiti četiri vrste entiteta:

  • Alati (Tools): Funkcije koje model poziva sa strukturiranim ulazima.
  • Resursi (Resources): Podaci ili sadržaj koje klijent može čitati.
  • Upiti (Prompts): Ponovno upotrebljivi predlošci upita.
  • Upute (Instructions): Direktive koje se primjenjuju na cijeli poslužitelj.

Dodaci se prvenstveno oslanjaju na alate. Svaki alat ima naziv, opis, shemu ulaza i, opcionalno, shemu izlaza. Ta polja omogućuju modelu da odluči kada pozvati alat i kako iskoristiti njegov rezultat.

Tijek zahtjeva

Kada korisnik pošalje zahtjev koji odgovara alatu, događaju se četiri koraka uzastopno:

  1. Klijent otkriva alate koje izlaže MCP poslužitelj.
  2. Model odabire alat i dostavlja argumente koji su u skladu s njegovom shemom ulaza.
  3. Poslužitelj validira zahtjev, izvršava operaciju i vraća rezultat.
  4. Model koristi taj rezultat za nastavak razgovora.

Rezultat alata može sadržavati tri dijela. structuredContent nosi sažete podatke koje model može pregledati i ponovno upotrijebiti u narednim pozivima. content nosi tekst ili drugi MCP sadržaj koji pomaže modelu u formuliranju odgovora. _meta nosi podatke namijenjene klijentu i skrivene od modela – skrivene, ali ne i zaštićene. Ovo polje ne zamjenjuje autorizaciju niti sigurno pohranjivanje.

Prijenos i autorizacija

U produkcijskom okruženju rasporedite MCP poslužitelj na stabilnu HTTPS adresu koristeći streamable HTTP prijenos protokola, obično na putanji /mcp. Ako alati čitaju privatne podatke ili djeluju u ime korisnika, zaštitite poslužitelj tijekovima autorizacije definiranim MCP specifikacijom – OAuth, što detaljno obrađuje Lekcija 8.

Sučelje: Opcionalni sloj

Alat mora funkcionirati bez sučelja: sažeti tekst i strukturirani rezultat često su dovoljni da model odgovori. Sučelje ima smisla kada korisnik treba pregledati, usporediti, modificirati, potvrditi ili pregledavati strukturirane informacije – usporedbu proizvoda, raspored koji se može uređivati ili kartu. Jednostavna provjera statusa obično ne zahtijeva sučelje.

Kada postoji, sučelje je resurs koji poslužitelj deklarira. ChatGPT ga prikazuje u iframeu kada povezani alat vrati taj resurs. ChatGPT implementira otvoreni standard MCP Apps: sučelje komunicira s domaćinom putem JSON-RPC-a koristeći postMessage. Proširenja specifična za ChatGPT, dostupna putem window.openai, nadopunjuju standard kada on ne pokriva specifičnu potrebu. Lekcija 6 obrađuje ovo.

Vještine: Sloj radnog tijeka

Vještina je mapa koja sadrži datoteku SKILL.md – naziv, opis koji govori modelu kada je treba uzeti u obzir, upute – te, ako je potrebno, reference, skripte ili predloške. Model u početku vidi samo naziv i opis; učitava pune upute kada zahtjev odgovara vještini ili kada je korisnik izravno pozove. Stoga OpenAI savjetuje: napišite opis oko korisnikovog cilja i uvjeta okidanja, a detalje korak-po-korak zadržite u tijelu datoteke.

Što je s trgovinom?

Prodaja putem dodatka nije zaseban sloj. To je putovanje koje opcionalno sučelje može podržati, koristeći Checkout API koji dokumentira OpenAI. Lekcija 7 objašnjava kako to funkcionira i koja su njegova ograničenja.

Ključne točke

  • MCP poslužitelj izlaže alate, resurse, upite i upute; dodaci se prvenstveno oslanjaju na alate
  • Rezultat alata kombinira structuredContent, content i _meta (skriveno od modela, ali ne i sigurno)
  • Produkcija: stabilan HTTPS, streamable HTTP prijenos, autorizacija prema MCP specifikaciji
  • Sučelje je opcionalni resurs koji ChatGPT prikazuje prema standardu MCP Apps
  • Vještine upravljaju radnim tijekom; poslužitelj upravlja podacima, autorizacijom i radnjama