Перейти к содержимому
← Вернуться в блог

MCP и API: различия, примеры и выбор

Сравните MCP и API на одном запросе аккаунта без изменений: обнаружение инструментов, ключи, выполнение и ошибки.

OOMOL

Прямой API подходит, когда код должен явно выбирать операцию и параметры. MCP даёт ИИ-клиенту общий интерфейс обнаружения и вызова инструментов. Сервер MCP может обращаться к API внутри, поэтому эти подходы совместимы.

Что меняется

В API/SDK код выбирает операцию и обрабатывает ответ. В MCP клиент обнаруживает инструменты сервера и вызывает их по протоколу. Разрешения исходного сервиса всё ещё необходимы. См. официальную архитектуру.

Одна задача для обоих путей

Прочитайте пользователя GitHub, подключённого к OOMOL. Сначала подключите нужный аккаунт.

Вызов из backend

Установите @oomol-lab/connector, создайте личный API-ключ и сохраните его как серверный секрет OOMOL_API_KEY. Выполняйте только в доверенной серверной среде:

import { Connector } from "@oomol-lab/connector";

const connector = new Connector({
  apiKey: process.env.OOMOL_API_KEY!,
  team: "<team-name>",
});
const result = await connector.execute("github.get_current_user", {});
console.log(result);

Замените <team-name> на имя команды OOMOL с подключением GitHub и выберите ту же команду в настройке MCP ниже.

Сверьте возвращённую личность с аккаунтом. Выбор из нескольких подключений описан в руководстве Connector. Личные, проектные и MCP-ключи нельзя подменять друг другом.

Вызов через MCP

Откройте настройку MCP, выберите личную или командную область и добавьте конфигурацию в совместимый клиент.

Через OOMOL MCP прочитай подключённого пользователя GitHub. Если подключений несколько, предложи выбрать. Верни реальные поля личности и ничего не изменяй.

Проверьте тот же аккаунт. OOMOL предоставляет инструменты обнаружения и выполнения; каждая операция GitHub не обязательно отображается отдельно. Детали — в руководстве MCP.

Проследите одну операцию

Пример SDK обращается к API OOMOL, а не напрямую к GitHub. Прямая интеграция требует самостоятельно обрабатывать ключи GitHub и ответы.

ЭтапOOMOL SDKКлиент MCP
ОбнаружениеПроверить connector.catalog.action("github.get_current_user").Найти инструменты и схемы, затем операцию через инструменты OOMOL.
ВводПередать ID и {}; аккаунт выбрать отдельно.Передать аргументы по схеме инструмента, включая аккаунт при необходимости.
АвторизацияЛичный ключ, команда и подключение GitHub.MCP-ключ, команда и то же подключение. OAuth не заменяет ключ OOMOL.
ВыполнениеДождаться connector.execute(...).Вызвать инструмент; хост управляет подтверждениями и порядком действий.
Результатexecute возвращает данные; executeRaw добавляет метаданные.Проверить ответ инструмента до резюме модели.

MCP унифицирует обнаружение и вызовы, но не требует выбора каждой операции моделью. Прямой API тоже можно представить как инструмент модели. Оба пути требуют поддержки совместимости и учёта изменений исходного API.

Различайте ошибки

Ошибка входа, неверная команда, отсутствие подключения и корректный пустой ответ — разные ситуации. Записывайте ошибки без секретов. В более крупных задачах выравнивайте фильтры, страницы и поля.

В SDK перехватите ConnectorError и проверьте code, status и доступные ID запроса или выполнения. Повторы описаны в справочнике SDK. Сначала исправьте ключи или аккаунт при ошибке авторизации. В MCP различайте сбой подключения и инструмента. Если обнаружение работает, а запрос GitHub — нет, проверьте команду и подключение. Сохраните ошибку без секретов и идентификатор операции.

Выберите рабочий путь

API/SDK удобен, если код управляет расписанием, вводом и повторами. MCP подходит ИИ-клиенту с обнаружением инструментов. Простому API может не требоваться дополнительная платформа. Справочник SDK различает личные/командные и клиентские аккаунты. Можно начать в OOMOL Chat, затем перейти к GitHub или Search Console.