OpenRouter MCP: настройка, вызовы моделей и реальные компромиссы

OpenRouter MCP — это размещённый сервер Model Context Protocol для исследования и тестирования моделей. Агент может прямо в диалоге проверить актуальные цены, бенчмарки, доступные endpoint’ы и документацию, прежде чем вы остановитесь на конкретной модели. Для production-вызовов OpenRouter API он не заменяет.

Главное: для чего нужен OpenRouter MCP

Официальный сервер доступен по адресу https://mcp.openrouter.ai/mcp. Совместимый клиент — например, Claude Code, Cursor или Claude Desktop — подключается к нему по удалённому HTTP и получает доступ к инструментам OpenRouter прямо в чате. Это удобный слой для поиска и проверки моделей; задачи приложения и действия в аккаунте провайдера по-прежнему должны выполняться через production API либо официальный MCP соответствующего провайдера.

В официальном анонсе OpenRouter перечислены актуальные данные о моделях, рейтинги, цены, документация и тестовый инференс. Endpoint, набор инструментов и особенности аутентификации описаны в документации MCP.

Сначала сценарий работы, потом адрес сервера

Практичнее всего строить работу по схеме найти, сравнить, протестировать, проверить. Вместо расплывчатого вопроса «Какая модель лучше?» вы получаете решение с явными ограничениями.

1. Найти: запросите модели под нужную задачу, цену, объём контекста, модальность или провайдера. Для актуального каталога и бенчмарков используйте list-models и list-benchmarks.
2. Сравнить: вызовите list-model-endpoints для каждого кандидата, чтобы посмотреть цены на уровне провайдеров, задержки, пропускную способность и, где доступны, политики обработки данных.
3. Протестировать: отправьте один и тот же промпт через send-message, указав model slug. Такой вызов может быть платным.
4. Проверить: передайте ID каждой генерации в get-generation, чтобы узнать число токенов, стоимость и фактического обслуживающего провайдера.

Вот промпт для Claude Code или Cursor:

Use OpenRouter MCP to find three models for extracting structured data from
legal documents. Requirements: at least 100k context, tool calling, and the
lowest available input price. Compare providers and data policies. Then use
send-message to run this exact prompt against the best two candidates:

"Extract every contract renewal date from the text below. Return only JSON
with an array named renewals, each item containing party, date, and evidence."

After the tests, use get-generation for each generation ID and report the
actual cost and serving provider. Do not call a model until I approve the
candidates.

Одобрение перед тестом важно потому, что поиск по каталогу выполняется только на чтение, а send-message может списать деньги за инференс. Для повторяемых оценок явно фиксируйте модель и провайдера. Суффиксы вроде :free, :floor, :nitro и :online при наличии задают предпочтения маршрутизации, а не гарантируют определённое качество.

Подключение официального удалённого сервера

Локально устанавливать ничего не нужно. Добавьте удалённый endpoint, завершите OAuth в браузере и авторизуйте отдельный ключ OpenRouter, не связанный с остальными вашими ключами. По документации, для него по умолчанию установлены срок действия 7 дней и лимит расходов $10; оба параметра можно изменить на экране подтверждения. OpenRouter использует OAuth с PKCE: обычный API-ключ не нужно вставлять в конфигурацию клиента.

Claude Code

Выполните:

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

Первая команда регистрирует удалённый HTTP-сервер, вторая открывает OAuth-поток. В сессии Claude Code можно также вызвать /mcp, выбрать сервер OpenRouter и пройти аутентификацию — этот способ описан в документации Claude Code по MCP.

Начните с запроса без побочных эффектов: «Use OpenRouter MCP to list two current models with at least 128k context and show their input prices.»

Cursor

Добавьте удалённый сервер в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Если сервер не появился, перезапустите Cursor. Аутентификация запускается из настроек MCP Cursor либо при первом обращении к инструменту. Документированный CLI называется cursor-agent; проверить запись можно так:

cursor-agent mcp list

В документации Cursor по MCP описаны конфигурации уровня пользователя и проекта. Добавляйте сервер на нужном уровне и не коммитьте персональную конфигурацию аутентификации в общий репозиторий.

Claude Desktop и Claude Web

Если OpenRouter отсутствует в каталоге коннекторов Claude, инструкция по подключению OpenRouter предлагает добавить собственный удалённый коннектор:

1. Откройте Settings > Connectors > Customize > Connectors.
2. Нажмите +, затем выберите Add custom connector.
3. Назовите его OpenRouter MCP.
4. Укажите https://mcp.openrouter.ai/mcp в качестве URL удалённого MCP-сервера.
5. Оставьте поля OAuth пустыми, добавьте коннектор, откройте его и нажмите Connect.
6. Подтвердите доступ в браузере OpenRouter.

