Загрузка...

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-токены — выпуск, разрешения, лимит расходов и отзыв.