Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Arhitektura: orodja, viri in vmesnik

Lekcija 2 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Pregled
  2. Kaj strežnik MCP razkriva
  3. Potek zahteve
  4. Prenos in avtorizacija
  5. Vmesnik: opcijska plast
  6. Spretnosti: plast delovnega toka
  7. Kaj pa trgovina?
  8. Ključne ugotovitve

Lekcija je bila na novo napisana 3. novembra 2026 na podlagi strani MCP server, Plugin architecture in Skills v dokumentaciji OpenAI Plugins. Starejša arhitektura „actions, widgets, commerce” je opisovala SDK, ki ne obstaja več. Viri: MCP server · Plugin architecture · Skills.

Pregled

Vtičnik je sestavljen iz neodvisnih plasti. Spretnosti (Skills) zagotavljajo navodila za izvedbo, strežnik MCP ponuja zmogljivosti, vmesnik pa omogoča vizualno interakcijo, kadar je to potrebno.

Plugin
├── Skills
└── MCP Server (opcijsko)
    ├── Orodja in strukturirani rezultati
    └── Viri za vmesnik (opcijsko)

Vsaka plast ima svojo vlogo. Dokumentacija mejo med njimi povzema takole: strežnik MCP zagotavlja podatke, avtentikacijo, avtorizacijo in dejanja; spretnost pa ponuja ponovno uporabna navodila, primere in predloge dokumentov.

Kaj strežnik MCP razkriva

Strežnik MCP lahko razkriva štiri vrste entitet:

  • Orodja (Tools): Funkcije, ki jih model kliče s strukturiranimi vnosi.
  • Viri (Resources): Podatki ali vsebina, ki jih odjemalec lahko bere.
  • Pozivi (Prompts): Ponovno uporabne predloge pozivov.
  • Navodila (Instructions): Direktive, ki veljajo za celoten strežnik.

Vtičniki se primarno zanašajo na orodja. Vsako orodje ima ime, opis, shemo vnosa in po potrebi shemo izhoda. Ta polja modelu omogočajo, da se odloči, kdaj orodje poklicati in kako uporabiti njegov rezultat.

Potek zahteve

Ko uporabnik poda zahtevo, ki ustreza orodju, se zaporedoma zgodijo štirje koraki:

  1. Odjemalec odkrije orodja, ki jih razkriva strežnik MCP.
  2. Model izbere orodje in zagotovi argumente, ki ustrezajo njegovi shemi vnosa.
  3. Strežnik preveri zahtevo, izvede operacijo in vrne rezultat.
  4. Model uporabi ta rezultat za nadaljevanje pogovora.

Rezultat orodja lahko vsebuje tri dele. structuredContent nosi jedrnate podatke, ki jih model lahko pregleda in ponovno uporabi v naslednjih klicih. content nosi besedilo ali drugo vsebino MCP, ki modelu pomaga oblikovati odgovor. _meta nosi podatke, namenjene odjemalcu in skrite pred modelom – skrite, a ne zaščitene. To polje ne nadomešča avtorizacije ali varnega shranjevanja.

Prenos in avtorizacija

V produkcijskem okolju strežnik MCP namestite na stabilen naslov HTTPS z uporabo prenosa streamable HTTP tega protokola, običajno na poti /mcp. Če orodja berejo zasebne podatke ali delujejo v imenu uporabnika, zaščitite strežnik s postopkom avtorizacije, ki ga določa specifikacija MCP – OAuth, kar podrobneje obravnava 8. lekcija.

Vmesnik: opcijska plast

Orodje mora delovati brez vmesnika: jedrnato besedilo in strukturiran rezultat sta pogosto dovolj, da model odgovori. Vmesnik ima smisel, ko mora uporabnik pregledati, primerjati, spremeniti, potrditi ali brskati po strukturiranih informacijah – na primer pri primerjavi izdelkov, uredljivem urniku ali zemljevidu. Preprost preverjanje stanja ga običajno ne potrebuje.

Kadar je prisoten, je vmesnik vir, ki ga strežnik razglasi. ChatGPT ga prikaže v elementu iframe, ko ga vrne povezano orodje. ChatGPT izvaja odprti standard MCP Apps: vmesnik komunicira z gostiteljem prek JSON-RPC z uporabo postMessage. Razširitve, specifične za ChatGPT, dostopne prek window.openai, dopolnjujejo standard, kadar ta ne pokriva določene potrebe. To obravnava 6. lekcija.

Spretnosti: plast delovnega toka

Spretnost je mapa, ki vsebuje datoteko SKILL.md – ime, opis, ki modelu pove, kdaj naj jo upošteva, navodila – in po potrebi reference, skripte ali predloge. Model sprva vidi le ime in opis; polna navodila naloži, ko zahteva ustreza spretnosti ali ko jo uporabnik neposredno sproži. Zato OpenAI svetuje: opis napišite glede na uporabnikov cilj in pogoje sprožitve, podrobnosti korak za korakom pa pustite v telesu datoteke.

Kaj pa trgovina?

Prodaja prek vtičnika ni ločena plast. Gre za potovanje, ki ga lahko podpre opcijski vmesnik z izkoriščanjem Checkout API, ki ga dokumentira OpenAI. Kako to deluje in kakšne so omejitve, pojasnjuje 7. lekcija.

Ključne ugotovitve

  • Strežnik MCP razkriva orodja, vire, pozive in navodila; vtičniki se primarno zanašajo na orodja
  • Rezultat orodja združuje structuredContent, content in _meta (skrito pred modelom, a ne varno)
  • Produkcija: stabilen HTTPS, prenos streamable HTTP, avtorizacija po specifikaciji MCP
  • Vmesnik je opcijski vir, ki ga ChatGPT prikaže po standardu MCP Apps
  • Spretnosti upravljajo delovni tok; strežnik upravlja podatke, avtorizacijo in dejanja