Архитектура: Инструменти, ресурси и интерфейс
На тази страница
Урокът е пренаписан на 3 ноември 2026 г. въз основа на страниците за MCP сървър, Архитектура на плъгините и Умения (Skills) в документацията на OpenAI за плъгини. Описаната в миналото архитектура „действия, уиджети, търговия“ се отнасяше за SDK, което вече не съществува. Източници: MCP server · Plugin architecture · Skills.
Преглед
Един плъгин се състои от независими слоеве. Уменията (Skills) осигуряват плана за действие, MCP сървърът предоставя възможностите, а интерфейсът предлага визуален начин за взаимодействие, когато е необходимо.
Plugin
├── Skills
└── MCP Server (optional)
├── Tools and structured results
└── Interface resources (optional)
Всеки слой има различна роля. Документацията обобщава границата по следния начин: MCP сървърът предоставя данни, удостоверяване, оторизация и действия; умението предоставя многократни инструкции, примери и шаблони за документи.
Какво излага един MCP сървър
Един MCP сървър може да изложи четири типа обекти:
- Инструменти (Tools): Функции, които моделът извиква със структурирани входни данни.
- Ресурси: Данни или съдържание, които клиентът може да прочете.
- Подкани (Prompts): Многократни шаблони за подкани.
- Инструкции: Директиви, които се прилагат за целия сървър.
Плъгините разчитат предимно на инструменти. Всеки инструмент има име, описание, схема за входни данни и по желание – схема за изходни данни. Тези полета позволяват на модела да реши кога да извика инструмента и как да използва резултата от него.
Потокът на заявката
Когато потребителят направи заявка, която съвпада с даден инструмент, се изпълняват последователно четири стъпки:
- Клиентът открива инструментите, изложени от MCP сървъра.
- Моделът избира инструмент и предоставя аргументи, които отговарят на неговата схема за входни данни.
- Сървърът валидира заявката, изпълнява операцията и връща резултат.
- Моделът използва този резултат, за да продължи разговора.
Резултатът от инструмента може да съдържа три части. structuredContent носи сбити данни, които моделът може да инспектира и използва повторно в следващи извиквания. content носи текст или друго MCP съдържание, което помага на модела да формулира отговор. _meta носи данни, предназначени за клиента и скрити от модела – скрити, но не защитени. Това поле не замества оторизацията или сигурното съхранение.
Транспорт и оторизация
В производствена среда разполагайте MCP сървър на стабилен HTTPS адрес, използвайки транспорта streamable HTTP на протокола, обикновено на път /mcp. Ако инструментите четат частни данни или действат от името на потребител, защитете сървъра с потока за оторизация, дефиниран от спецификацията на MCP – OAuth, който е подробно описан в Урок 8.
Интерфейсът: Опционален слой
Един инструмент трябва да работи без интерфейс: сбитият текст и структурираният резултат често са достатъчни, за да може моделът да отговори. Интерфейсът има смисъл, когато потребителят трябва да инспектира, сравнява, модифицира, потвърждава или разглежда структурирана информация – сравнение на продукти, редактируем график или карта. Обикновена проверка на статуса geralmente не се нуждае от такъв.
Когато присъства, интерфейсът е ресурс, който сървърът декларира. ChatGPT го показва в iframe, когато свързаният инструмент го върне. ChatGPT прилага открития стандарт MCP Apps: интерфейсът комуникира с хоста чрез JSON-RPC, използвайки postMessage. Разширенията, специфични за ChatGPT, достъпни чрез window.openai, допълват стандарта, когато той не покрива конкретна нужда. Урок 6 разглежда това.
Умения: Слой на работния поток
Умението е папка, съдържаща файл SKILL.md – име, описание, което казва на модела кога да го вземе предвид, инструкции – и при необходимост – препратки, скриптове или шаблони. Моделът първоначално вижда само името и описанието; той зарежда пълните инструкции, когато заявката съвпада с умението или когато потребителят го извика директно. Затова съветът на OpenAI е: напишете описанието около целта на потребителя и условията за задействане, а подробностите стъпка по стъпка оставете в тялото на файла.
А какво да кажем за търговията?
Продажбата чрез плъгин не е отделен слой. Това е пътешествие, което опционалният интерфейс може да подкрепи, използвайки Checkout API, документиран от OpenAI. Урок 7 обяснява как работи това и какви са ограниченията му.
Ключови изводи
- MCP сървърът излага инструменти, ресурси, подкани и инструкции; плъгините разчитат предимно на инструменти
- Резултатът от инструмента комбинира
structuredContent,contentи_meta(скрито от модела, но не сигурно) - Производство: стабилен HTTPS, транспорт streamable HTTP, оторизация според спецификацията на MCP
- Интерфейсът е опционален ресурс, показван от ChatGPT според стандарта MCP Apps
- Уменията управляват работния поток; сървърът управлява данните, оторизацията и действията