# MCP-сервер

**MCP-сервер RouterAI** подключает AI-агента — Claude Code, Cursor, Codex и другие — к
вашему аккаунту по открытому протоколу [Model Context Protocol](https://modelcontextprotocol.io).
Агент получает живые данные прямо в редакторе: подбирает модель по цене и возможностям,
проверяет баланс, разбирает генерации и может отправить тестовый запрос модели.

Адрес сервера:

```
https://routerai.ru/api/v1/mcp
```

## Быстрое подключение

Выполните команды для вашего агента:


```bash
claude mcp add --transport http \
  routerai https://routerai.ru/api/v1/mcp
claude mcp login routerai
```

```bash
codex mcp add routerai \
  --url https://routerai.ru/api/v1/mcp
codex mcp login routerai
```

```bash
opencode mcp add routerai --global \
  --url https://routerai.ru/api/v1/mcp
opencode mcp auth routerai
```


Откроется браузер: войдите в RouterAI, проверьте разрешения и лимит расходов и нажмите «Разрешить
доступ». Cursor подключается через файл настроек — шаги в разделе
[Подключение → Cursor](/docs/guides/mcp/connect#cursor). Там же подключение готовым токеном и
решение проблем.

## Что умеет агент

- **Подобрать модель** — искать по каталогу с фильтрами (автор, модальности, поддерживаемые
  параметры, длина контекста, цена) и смотреть полную карточку модели с ценами в рублях.
- **Следить за расходами** — баланс аккаунта, лимит и расход ключа, выписка пополнений и
  списаний, ссылка на пополнение.
- **Разобрать генерацию** — модель, провайдер, токены, стоимость и задержка по id генерации.
- **Найти ответ в документации** RouterAI.
- **Проверить промпт или модель** — отправить сообщение модели или сгенерировать изображение.
  Это платно.
- **Посмотреть команду** — участников и приглашения, если токен выпущен на команду.

Примеры просьб к агенту:

- «Найди в RouterAI самую дешёвую модель с поддержкой tools и контекстом от 128 тысяч токенов»
- «Сколько у меня осталось на балансе и на что ушли деньги за последнюю неделю?»
- «Отправь этот промпт двум моделям и сравни ответы и стоимость»

## Инструменты

| Инструмент | Что делает | Разрешение |
| --- | --- | --- |
| `list_models` | поиск по каталогу моделей с фильтрами; цены в ₽ за 1 млн токенов | Каталог моделей и цены |
| `get_model` | полная карточка модели: контекст, модальности, все цены, поддерживаемые параметры | Каталог моделей и цены |
| `list_model_endpoints` | провайдеры модели с их ценами и характеристиками | Каталог моделей и цены |
| `search_docs` | поиск по документации RouterAI | Каталог моделей и цены |
| `get_doc` | страница документации целиком | Каталог моделей и цены |
| `get_balance` | баланс аккаунта, лимит и расход ключа | Баланс и лимит |
| `get_top_up_link` | ссылка на форму пополнения баланса; деньги не списывает | Баланс и лимит |
| `get_statement` | выписка: пополнения и списания за период | Баланс и лимит |
| `get_generation` | метаданные генерации по id — без текстов запроса и ответа | История генераций |
| `get_team` | команда: название, баланс, число участников и приглашений | Команда |
| `list_team_members` | участники команды: роли, лимиты и расходы | Команда |
| `list_team_invitations` | отправленные приглашения в команду | Команда |
| `send_message` | **платно:** отправляет сообщение модели и возвращает ответ | Платные запросы к моделям |
| `generate_image` | **платно:** генерирует изображение по описанию | Платные запросы к моделям |

Агент видит только те инструменты, которые разрешены его токену. Как выбрать разрешения —
в разделе [MCP-токены](/docs/guides/mcp/tokens).

## Платные инструменты

`send_message` и `generate_image` выполняют настоящий запрос к модели. Стоимость по тарифу
модели списывается с баланса аккаунта, на который выпущен токен, — так же, как при обычном
вызове API. В ответе инструмента — сумма списания и id генерации.

- Платные инструменты доступны только MCP-токену с разрешением «Платные запросы к моделям».
  Для такого токена обязателен месячный лимит расходов — больше него агент не потратит.
- `send_message` ограничивает длину ответа параметром `max_tokens`: по умолчанию 2048,
  максимум 32 000. Суффикс `:online` к id модели включает веб-поиск (за доплату),
  а `@provider=<slug>` закрепляет провайдера — слаги возвращает `list_model_endpoints`.
- `generate_image` создаёт одно изображение за вызов.
- Если модель не ответила за 2 минуты (изображение — за 3 минуты), инструмент вернёт ошибку.
  Если агент отключился, не дождавшись ответа, вызов прерывается, как обрыв соединения в API.
  Было ли списание, видно в «Детальных логах» личного кабинета — там отражается каждый
  платный вызов.

## Лимиты

- До 120 запросов к MCP-серверу в минуту на один ключ. При превышении сервер отвечает
  ошибкой `429` — повторите запрос через минуту.
- Платные инструменты тратят не больше месячного лимита расходов токена — см.
  [Лимит расходов](/docs/guides/mcp/tokens#лимит-расходов).

## Чем подключать агента

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

| | MCP-токен | API-ключ |
| --- | --- | --- |
| Каталог моделей, баланс, генерации, документация | да | да |
| Выписка и данные команды | да | нет |
| Платные инструменты | да, с разрешением и лимитом расходов | нет |
| Разрешения | выбираются при выпуске | только чтение |
| Работает с API `/api/v1` | нет, только с MCP-сервером | да |

## Что дальше

- [Подключение](/docs/guides/mcp/connect) — Claude Code, Codex CLI, OpenCode, Cursor и другие
  клиенты.
- [MCP-токены](/docs/guides/mcp/tokens) — выпуск, разрешения, лимит расходов и отзыв.