MCP и API: различия, примеры и выбор
Сравните MCP и API на одном запросе аккаунта без изменений: обнаружение инструментов, ключи, выполнение и ошибки.
Прямой 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.