MCP-сервер
MCP-сервер RouterAI подключает AI-агента — Claude Code, Cursor, Codex и другие — к вашему аккаунту по открытому протоколу Model Context Protocol. Агент получает живые данные прямо в редакторе: подбирает модель по цене и возможностям, проверяет баланс, разбирает генерации и может отправить тестовый запрос модели.
Адрес сервера:
https://routerai.ru/api/v1/mcp
Быстрое подключение
Выполните команды для вашего агента:
claude mcp add --transport http \
routerai https://routerai.ru/api/v1/mcp
claude mcp login routerai
Откроется браузер: войдите в RouterAI, проверьте разрешения и лимит расходов и нажмите «Разрешить доступ». Cursor подключается через файл настроек — шаги в разделе Подключение → 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-токены.
Платные инструменты
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— повторите запрос через минуту. - Платные инструменты тратят не больше месячного лимита расходов токена — см. Лимит расходов.
Чем подключать агента
Для агентов удобнее MCP-токен: у него можно ограничить разрешения, расходы и срок действия, а отозвать его, не затронув приложения, которые работают на API-ключе. Обычный API-ключ тоже подключается к MCP-серверу, но только на чтение.
| MCP-токен | API-ключ | |
|---|---|---|
| Каталог моделей, баланс, генерации, документация | да | да |
| Выписка и данные команды | да | нет |
| Платные инструменты | да, с разрешением и лимитом расходов | нет |
| Разрешения | выбираются при выпуске | только чтение |
Работает с API /api/v1 |
нет, только с MCP-сервером | да |
Что дальше
- Подключение — Claude Code, Codex CLI, OpenCode, Cursor и другие клиенты.
- MCP-токены — выпуск, разрешения, лимит расходов и отзыв.