Лекції

У цій лекції розберемося, що таке MCP ( Model Context Protocol), навіщо цей протокол потрібен у технологічному стеку ChatGPT Apps і чим він відрізняється від «власного REST». Зіставимо архітектурну схему (ChatGPT → MCP‑клієнт → ваш MCP-сервер → БД/API), розглянемо ключові сутності протоколу ( tools, resources, prompts і capabilities), а також зрозуміємо, як MCP уже «захований» усередині Apps SDK через виклики на кшталт callTool — і як навчитися не сприймати його як «чорний ящик».

У цій лекції розберемо «сирий» формат MCP‑повідомлень поверх JSON‑RPC 2.0. Зʼясуємо, чим відрізняються request, reply і notification; як зіставляти повідомлення за id; коли сервер має повертати result, а коли — error. Також подивимося, як у протоколі виглядають примітиви tools/ resources/ prompts (методи tools/list, tools/call, resources/read, prompts/get). Наприкінці повʼяжемо це з Apps SDK на прикладі window.openai.callTool і потренуємося читати та налагоджувати MCP‑JSON.

Розбираємо «знайомство» клієнта й MCP‑сервера через запит initialize: як узгоджується protocolVersion, які capabilities оголошують клієнт і сервер, чому важливо дочекатися notifications/initialized і як після handshake працює discovery через tools/list, resources/list і prompts/list. Наприкінці — практичні приклади на GiftGen і добірка типових помилок.

У цій лекції ми зберемо перший робочий MCP‑сервер на Node.js/TypeScript. Розгорнемо HTTP‑ендпойнт /mcp, створимо сервер McpServer із пакета @modelcontextprotocol/sdk, підʼєднаємо транспорт (наприклад, StreamableHttpServerTransport) і зареєструємо три базові сутності MCP: tool (інструмент suggest_gifts із Zod-схемою inputSchema), resource (каталог gift_catalog із коректним mimeType) і prompt (шаблон birthday_gift). Також розберемося з середовищем виконання, локальним запуском і типовими помилками.

У цій лекції розглянемо практичне налагодження MCP‑серверів за допомогою інспекторів: як MCP Jam/Inspector повторюють handshake (метод initialize) і читають capabilities, як вручну викликати tools/list і tools/call та переглядати сирий JSON‑RPC, а також як вибудувати логування на сервері (структурні JSON‑логи, розділення stdout/ stderr, маскування PII) так, щоб проблеми виявлялися ще до інтеграції із застосунками ChatGPT / Apps SDK.