В некоторых организациях пользовательские коннекторы отключены. Если в управляемом аккаунте нужного пункта нет, обратитесь к администратору. Основные принципы протокола на стороне клиента разобраны в документации Anthropic по MCP.

Какие действия можно запрашивать без риска

Большинство официальных инструментов OpenRouter MCP получают актуальные данные. Запоминать полный список необязательно: полезнее разделять их по наличию побочных эффектов.

При подборе модели сразу формулируйте правило выбора: «Find the lowest-cost model with tool calling and a 64k context window, then show the fastest available endpoint.» Среди документированных фильтров есть цена, минимальный контекст, семейство модели, автор, провайдер, модальность, поддерживаемые параметры, диапазоны бенчмарков, успешность tool calling, наличие zero-data-retention и регион.

Для контролируемого теста модели укажите slug и сделайте промпт воспроизводимым:

Use OpenRouter MCP send-message with model "openai/gpt-4o".
Send exactly this user message and do not add a system prompt:

"Return a JSON object with keys title and risks. Analyze this release note:
[paste text here]"

Show me the response and the generation ID. Do not run another model.

Этот slug приведён лишь как пример: сначала убедитесь через list-models, что он доступен. Для проверяемых сравнений требуйте конкретные инструменты поиска, возвращённые ими значения и ID генерации, а не принимайте рекомендацию модели без подтверждающих данных.

OpenRouter MCP и официальные MCP-серверы провайдеров

OpenRouter MCP — это кросс-провайдерный слой для анализа и тестирования. Официальный MCP провайдера обычно предпочтительнее, когда действие относится к его продукту, аккаунту или плоскости данных.

Выбирайте OpenRouter MCP, когда вопрос звучит так: «Какую модель или маршрут использовать?» Официальный MCP провайдера нужен для вопроса «Что я могу сделать внутри сервиса этого провайдера?». Если требуются обе возможности, их можно подключить к одному агенту.

Локальные или мультимодальные MCP-серверы от сообщества — отдельная категория. На странице Works With OpenRouter описан один такой сервер для нескольких клиентов и сценариев с текстом, изображениями, аудио и видео. Ему нужны API-ключ OpenRouter и кредиты; это не официальный хостинговый сервис по адресу mcp.openrouter.ai.

Ограничения, важные для реального проекта

«@OpenRouter’s ori harness/cli has been a blessing... p.s: also thanks for openrouter mcp for quickly checking up info on models 🫰» — @CodewithP, X, о сценарии быстрого поиска информации по моделям.

В MCP cookbook OpenRouter также рассматривается обратный сценарий: модели OpenRouter используются как LLM-бэкенд для других MCP tool server, а не coding-клиент подключается к OpenRouter MCP.

Что проверить при первом сбое

1. Сервер отображается, но инструменты не проходят аутентификацию. Повторите OAuth-шаг для конкретного клиента. Документированный срок жизни выделенного ключа — 7 дней; его также можно отключить в панели OpenRouter.
2. Браузер не открывается. Используйте claude mcp login openrouter, действие /mcp в Claude Code, настройки MCP в Cursor или кнопку Connect в коннекторе Claude.
3. В Claude Desktop нет опции пользовательского коннектора. Проверьте, не отключил ли администратор организации custom connectors.
4. Ответ о модели выглядит устаревшим. Явно запросите list-models, list-benchmarks или list-model-endpoints и попросите вывести возвращённые значения.
5. Тест оказался дороже или был направлен не туда, куда ожидалось. Проверьте его ID через get-generation, затем зафиксируйте явного провайдера для следующего воспроизводимого прогона.

FAQ

Может ли OpenRouter MCP вызывать любую модель OpenRouter?

Он может тестировать model slug из актуального каталога с учётом доступности, возможностей модели, кредитов и ограничений маршрутизации. Сначала подтвердите slug через list-models.

Можно ли одновременно использовать OpenRouter MCP в Claude Desktop, Cursor и Claude Code?

Один и тот же официальный endpoint можно добавить в каждый клиент, следуя его документированному процессу настройки и аутентификации. Не включайте персональные учётные данные в общую конфигурацию.

Стоит ли вместо этого установить пакет сообщества openrouter-mcp?

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

Начните с запроса к каталогу только на чтение. Контролируемый вызов инференса стоит авторизовать лишь после того, как определены модель, маршрут и лимит расходов.