Сравнение
MCP vs OpenAPI: что выбрать для агентов
OpenAPI описывает HTTP-эндпоинты, MCP даёт агенту инструменты в стандартном протоколе. Это разные слои — часто используются вместе.
Коротко
Не «или-или»: OpenAPI описывает ваш HTTP-API для разработчиков и клиентов, MCP даёт AI-агенту готовые инструменты в стандартном протоколе. MCP часто оборачивает существующий API.
Что такое каждое
- OpenAPI — спецификация REST API: endpoints, параметры, схемы ответов. Для HTTP-клиентов и генерации SDK. Публикуется/находится через api-catalog.
- MCP — протокол подключения агента к инструментам/данным: tools с JSON Schema, discovery через MCP Server Card.
Сравнение
| OpenAPI | MCP | |
|---|---|---|
| Описывает | HTTP-эндпоинты | Инструменты для агента |
| Аудитория | Разработчик, HTTP-клиент | MCP-клиент, AI-агент |
| Единица | Endpoint + параметры | Tool + JSON Schema |
| Discovery | /.well-known/api-catalog | MCP Server Card |
Главное различие
OpenAPI — это контракт API на уровне HTTP. MCP — это слой инструментов для агента, скрывающий детали транспорта. Агенту удобнее «вызвать tool», чем собирать HTTP-запрос по спецификации.
Делать оба
Часто — да: MCP-сервер оборачивает ваш OpenAPI-API. Публикуйте api-catalog для прямых интеграций и MCP Server Card — для агентов.
Как проверить
Скан проверяет наличие api-catalog и MCP Server Card — обе поверхности discovery в одном отчёте.