
Contract First API для системного аналитика: OpenAPI, AsyncAPI и MCP
transcript
show notes
Сначала согласовать контракт API, а потом писать код — в этом суть подхода Contract First. Звучит понятно, пока в команде не возникают вопросы: кто разрабатывает контракт — аналитик или разработчик? Что должно быть в OpenAPI-спецификации, а что остаётся в требованиях и документации? И зачем системному аналитику разбираться в Git?
В этом выпуске разбираем Contract First с точки зрения работы системного аналитика.
Ссылка на статью к эпизоду: https://getanalyst.ru/podcast/contract-first-mcp-api
Telegram-канал сообщества: https://t.me/getanalysts
VK сообщество: https://vk.com/getanalyst
А ещё разбираемся в связи Contract First с ИИ-агентами и MCP (Model Context Protocol): почему контракты становятся особенно важны, когда с системой взаимодействует ИИ, как аналитики участвуют в проектировании MCP-серверов и что нужно подготовить команде, чтобы её API можно было использовать через MCP.
Выпуск актуален для системных и бизнес-аналитиков, которые работают с требованиями к API и интеграциям и хотят разобраться, как меняются эти задачи с появлением ИИ-агентов.
Тайм-коды к эпизоду:
00:00 | Заставка GetAnalyst
00:18 | Почему Contract First API актуален в эпоху ИИ-агентов
01:21 | Что такое Contract First и зачем системному аналитику Git
05:00 | Что такое OpenAPI (Swagger) и AsyncAPI
05:43 | Артефакты Contract First: что появляется в процессе разработки
10:47 | Что фиксировать в спецификации OpenAPI и нужно ли описывать алгоритмы
13:30 | Кто разрабатывает и согласует API-контракт: роли аналитика и разработчика
18:49 | Типичные ошибки аналитиков при работе с Contract First
22:40 | Что такое MCP (Model Context Protocol) и ИИ-агенты: связь с Contract First
27:44 | Требования к MCP-серверу: что описывает системный аналитик
31:28 | Как подготовить API для использования через MCP-сервер
32:46 | Итоги и рекомендации по работе с Contract First и переходу к MCP
Ведущая:
Екатерина Ананьева,
Основатель сообщества Системных Аналитиков GetAnalyst
Гости:
Софья Калинина,
Старший cистемный аналитик, РТК ИТ.





