RockAPI MCP: подключаем ИИ-агентов к 50+ моделям одним ключом

RockAPI теперь поддерживает Model Context Protocol (MCP). Вместо интеграционного кода под каждый фреймворк агента достаточно добавить один MCP-сервер в клиент, и агент вызывает RockAPI с тем же API-ключом, который вы уже используете. В этой статье: что именно меняет MCP, два уровня настройки, которые нужно различать, и полная процедура подключения с проверкой.

Схема архитектуры RockAPI MCP: ИИ-агент подключается через MCP-клиент к MCP-серверу RockAPI и далее к моделям OpenAI, Claude и Gemini

Что реально меняет MCP

MCP — стандарт, по которому ИИ-клиент обнаруживает инструменты сервера и вызывает их. До MCP у каждого фреймворка был свой формат плагинов, и одну и ту же возможность приходилось реализовывать заново для Claude Code, Cursor, Codex и остальных.

Без MCP	С MCP
Отдельная интеграция под каждый клиент и провайдера	Одно описание сервера, которое загружает любой MCP-клиент
Схемы инструментов копируются в промпты вручную	Схемы обнаруживаются во время работы через `tools/list`
Логика авторизации повторяется в каждой интеграции	Один эндпоинт и один Bearer-ключ
Модель и инструменты связаны в одном конфиге	Выбор модели и доступ к инструментам настраиваются раздельно

Практический результат: у агента появляется стабильная поверхность возможностей, а поддерживать параллельные интеграции больше не нужно.

Два уровня настройки, которые нужно различать

Это самый частый источник путаницы, поэтому разделите их до начала работы.

Уровень	На какой вопрос отвечает	Где настраивается
Уровень модели	Какая LLM выполняет рассуждение и генерацию	Настройки модели или провайдера в клиенте
Уровень инструментов	К каким инструментам и данным имеет доступ агент	Запись MCP-сервера в клиенте

Когда вы добавляете RockAPI как MCP-сервер, это уровень инструментов. Когда используете RockAPI как провайдера через API, совместимый с OpenAI, это уровень модели. Оба варианта можно применять одновременно, но это две отдельные записи.

Перед началом

Создайте API-ключ. Выпустите его на rockapi.ai/keys и храните в переменной окружения, а не в файле, который попадает в репозиторий.
Скопируйте конфигурацию MCP. Консоль показывает эндпоинт MCP и формат заголовка для вашего аккаунта. Берите значение со страницы, а не воспроизводите URL по памяти.
Проверьте поддержку MCP в клиенте. Claude Code, Cursor, Codex, VS Code и Claude Desktop поддерживают MCP. Если команда ниже отклонена, проверьте версию клиента.
Определите модель. Какой бы клиент вы ни использовали, агенту нужна LLM. Выберите её в настройках провайдера или направьте запросы через RockAPI.

export ROCKAPI_API_KEY="sk-your-key"
export ROCKAPI_MCP_URL="<эндпоинт со страницы MCP в консоли>"

Добавляем MCP-сервер

Команда отличается по клиентам, но входные данные одинаковы: URL, транспорт и заголовок Authorization: Bearer.

Claude Code

claude mcp add --transport http rockapi "$ROCKAPI_MCP_URL" \
  --header "Authorization: Bearer $ROCKAPI_API_KEY"

Проверьте регистрацию:

claude mcp list

Codex

Добавьте сервер в ~/.codex/config.toml. Чтение токена из переменной окружения не оставляет секрет в файле:

[mcp_servers.rockapi]
url = "https://your-mcp-endpoint-from-console"
bearer_token_env_var = "ROCKAPI_API_KEY"

Cursor и VS Code

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

