> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> RockAPI поддерживает Model Context Protocol. Разбираем, что MCP меняет для ИИ-агентов, как добавить MCP-сервер RockAPI в Claude Code, Cursor, Codex и Claude Desktop и как проверить подключение.

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

В этой статье: что именно меняет MCP, два уровня настройки, которые нужно различать, и полная процедура подключения с проверкой.

![Схема архитектуры RockAPI MCP: ИИ-агент подключается через MCP-клиент к MCP-серверу RockAPI и далее к моделям OpenAI, Claude и Gemini](https://mintcdn.com/rockapi/H_B3LeAF53GjlC9D/images/blog/rockapi-mcp-architecture.svg?fit=max\&auto=format\&n=H_B3LeAF53GjlC9D\&q=85\&s=e510582e3dffb537393cef696ce25283)

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

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

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

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

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

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

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

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

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

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

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

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

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

### Claude Code

```bash theme={null}
claude mcp add --transport http rockapi "$ROCKAPI_MCP_URL" \
  --header "Authorization: Bearer $ROCKAPI_API_KEY"
```

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

```bash theme={null}
claude mcp list
```

### Codex

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

```toml theme={null}
[mcp_servers.rockapi]
url = "https://your-mcp-endpoint-from-console"
bearer_token_env_var = "ROCKAPI_API_KEY"
```

### Cursor и VS Code

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

```json theme={null}
{
  "mcpServers": {
    "rockapi": {
      "type": "http",
      "url": "${env:ROCKAPI_MCP_URL}",
      "headers": {
        "Authorization": "Bearer ${env:ROCKAPI_API_KEY}"
      }
    }
  }
}
```

### Claude Desktop

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

```json theme={null}
{
  "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-ключами](https://docs.rockapi.ai/ru/blog/buyers/secure-api-key-management.md).
* **Логируйте вызовы инструментов.** При странном поведении последовательность вызовов объясняет причину быстрее, чем финальный ответ.

## FAQ

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

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

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

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

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

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

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

Нет. Оплата идёт по фактическим вызовам моделей. Правила учёта описаны в разделе [тарифы и биллинг](https://docs.rockapi.ai/ru/pricing-and-billing.md).

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

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

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

Если вы ещё не отправляли запрос, начните с [быстрого старта](https://docs.rockapi.ai/ru/quickstart.md), затем выберите модель для агента в разделе [модели и провайдеры](https://docs.rockapi.ai/ru/models-and-providers.md).

> [card] [Создайте API-ключ и подключите агента](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=blog_buyers_mcp_ru)
>
> Выпустите ключ, скопируйте конфигурацию MCP из консоли и проверьте подключение до продакшен-трафика.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.