---
author: OOMOL
author_url: https://oomol.com/ru/about/
datePublished: 2026-11-11
title: "MCP и API: различия, примеры и выбор"
description: "Сравните MCP и API на одном запросе аккаунта без изменений:
  обнаружение инструментов, ключи, выполнение и ошибки."
lang: ru
canonical_url: https://oomol.com/ru/blog/mcp-vs-api/
markdown_url: https://oomol.com/ru/blog/mcp-vs-api.md
---

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

## Что меняется

В API/SDK код выбирает операцию и обрабатывает ответ. В MCP клиент обнаруживает инструменты сервера и вызывает их по протоколу. Разрешения исходного сервиса всё ещё необходимы. См. [официальную архитектуру](https://modelcontextprotocol.io/docs/learn/architecture).

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

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

## Вызов из backend

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

```ts
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](/ru/docs/connector-client/). Личные, проектные и MCP-ключи нельзя подменять друг другом.

## Вызов через MCP

Откройте [настройку MCP](/ru/install/mcp/), выберите личную или командную область и добавьте конфигурацию в совместимый клиент.

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

Проверьте тот же аккаунт. OOMOL предоставляет инструменты обнаружения и выполнения; каждая операция GitHub не обязательно отображается отдельно. Детали — в [руководстве MCP](/ru/docs/agents/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](/ru/docs/connector-sdk/). Сначала исправьте ключи или аккаунт при ошибке авторизации. В MCP различайте сбой подключения и инструмента. Если обнаружение работает, а запрос GitHub — нет, проверьте команду и подключение. Сохраните ошибку без секретов и идентификатор операции.

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

API/SDK удобен, если код управляет расписанием, вводом и повторами. MCP подходит ИИ-клиенту с обнаружением инструментов. Простому API может не требоваться дополнительная платформа. [Справочник SDK](/ru/docs/connector-sdk/) различает личные/командные и клиентские аккаунты. Можно начать в [OOMOL Chat](https://console.oomol.com/overview), затем перейти к [GitHub](/ru/integrations/github/) или [Search Console](/ru/integrations/google_search_console/).
