# MCP-поверхня, яка не запускається, якщо інструмент бреше про себе

Платформа | 2026 | TypeScript, Fastify, Model Context Protocol, SSE, OAuth 2.0, PostgreSQL, Drizzle, Zod

83 інструменти, п'ять живих ресурсів через server-sent events, OAuth з динамічною реєстрацією для сторонніх клієнтів і реєстр, що проходить валідацію під час запуску.

## Докази

- Каталог із 83 інструментів з анотаціями для кожного інструмента і валідацією реєстру під час запуску
- SSE-транспорт з реєстром підписок і шиною подій, що відстежує зміни; п'ять живих ресурсів
- OAuth для MCP-клієнтів: скоупи винесено в окремий пакет, динамічну реєстрацію клієнтів посилено перевіркою redirect URI та обмеженням частоти запитів, native-redirect шим для клієнтів із приватними схемами
- Лише MCP-сервіс: близько 400 змін файлів за час співпраці

## Проблема

Агентам продукту потрібна була стабільна поверхня інструментів і ресурсів, яку агент може сам виявити і яка спільна для чотирьох клієнтів (застосунок для батьків, застосунок для дитини, веб, адмінка), а сторонні MCP-клієнти мали безпечно автентифікуватися в ній. Каталог інструментів, який розходиться з власними описами, гірший за його відсутність: агент довіряє анотації, а не коду.

## Що я побудував

**Транспорт і ресурси.** SSE-транспорт з реєстром підписок і шина подій, що відстежує зміни в базі даних і перетворює їх на оновлення ресурсів. Поверх неї п'ять живих ресурсів, які охоплюють день родини, винагороди дитини, запити на екранний час і активність родини, тож агент бачить зміну стану без опитування.

**Каталог.** Кожен інструмент має анотації: що він читає, що змінює, чи він ідемпотентний, зрозумілу людині назву. Валідатор під час запуску перевіряє весь реєстр на відповідність схемі й реальним обробникам, і сервіс не стартує, якщо декларація бодай одного інструмента розходиться з тим, що він робить. Ця одна перевірка прибрала цілий клас інцидентів, коли агент викликав інструмент, вважаючи, що той лише читає дані.

**Автентифікація для зовнішніх клієнтів.** OAuth 2.0 для MCP-клієнтів з динамічною реєстрацією клієнтів, посиленою перевіркою дозволених redirect URI та обмеженням частоти запитів на фасаді, native-redirect шим для клієнтів зі схемами приватного використання і маршрут верифікації домену для платформи застосунків великого вендора. Скоупи переїхали в окремий пакет, тож застосунок для батьків, MCP-сервіс і адмінські інструменти узгоджені щодо них за самою побудовою.

## Принцип проєктування

MCP-сервер — це контракт із читачем, який не є людиною. Усе, що рев'юер-людина помітив би, прочитавши документацію, має забезпечувати сервер, бо агент документацію читати не буде. Валідація під час запуску, типізовані схеми від початку до кінця й анотації, які тестуються, а не просто пишуться.