Architektúra: Nástroje, zdroje a rozhranie
Na tejto strane
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:
- Klient objaví nástroje vystavené serverom MCP.
- Model vyberie nástroj a poskytne argumenty, ktoré zodpovedajú jeho vstupnej schéme.
- Server overí požiadavku, vykoná operáciu a vráti výsledok.
- 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,contenta_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