Как подключить OpenRouter к Microsoft Copilot через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → OpenRouter, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

OpenRouter + Microsoft Copilot

OpenRouter, один API для сотен AI-моделей: поиск по каталогу моделей с ценами, провайдерами, бенчмарками и рейтингами, проверка расходов ключа, просмотр прошлых генераций и отправка chat completions, эмбеддингов и запросов изображений любой модели.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

OPENROUTER_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужна учётная запись OpenRouter.

1. Войдите на https://openrouter.ai и пополните баланс в Settings, Credits. Бесплатные модели :free работают без кредитов в пределах дневных лимитов.
2. Откройте Settings, API Keys (https://openrouter.ai/settings/keys), нажмите Create Key, задайте имя и, настоятельно рекомендуется, credit limit: ключ может тратить баланс аккаунта до этого лимита.
3. Вставьте ключ, начинающийся с sk-or-v1-, в OPENROUTER_API_KEY. Он отправляется как Authorization: Bearer. Ключ управления (management key) здесь не подходит. Запросы несут заголовки HTTP-Referer и X-OpenRouter-Title, которые указывают AnythingMCP как вызывающее приложение в OpenRouter.
4. Установите коннектор и запустите openrouter_get_current_key, чтобы проверить ключ.

Что он читает (бесплатно):

• Каталог моделей через openrouter_list_models: id моделей, длина контекста, цены, модальности ввода и вывода, поддерживаемые параметры и поддержка reasoning, с фильтрами вроде q, category, supported_parameters=tools, max_price и context и сортировкой на сервере, например sort=pricing-low-to-high. openrouter_list_user_models показывает модели, которые этот ключ действительно может использовать с учётом предпочтений по провайдерам, настроек приватности и guardrails аккаунта.
• Одну модель через openrouter_get_model, эндпоинты провайдеров, которые её обслуживают, через openrouter_list_model_endpoints (цена, лимиты контекста и вывода, квантизация, статус, аптайм, задержка и пропускная способность за последние 30 минут) и openrouter_list_providers для слагов провайдеров, штаб-квартиры, стран дата-центров и ссылок на их политики.
• Качество и популярность: openrouter_list_benchmarks (Artificial Analysis, Design Arena и собственные оценки OpenRouter) и openrouter_get_model_rankings (топ-50 моделей по токенам за день, неделю или месяц, данные с 2025-01-01).
• Расходы: openrouter_get_current_key показывает лимит ключа, limit_remaining, расход за сегодня, эту неделю, этот месяц и всего, бюджеты и статус бесплатного уровня. openrouter_get_generation даёт точную стоимость, токены, задержку и провайдера одного вызова (его id это id completion, он может появиться через несколько секунд), а openrouter_get_generation_content сохранённые промпт и ответ, если включено логирование промптов.

Что стоит денег: openrouter_chat_completion (с model и messages; models добавляет запасные модели, provider управляет маршрутизацией по порядку, only, цене или пропускной способности, data_collection: deny или zdr, response_format запрашивает JSON, reasoning задаёт усилие), openrouter_create_embeddings и openrouter_generate_image (возвращаются как изображения). Они оплачиваются со счёта аккаунта, если не используется модель :free. Все инструменты включены при установке, поэтому ИИ подтверждает модель и цель перед крупными или повторными вызовами и задаёт max_completion_tokens, чтобы ограничить ответ.

Форматы данных: id моделей имеют вид author/slug (openai/gpt-4o), варианты: :free (бесплатно, с лимитом), :online (веб-поиск), :nitro (самый быстрый провайдер), :floor (самый дешёвый) и :thinking. Цены в каталоге это строки в USD за токен ("0.0000025" равно 2,50 USD за миллион токенов); request и image указаны за запрос или за изображение. Фильтры max_price и max_price маршрутизации принимают USD за миллион токенов. Стоимость и расход в ответах о ключе и генерациях указаны в USD. Completion возвращает choices[0].message.content, finish_reason (stop, length при достижении лимита токенов, tool_calls, content_filter), usage с числом токенов и cost, а также provider. created в секундах Unix; даты в UTC.

Постраничный вывод: инструменты списка моделей по умолчанию возвращают 50 моделей; ИИ передаёт offset 50, 100 и так далее с тем же limit, пока страница не вернётся короче, и предпочитает фильтры и sort чтению всего каталога.

Ограничения: модели :free допускают 20 запросов в минуту и 50 в день, или 1 000 в день, если когда-либо было куплено кредитов на 10 USD. Платные модели ограничены балансом аккаунта, credit limit ключа и бюджетами, заданными администратором организации. Бенчмарки допускают 30 запросов в минуту на ключ.

Частые ошибки: 401 означает недействительный или отключённый ключ. 402 значит, что кредитов не хватает или лимит ключа исчерпан (error.metadata.limit_source укажет, какой; пополните баланс или поднимите лимит). 403 это блокировка guardrail или модерацией, 404 неизвестная модель или генерация, 408 тайм-аут, 429 лимит запросов (подождите или используйте платный вариант), 502 сбой у провайдера модели, 503 нет провайдера, отвечающего требованиям маршрутизации (ослабьте provider). Ошибка провайдера во время генерации может прийти с HTTP 200 и объектом error; она сообщается как неудачный вызов.

Коннектор не показывает баланс всего аккаунта, отчёты об активности и аналитику и не управляет ключами, потому что для этого нужен отдельный ключ управления. Стриминг, устаревший эндпоинт text completions, пакетная обработка, видео и аудио тоже не доступны.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты OpenRouter.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Какие модели с вызовом инструментов и контекстом от 128K стоят меньше 1 USD за миллион входных токенов?»
• «Сравни провайдеров, обслуживающих deepseek/deepseek-chat, по цене, аптайму и пропускной способности.»
• «Сколько этот API-ключ потратил в этом месяце и сколько осталось от его лимита?»
• «Попроси google/gemini-2.5-flash кратко изложить этот текст в пяти пунктах, не больше 500 выходных токенов.»
• «Какие модели в топ-10 по токенам на этой неделе и как они показывают себя в бенчмарках по программированию?»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse