Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Architektúra: Nástroje, zdroje a rozhranie

Lekcia 2 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Prehľad
  2. Čo MCP server vystavuje
  3. Tok požiadavky
  4. Transport a autorizácia
  5. Rozhranie: Voliteľná vrstva
  6. Skills: Vrstva pracovného postupu
  7. Čo s obchodom?
  8. Kľúčové poznatky

Lekcia prepísaná 3. novembra 2026 na základe stránok MCP server, Plugin architecture a Skills v dokumentácii OpenAI Plugins. Legacy architektúra „actions, widgets, commerce“ opisovala SDK, ktoré už neexistuje. Zdroje: MCP server · Plugin architecture · Skills.

Prehľad

Plugin sa skladá z nezávislých vrstiev. Skills (zručnosti) poskytujú postup, MCP server poskytuje možnosti a rozhranie ponúka vizuálny spôsob interakcie, keď je to potrebné.

Plugin
├── Skills
└── MCP Server (voliteľné)
    ├── Nástroje a štruktúrované výsledky
    └── Zdroje rozhrania (voliteľné)

Každá vrstva má odlišnú úlohu. Dokumentácia vymedzuje hranice takto: MCP server poskytuje dáta, autentifikáciu, autorizáciu a akcie; skill poskytuje opätovne použiteľné inštrukcie, príklady a šablóny dokumentov.

Čo MCP server vystavuje

MCP server môže vystavovať štyri typy entít:

  • Nástroje (Tools): Funkcie, ktoré model volá so štruktúrovanými vstupmi.
  • Zdroje (Resources): Dáta alebo obsah, ktorý si klient môže prečítať.
  • Výzvy (Prompts): Opätovne použiteľné šablóny výziev.
  • Inštrukcie: Smernice platné pre celý server.

Pluginy sa primárne spoliehajú na nástroje. Každý nástroj má názov, popis, schému vstupu a voliteľne aj schému výstupu. Tieto polia umožňujú modelu rozhodnúť sa, kedy nástroj zavolať a ako využiť jeho výsledok.

Tok požiadavky

Keď používateľ odošle požiadavku, ktorá zodpovedá nástroju, nastanú postupne štyri kroky:

  1. Klient objaví nástroje vystavené serverom MCP.
  2. Model vyberie nástroj a poskytne argumenty, ktoré zodpovedajú jeho vstupnej schéme.
  3. Server overí požiadavku, vykoná operáciu a vráti výsledok.
  4. Model využije tento výsledok na pokračovanie konverzácie.

Výsledok nástroja môže obsahovať tri časti. structuredContent nesie stručné dáta, ktoré si model môže prezrieť a znovu použiť v následných volaniach. content nesie text alebo iný obsah MCP, ktorý pomáha modelu formulovať odpoveď. _meta nesie dáta určené pre klienta a skryté pred modelom – skryté, no nie chránené. Toto pole nenahrádza autorizáciu ani bezpečné ukladanie.

Transport a autorizácia

V produkčnom prostredí nasadzujte server MCP na stabilnú adresu HTTPS pomocou transportného protokolu streamable HTTP, zvyčajne na ceste /mcp. Ak nástroje čítajú súkromné dáta alebo konajú v mene používateľa, chráňte server autorizačným tokom definovaným špecifikáciou MCP – OAuth, ktoré podrobne rozoberá Lekcia 8.

Rozhranie: Voliteľná vrstva

Nástroj musí fungovať aj bez rozhrania: stručný text a štruktúrovaný výsledok často stačia na to, aby model odpovedal. Rozhranie dáva zmysel vtedy, keď používateľ potrebuje preskúmať, porovnať, upraviť, potvrdiť alebo prehliadať štruktúrované informácie – napríklad porovnanie produktov, upraviteľný harmonogram alebo mapu. Jednoduchá kontrola stavu ho zvyčajne nepotrebuje.

Ak je prítomné, rozhranie je zdroj, ktorý server deklaruje. ChatGPT ho zobrazí v iframe, keď ho pridružený nástroj vráti. ChatGPT implementuje otvorený štandard MCP Apps: rozhranie komunikuje s hostiteľom prostredníctvom JSON-RPC pomocou postMessage. Rozšírenia špecifické pre ChatGPT, dostupné cez window.openai, dopĺňajú štandard tam, kde nepokrýva konkrétne potreby. Toto pokrýva Lekcia 6.

Skills: Vrstva pracovného postupu

Skill je priečinok obsahujúci súbor SKILL.md – názov, popis, ktorý modelu hovorí, kedy ho má zohľadniť, inštrukcie – a v prípade potreby odkazy, skripty alebo šablóny. Model pôvodne vidí len názov a popis; úplné inštrukcie načíta až vtedy, keď požiadavka zodpovedá skillu, alebo keď ho používateľ priamo vyvolá. Preto OpenAI odporúča: píšte popis okolo cieľa používateľa a spúšťacích podmienok a podrobnosti krok za krokom nechajte v tele dokumentu.

Čo s obchodom?

Predaj cez plugin nie je samostatnou vrstvou. Je to cesta, ktorú môže podporovať voliteľné rozhranie s využitím Checkout API dokumentovaného spoločnosťou OpenAI. Lekcia 7 vysvetľuje, ako to funguje a aké sú jeho obmedzenia.

Kľúčové poznatky

  • Server MCP vystavuje nástroje, zdroje, výzvy a inštrukcie; pluginy sa primárne spoliehajú na nástroje
  • Výsledok nástroja kombinuje structuredContent, content a _meta (skryté pred modelom, no nie bezpečné)
  • Produkcia: stabilné HTTPS, transport streamable HTTP, autorizácia podľa špecifikácie MCP
  • Rozhranie je voliteľný zdroj, ktorý ChatGPT zobrazuje podľa štandardu MCP Apps
  • Skills riešia pracovný postup; server rieši dáta, autorizáciu a akcie