Агенты

MCP или API — в чём разница и что выбрать

Иллюстрация: одна розетка и три разных вилки, которые в неё подходят

Главная путаница вокруг MCP такая: люди думают, что это замена API. Мол, был REST — теперь будет MCP.

Нет. Если ты поднимешь MCP-сервер, под ним почти наверняка окажется твой же обычный HTTP-запрос. MCP ничего не отменяет — он добавляет сверху один слой, которого раньше не было.

И слой этот отвечает не на вопрос «как позвать», а на вопрос «как узнать, что можно позвать».

Коротко: это не конкуренты

API — это способ вызвать чужую функцию по сети. Ты знаешь адрес, метод, формат — и вызываешь.

MCP (Model Context Protocol) — это способ рассказать модели, какие функции у тебя вообще есть, чтобы она сама решила, какую вызвать. Общее описание — в статье что такое MCP.

Разница вот в чём. В обычном API описание живёт в документации — её читает человек и пишет код. В MCP описание отдаёт сама программа, машинно-читаемо: клиент делает вызов tools/list, и сервер возвращает список инструментов, где у каждого есть название, описание словами и JSON-схема аргументов.

По спецификации это выглядит так:

{
  "name": "get_weather",
  "title": "Weather Information Provider",
  "description": "Get current weather information for a location",
  "inputSchema": {
    "type": "object",
    "properties": {
      "location": { "type": "string", "description": "City name or zip code" }
    },
    "required": ["location"]
  }
}

Узнаёшь? Это же описание инструмента для модели — то самое, из tool use. Только раньше ты писал такие описания руками в своём коде, под каждую модель. Теперь их отдаёт сервер, а клиент забирает.

Пять критериев, по которым они разные

1. Кто читает описание. У API — человек: разработчик открывает доки и пишет интеграцию. У MCP — модель: она получает список инструментов в момент работы и выбирает сама.

2. Что именно стандартизировано. В REST у каждого сервиса свои пути, свои имена полей, своя авторизация — единого стандарта нет, есть привычки. В MCP жёстко зафиксирована процедура: как поздороваться, как спросить список инструментов, как вызвать, как вернуть ошибку.

3. Транспорт. API — обычно HTTP с методами GET/POST. MCP — это JSON-RPC 2.0 в одном из двух транспортов: stdio (сервер запускается как подпроцесс на твоей машине и общается через стандартный ввод-вывод) или Streamable HTTP для удалённых серверов. Отсюда, кстати, важное следствие: MCP-сервер может быть локальным — без сети и без публичного адреса. Обычным API так не сделаешь.

4. Кто пишет интеграцию. Тут главный выигрыш. Есть 5 ИИ-клиентов и 5 сервисов — при ручной интеграции это 25 связок, и каждую пишет кто-то руками. С MCP каждый сервис пишет один сервер, каждый клиент — один раз поддержку протокола. Было 25, стало 10.

5. Что происходит при изменении. Добавил метод в REST API — иди правь всех клиентов. Добавил инструмент в MCP-сервер — клиент увидит его при следующем tools/list, потому что список запрашивается, а не хардкодится.

Ещё одна деталь, которой в API нет вообще: у MCP три типа сущностей, не одна. Tools — то, что модель может выполнить. Resources — данные, которые можно прочитать. Prompts — заготовленные шаблоны запросов. То есть протокол описывает не только «кнопки», но и «что почитать».

Кому что подойдёт

Без увиливаний.

Пиши обычный API, если: у тебя мобильное приложение, веб-фронтенд, интеграция с чужим бэкендом или публичный продукт для разработчиков. Здесь MCP не нужен вообще — читателем остаётся человек, и REST делает это лучше.

Поднимай MCP-сервер, если: ты хочешь, чтобы твой сервис могли использовать любые ИИ-клиенты, а не тот один, под который ты написал интеграцию. Классический случай — внутренний инструмент компании: базы, вики, трекер. Один сервер — и он работает и в редакторе, и в терминальном агенте, и в чате.

Не трогай MCP, если: у тебя одна модель и один свой сервис. Тогда описание инструмента прямо в коде — это десять строк, а MCP-сервер — отдельный процесс, который надо запускать и обновлять. Протокол окупается на множестве клиентов, а не на одном.

И запомни главное: MCP-сервер — это чаще всего тонкая обёртка. Внутри он делает fetch к твоему же REST API. Ты не выбираешь «или-или» — ты решаешь, нужен ли тебе второй слой поверх первого. Похожая логика разобрана в сравнении API или вебхук.

Есть подвох?

Есть, и о нём стоит знать до того, как подключишь первый сторонний сервер. MCP-сервер получает ровно тот доступ, который ты ему дал — к файлам, к базе, к твоим токенам. А что именно агент с этим доступом сделает, решает модель, а не ты. Поэтому чужие серверы читают перед запуском, а свои держат на минимальных правах.

MCP заменит REST API?

Нет, и по устройству не может: сам MCP-сервер обычно вызывает REST под капотом. Он заменяет не API, а самописные интеграции «эта модель ↔ этот сервис». Их и правда станет заметно меньше.

Нужен ли MCP, если я делаю одного бота?

Нет. Одному боту хватит описания инструментов прямо в коде — это проще, быстрее и меньше движущихся частей. MCP берут, когда клиентов больше одного или когда хочется, чтобы инструмент подхватывался чужими приложениями без твоего участия.

Разобраться с агентами проще по порядку: сначала инструменты, потом протоколы. В KODiQ мы так и идём — на «ты», по шагам и с живыми примерами.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →