MCP-сервер

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

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

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

Не путать с коннекторами чата. MCP-сервер RouterAI даёт вашему агенту доступ к аккаунту RouterAI. Коннекторы — обратная функция: они подключают к веб-чату RouterAI внешние MCP-серверы, чтобы модель в чате вызывала их инструменты.

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

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

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

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

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

Откроется браузер: войдите в RouterAI, проверьте разрешения и лимит расходов и нажмите «Разрешить доступ». Cursor подключается через файл настроек — шаги в разделе Подключение → Cursor. Там же подключение готовым токеном и решение проблем.

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

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

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

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

Инструменты

Инструменты, которые возвращают данные, объявляют схему ответа с описанием каждого поля. Показывает ли клиент эту схему агенту, зависит от клиента, поэтому главное о форме ответа повторено в описании самого инструмента. get_doc возвращает текст страницы, generate_image — изображение.

Агент видит только те инструменты, которые разрешены его токену. Как выбрать разрешения — в разделе MCP-токены.

Особенности ответов

• Знак сумм в выписке. В get_statement сумма операции идёт со знаком: пополнение — плюсом, списание — минусом. Суммы в сводке расходов положительные.
• Мелкие списания. Суммы в выписке округлены до копеек, поэтому списание меньше 0,005 ₽ видно как операция с суммой 0.
• Остаток в выписке и баланс. Остаток на конец периода в get_statement учитывает списания, которые ещё не отразились на балансе, поэтому он может быть чуть меньше, чем баланс в get_balance. Сколько можно потратить, точнее показывает выписка.
• Цены моделей. list_models даёт цены в ₽ за 1 млн токенов, а get_model и list_model_endpoints — в ₽ за единицу из pricing_units: за один токен, запрос, изображение, мегапиксель или секунду.
• Суммы команды — строками. get_team, list_team_members и list_team_invitations отдают баланс, лимиты и расходы строкой с десятичным числом, например "120.5". Лимит "0.0" означает «без лимита».

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

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

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

Лимиты

• До 120 запросов к MCP-серверу в минуту на один ключ. При превышении сервер отвечает ошибкой 429 — повторите запрос через минуту.
• Платные инструменты тратят не больше месячного лимита расходов токена — см. Лимит расходов.

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

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

Что дальше

• Подключение — Claude Code, Codex CLI, OpenCode, Cursor и другие клиенты.
• MCP-токены — выпуск, разрешения, лимит расходов и отзыв.