{
  "mcpServers": {
    "rockapi": {
      "type": "http",
      "url": "${env:ROCKAPI_MCP_URL}",
      "headers": {
        "Authorization": "Bearer ${env:ROCKAPI_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop запускает серверы командной строки, поэтому нужен мост mcp-remote:

{
  "mcpServers": {
    "rockapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-mcp-endpoint-from-console",
        "--header",
        "Authorization: Bearer ${ROCKAPI_API_KEY}"
      ]
    }
  }
}

Проверяем подключение

Статус «подключено» не повод выводить агента в продакшен. Подтвердите четыре поведения.

Проверка	Как выполнить	Нормальный результат
Сервер зарегистрирован	`claude mcp list` или панель MCP в клиенте	Сервер показан как подключённый, без ошибки
Инструменты обнаруживаются	Попросите агента перечислить доступные инструменты	Непустой список без ответа 401
Вызов проходит	Попросите выполнить одно действие только на чтение	Структурированный результат, а не таймаут
Ошибка читаема	Временно подставьте неверный ключ	Явная ошибка авторизации, а не пустой ответ

Если сервер подключается, но вызовы падают, причина обычно в токене, а не в транспорте. Сначала смените ключ и повторите проверку.

Правила эксплуатации, которые предотвращают инциденты

Ограничьте область ключа. Для MCP-интеграции используйте отдельный ключ, а не основной продакшен-ключ: отзыв одного не сломает другой.
Начинайте с чтения. Дайте агенту минимальные права, достаточные для задачи, и расширяйте их только под реальный процесс.
Следите за расходами отдельно. Агенты на инструментах делают много мелких вызовов. Отдельный ключ делает стоимость каждого агента видимой в панели.
Храните секреты в окружении. Ключ, вставленный в отслеживаемый конфиг, — самый частый канал утечки в настройках агентов. См. безопасное управление API-ключами.
Логируйте вызовы инструментов. При странном поведении последовательность вызовов объясняет причину быстрее, чем финальный ответ.

FAQ

MCP — это то же самое, что API, совместимый с OpenAI?

Нет. API, совместимый с OpenAI, стандартизирует вызов модели из кода. MCP стандартизирует обнаружение и вызов инструментов ИИ-клиентом. RockAPI даёт оба варианта, и настраиваются они в разных местах.

Нужен ли API-ключ при использовании MCP?

Да. MCP-сервер доступен, но именно ключ идентифицирует аккаунт, применяет лимиты и фиксирует расход в счёте.

Может ли один MCP-сервер обслуживать несколько агентов?

Да, в этом и смысл. Одна запись сервера работает в разных клиентах: сессия Claude Code и сессия Cursor получают одинаковый набор возможностей с одним ключом.

Меняет ли MCP принцип оплаты моделей?

Нет. Оплата идёт по фактическим вызовам моделей. Правила учёта описаны в разделе тарифы и биллинг.

Что делать, если клиент ещё не поддерживает HTTP MCP-серверы?

Используйте мост mcp-remote из примера для Claude Desktop. Он превращает HTTP-эндпоинт в локальный stdio-процесс, который запускает любой клиент командной строки.

Следующий шаг

Если вы ещё не отправляли запрос, начните с быстрого старта, затем выберите модель для агента в разделе модели и провайдеры.

Создайте API-ключ и подключите агента

Выпустите ключ, скопируйте конфигурацию MCP из консоли и проверьте подключение до продакшен-трафика.

Обзор

Для покупателей

Для продавцов

RockAPI MCP: подключаем ИИ-агентов к 50+ моделям одним ключом

Что реально меняет MCP

Два уровня настройки, которые нужно различать

Перед началом

Добавляем MCP-сервер

Claude Code

Codex

Cursor и VS Code

Claude Desktop

Проверяем подключение

Правила эксплуатации, которые предотвращают инциденты

FAQ

MCP — это то же самое, что API, совместимый с OpenAI?

Нужен ли API-ключ при использовании MCP?

Может ли один MCP-сервер обслуживать несколько агентов?

Меняет ли MCP принцип оплаты моделей?

Что делать, если клиент ещё не поддерживает HTTP MCP-серверы?

Следующий шаг

Создайте API-ключ и подключите агента

​Что реально меняет MCP

​Два уровня настройки, которые нужно различать

​Перед началом

​Добавляем MCP-сервер

​Claude Code

​Codex

​Cursor и VS Code

​Claude Desktop

​Проверяем подключение

​Правила эксплуатации, которые предотвращают инциденты

​FAQ

​MCP — это то же самое, что API, совместимый с OpenAI?

​Нужен ли API-ключ при использовании MCP?

​Может ли один MCP-сервер обслуживать несколько агентов?

​Меняет ли MCP принцип оплаты моделей?

​Что делать, если клиент ещё не поддерживает HTTP MCP-серверы?

​Следующий шаг

Создайте API-ключ и подключите агента

Что реально меняет MCP

Два уровня настройки, которые нужно различать

Перед началом

Добавляем MCP-сервер

Claude Code

Codex

Cursor и VS Code

Claude Desktop

Проверяем подключение

Правила эксплуатации, которые предотвращают инциденты

FAQ

MCP — это то же самое, что API, совместимый с OpenAI?

Нужен ли API-ключ при использовании MCP?

Может ли один MCP-сервер обслуживать несколько агентов?

Меняет ли MCP принцип оплаты моделей?

Что делать, если клиент ещё не поддерживает HTTP MCP-серверы?

Следующий шаг