Salt la conținutul principal
Română— Alege o limbă
Meniu

Arhitectură: Instrumente, Resurse și Interfață

Lecția 2 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Prezentare generală
  2. Ce expune un server MCP
  3. Fluxul cererii
  4. Transport și Autorizare
  5. Interfața: Un strat opțional
  6. Abilități (Skills): Stratul de flux de lucru
  7. Dar despre Comerț?
  8. Puncte cheie

Lecție rescrisă la 3 noiembrie 2026 pe baza paginilor Server MCP, Arhitectura plugin-urilor și Abilități (Skills) din documentația OpenAI Plugins. Arhitectura legacy „acțiuni, widget-uri, comerț“ descria un SDK care nu mai există. Surse: Server MCP · Arhitectura plugin-urilor · Abilități.

Prezentare generală

Un plugin este format din straturi independente. Abilitățile (Skills) oferă planul de acțiune, serverul MCP oferă capacitățile, iar interfața oferă un mod vizual de interacțiune atunci când este necesar.

Plugin
├── Abilități (Skills)
└── Server MCP (opțional)
    ├── Instrumente și rezultate structurate
    └── Resurse de interfață (opțional)

Fiecare strat are un rol distinct. Documentația rezumă această delimitare astfel: serverul MCP furnizează date, autentificare, autorizare și acțiuni; abilitatea oferă instrucțiuni reutilizabile, exemple și șabloane de documente.

Ce expune un server MCP

Un server MCP poate expune patru tipuri de entități:

  • Instrumente (Tools): Funcții pe care modelul le apelează cu intrări structurate.
  • Resurse: Date sau conținut pe care clientul le poate citi.
  • Prompt-uri: Șabloane de prompt-uri reutilizabile.
  • Instrucțiuni: Directive care se aplică întregului server.

Plugin-urile se bazează în principal pe instrumente. Fiecare instrument are un nume, o descriere, o schemă de intrare și, opțional, o schemă de ieșire. Aceste câmpuri permit modelului să decidă când să apeleze instrumentul și cum să utilizeze rezultatul acestuia.

Fluxul cererii

Când un utilizator face o cerere care corespunde unui instrument, au loc patru pași în secvență:

  1. Clientul descoperă instrumentele expuse de serverul MCP.
  2. Modelul selectează un instrument și furnizează argumente care respectă schema sa de intrare.
  3. Serverul validează cererea, execută operațiunea și returnează un rezultat.
  4. Modelul folosește acel rezultat pentru a continua conversația.

Un rezultat al unui instrument poate conține trei părți. structuredContent conține date concise pe care modelul le poate inspecta și reutiliza în apelurile ulterioare. content conține text sau alt conținut MCP care ajută modelul să formuleze un răspuns. _meta conține date destinate clientului și ascunse de model – ascunse, dar nu protejate. Acest câmp nu înlocuiește autorizarea sau stocarea securizată.

Transport și Autorizare

În producție, implementați un server MCP la o adresă HTTPS stabilă folosind transportul streamable HTTP al protocolului, de obicei pe o cale /mcp. Dacă instrumentele citesc date private sau acționează în numele unui utilizator, protejați serverul cu fluxul de autorizare definit de specificația MCP – OAuth, detaliat în Lecția 8.

Interfața: Un strat opțional

Un instrument trebuie să funcționeze fără o interfață: un text concis și un rezultat structurat sunt adesea suficiente pentru ca modelul să răspundă. O interfață are sens atunci când utilizatorul trebuie să inspecteze, compare, modifice, confirme sau navigheze prin informații structurate – o comparație de produse, un program editabil sau o hartă. O simplă verificare a statusului nu necesită, în general, una.

Atunci când este prezentă, interfața este o resursă pe care serverul o declară. ChatGPT o afișează într-un iframe când instrumentul asociat o returnează. ChatGPT implementează standardul deschis MCP Apps: interfața comunică cu gazda prin JSON-RPC folosind postMessage. Extensiile specifice ChatGPT, accesibile prin window.openai, completează standardul atunci când acesta nu acoperă o nevoie specifică. Lecția 6 abordează acest aspect.

Abilități (Skills): Stratul de flux de lucru

O abilitate este un folder care conține un fișier SKILL.md – un nume, o descriere care indică modelului când să o ia în considerare, instrucțiuni – și, dacă este necesar, referințe, scripturi sau șabloane. Modelul vede inițial doar numele și descrierea; încarcă instrucțiunile complete atunci când cererea corespunde abilității sau când utilizatorul o invocă direct. De aici și sfatul OpenAI: scrieți descrierea în jurul obiectivului utilizatorului și al condițiilor de declanșare, iar detaliile pas cu pas păstrați-le în corpul fișierului.

Dar despre Comerț?

Vânzarea printr-un plugin nu este un strat separat. Este o călătorie pe care interfața opțională o poate susține, valorificând API-ul Checkout documentat de OpenAI. Lecția 7 explică modul în care funcționează și limitările sale.

Puncte cheie

  • Un server MCP expune instrumente, resurse, prompt-uri și instrucțiuni; plugin-urile se bazează în principal pe instrumente
  • Un rezultat al unui instrument combină structuredContent, content și _meta (ascuns de model, dar nesecurizat)
  • Producție: HTTPS stabil, transport streamable HTTP, autorizare conform specificației MCP
  • Interfața este o resursă opțională afișată de ChatGPT conform standardului MCP Apps
  • Abilitățile gestionează fluxul de lucru; serverul gestionează datele, autorizarea și acțiunile