Бета. Сервер работает стабильно, но набор инструментов и формат ответов могут уточняться по мере отзывов.

Быстрее всего подключиться со страницы hubris.pw/mcp: там кнопки «Подключить к Claude», «Добавить в Cursor», «Установить в VS Code» и готовые команды для Claude Code, OpenClaw, Hermes и других агентов.

Model Context Protocol — открытый стандарт от Anthropic. Через MCP агенты (Claude Desktop, Claude Code, Cline, Cursor) получают доступ к внешним сервисам единообразным способом: каталог моделей, баланс, отправка запросов в LLM — всё через одно подключение.

Hubris-MCP даёт агенту:

Каталог моделей с ценой в рублях, фильтрами по возможностям, цене и длине контекста.
Баланс и расход — чтобы агент знал, сколько ему доступно и сколько уже потрачено.
Все виды моделей: текст (chat_complete), эмбеддинги, реранкеры, модели решений, картинки, озвучка, распознавание речи, видео и расшифровка роликов YouTube. Каждый инструмент — тот же запрос, что в API, с теми же ценами.
Готовый промпт compare-models для сравнения моделей под конкретную задачу.

Что такое MCP

MCP позволяет AI-агентам вызывать инструменты и читать ресурсы внешних сервисов без необходимости хранить API-ключ напрямую в промпте или писать собственные интеграции. Агент узнаёт о доступных инструментах автоматически при подключении к серверу.

Hubris реализует MCP через транспорт Streamable HTTP — один адрес https://api.hubris.pw/mcp, ничего ставить не нужно. Для клиентов, которые умеют запускать только локальный процесс (stdio), есть npm-пакет hubris-mcp.

Требования

Аккаунт на hubris.pw. Для клиентов с OAuth (Claude Desktop, Claude.ai, Smithery) ключ не нужен; остальным — API-ключ формата sk-gw-… (создать на /keys).
Положительный баланс — пополнить можно здесь.
MCP-клиент: Claude Desktop, Claude Code, Cline, Cursor, любой другой совместимый.

Подключение

Claude Desktop и Claude.ai

Самый короткий путь — без ключа и без файлов конфигурации:

Нажмите «Подключить к Claude» на странице hubris.pw/mcp: откроется окно Add custom connector с уже заполненными именем Hubris и адресом https://api.hubris.pw/mcp. Вручную: Customize → Connectors, «+», Add custom connector, те же имя и адрес.
Настройки окна оставьте такими, какими их определил Claude (отметка «Detected»), и нажмите Add:
- Authentication — Sign in now: без входа сервер инструменты не отдаёт.
- OAuth client — Register automatically: Claude сам зарегистрируется у Hubris. Вариант Use Claude's published identity не выбирайте: Hubris его пока не поддерживает, вход не пройдёт. Use your own OAuth client не нужен.
- Request headers — пусто, ключ не нужен.
Красная плашка «This connector was suggested by an external link» — стандартное предупреждение Claude для коннектора, открытого по ссылке; проверьте, что адрес https://api.hubris.pw/mcp.
Откроется браузер со страницей согласия Hubris «Авторизация приложения»: оставьте нужные доступы (запросы к моделям, каталог, баланс), при желании измените «Лимит расхода» (₽ в день) и нажмите «Разрешить».

После этого инструменты Hubris появятся в чате. Приложение получает отдельный токен со своим лимитом, а не ваш ключ; отозвать его можно в кабинете на вкладке Профиль → Приложения. Так же подключается и веб-версия claude.ai — коннектор общий для аккаунта.

Если нужен именно ключ sk-gw-… (например, ключ с привязкой к адресу или уже настроенный лимит), Claude Desktop можно подключить через локальный шим mcp-remote: понадобится Node.js. Файл конфигурации — %APPDATA%\Claude\claude_desktop_config.json в Windows, ~/Library/Application Support/Claude/claude_desktop_config.json в macOS:

{
  "mcpServers": {
    "hubris": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.hubris.pw/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_TOKEN}"],
      "env": { "AUTH_TOKEN": "Bearer sk-gw-..." }
    }
  }
}

Заголовок пишется как Authorization:${AUTH_TOKEN} без пробела у двоеточия — так рекомендует mcp-remote. После правки перезапустите Claude Desktop.

Claude Code

С ключом:

claude mcp add --transport http hubris https://api.hubris.pw/mcp --header "Authorization: Bearer sk-gw-..."

Или через OAuth, без ключа: добавьте сервер без заголовка, затем в сессии выполните /mcp, выберите hubris и пройдите авторизацию в браузере.

claude mcp add --transport http hubris https://api.hubris.pw/mcp

Проверьте, что сервер добавлен:

claude mcp list

По умолчанию сервер добавляется только для текущего проекта на вашей машине. Чтобы разделить его с командой через файл .mcp.json в репозитории, добавьте --scope project (ключ в такой файл не пишите — используйте вариант с OAuth). Сервер из .mcp.json в claude mcp list помечен «Pending approval», пока вы не подтвердите его при следующем запуске claude.

Cursor

Нажмите «Добавить в Cursor» на странице hubris.pw/mcp: Cursor откроется и предложит установить сервер hubris. Ключ не нужен, Cursor пройдёт вход по OAuth и откроет страницу согласия Hubris.

Вручную — файл ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hubris": { "url": "https://api.hubris.pw/mcp" }
  }
}

OpenClaw

OpenClaw обычно работает на сервере, куда вход через браузер не дотягивается, поэтому подключайте его с ключом sk-gw-… (лучше отдельным, чтобы отзывать независимо):

openclaw mcp set hubris '{"url":"https://api.hubris.pw/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer sk-gw-..."}}'

Проверка — openclaw mcp probe hubris покажет инструменты Hubris. Перезапускать шлюз не нужно: сервер подхватится со следующего сообщения (или openclaw mcp reload).

Можно не набирать команду самому, а отправить агенту промпт со страницы hubris.pw/mcp: он пропишет сервер сам. Вошедшим там же создаётся отдельный ключ для OpenClaw.

Hermes Agent

Добавьте сервер в ~/.hermes/config.yaml и выполните в Hermes /reload-mcp, перезапуск не нужен. Проверка — hermes mcp test hubris:

mcp_servers:
  hubris:
    url: "https://api.hubris.pw/mcp"
    headers:
      Authorization: "Bearer sk-gw-..."

Cline и другие клиенты

Любой MCP-клиент с поддержкой Streamable HTTP подключается тем же URL: клиенты с OAuth откроют страницу согласия сами, остальным нужен заголовок с ключом:

Поле	Значение
Transport	Streamable HTTP
URL	`https://api.hubris.pw/mcp`
Заголовок авторизации	`Authorization: Bearer sk-gw-…`

Подробности — в документации вашего клиента.

Локальный процесс: `npx hubris-mcp`

Если клиент умеет запускать только локальные серверы (stdio), подключите npm-пакет hubris-mcp. Он пересылает вызовы инструментов на https://api.hubris.pw/mcp с вашим ключом. С ключом пакет берёт список инструментов у сервера, поэтому в нём всегда те же инструменты, что в таблице ниже; без ключа отдаёт список, встроенный в версию (с 0.2.0 — все 15). Нужен Node.js 20 или новее. Ключ передаётся переменной окружения HUBRIS_API_KEY:

{
  "mcpServers": {
    "hubris": {
      "command": "npx",
      "args": ["-y", "hubris-mcp"],
      "env": { "HUBRIS_API_KEY": "sk-gw-..." }
    }
  }
}

Список инструментов пакет отдаёт и без ключа, а при вызове без HUBRIS_API_KEY возвращает ошибку HUBRIS_API_KEY is not set. Ресурсы и промпт compare-models через пакет недоступны — только инструменты; если они нужны, подключайтесь к адресу напрямую. Готовый ролик в этом случае скачивается по ссылке из unsigned_urls в ответе video_get с тем же ключом.

Инструменты

Инструмент	Что делает
`models_list`	Полный каталог активных моделей с курсорной пагинацией.
`models_search`	Поиск по названию, инструменту, который запускает модель (`tool`: `chat_complete`, `embeddings_create`, `image_generate`, `video_create` и другие), возможностям (`capability`: vision / reasoning / tools / web_search / audio_in / audio_out / image_gen / transcription / decisions / rerank), потолку цены и длине контекста, с сортировкой; до 50 моделей за вызов. У каждой модели в ответе есть поле `tool`.
`models_get_pricing`	Тариф конкретной модели в рублях (`modelId` — полный ID с вендором). Для моделей с оплатой за картинку, секунду или тысячу символов настоящая цена — в поле `perUnit`. У моделей озвучки — голоса (`supportedVoices`), у видеомоделей — допустимые длительности, разрешения и пропорции (`video`).
`balance_get`	Текущий баланс аккаунта.
`usage_get`	Расход за период (`period`: today, 24h, 7d, 30d, mtd): запросы, токены, сумма в рублях. С ключом — расход ключа, при входе через OAuth — всё, что приложение потратило с подключения. То же, что `GET /v1/usage`.
`chat_complete`	Запрос к выбранной модели в форме `/v1/chat/completions`: `model`, `messages`, `temperature`, `max_tokens`, `tools`, `tool_choice`, `response_format`, `web_search`, `reasoning`, `stop`, `seed`. Ответ — как у API, плюс `usage.cost_rub`. Потоковой передачи нет: `stream` игнорируется. Списывает деньги с баланса.
`embeddings_create`	Векторы из текста: `model`, `input` (строка или список до 16 строк: векторы целиком попадают в контекст агента), `dimensions`. То же, что `POST /v1/embeddings`. Списывает деньги.
`rerank`	Сортирует документы по близости к запросу: `model`, `query`, `documents`, `top_n`. То же, что `POST /v1/rerank`. Списывает деньги.
`decisions_ask`	Вопросы модели решений («да/нет», выбор, шкала) с вероятностями в ответе: `model`, `state`, `questions`. То же, что `POST /v1/decisions`. Списывает деньги.
`image_generate`	Рисует картинку и сразу отдаёт её агенту: `model`, `prompt`, `n` (1 или 2), `size`. То же, что `POST /v1/images/generations`. Списывает деньги.
`speech_create`	Озвучивает текст до 5 000 знаков и отдаёт аудиофайл (по умолчанию mp3): `model`, `input`, `voice`, `response_format`. Голоса модели — в `models_get_pricing` → `supportedVoices`. То же, что `POST /v1/audio/speech`. Списывает деньги.
`transcription_create`	Распознаёт речь из присланного аудио: `model`, `audio_base64`, `format`, `language`. Подходит для записей в секунды: агент выписывает файл в вызов целиком. То же, что `POST /v1/audio/transcriptions`. Списывает деньги.
`video_create`	Запускает генерацию видео и сразу отдаёт номер задачи: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `seed`, `idempotency_key`. То же, что `POST /v1/videos`. Удерживает и списывает деньги. При входе через OAuth нужно право «Создавать видео от вашего имени»: если инструмент отвечает, что не хватает `videos:write`, подключитесь заново.
`video_get`	Статус задачи видео. Когда ролик готов, в ответе ссылка на ресурс с файлом (см. ниже). То же, что `GET /v1/videos/{id}`.
`youtube_transcribe`	Расшифровка (`mode: exact`) или пересказ (`mode: fast`) ролика YouTube по ссылке `url`. То же, что `POST /v1/video/transcriptions`. Списывает деньги.

Ресурсы

URI	Содержимое
`hubris://catalog/models`	Каталог моделей одним JSON-документом.
`hubris://docs/quickstart`	Главная страница быстрого старта.
`hubris://videos/{id}/content`	Готовый ролик задачи видео. Ссылку отдаёт `video_get`, когда ролик готов; файл хранится 72 часа. Ролик больше 25 МБ ресурсом не отдаётся — его скачивают по HTTP: `GET /v1/videos/{id}/content` с тем же ключом.

Промпты

Имя	Что делает
`compare-models`	Принимает `task` — описание задачи своими словами; просит агента подобрать через `models_search` три модели, сравнить цены, контекст и возможности и порекомендовать одну.

Безопасность

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

Создать отдельный ключ для MCP в /keys — это упростит отзыв без затрагивания других интеграций.
При компрометации — немедленно отозвать ключ в кабинете.
Не публиковать конфиг MCP с ключом в открытых репозиториях.

Ключ можно не копировать вовсе: клиенты с поддержкой OAuth (Claude Desktop, Claude.ai, Smithery) проходят авторизацию через браузер — см. OAuth 2.0 + PKCE. Приложению выдаётся отдельный токен с выбранными доступами и дневным лимитом, отзывается в профиле на вкладке «Приложения».

Где ещё найти сервер

Тот же сервер https://api.hubris.pw/mcp опубликован в каталогах MCP — подключение оттуда идёт в один клик, без ручного конфига:

Smithery — установка через OAuth, без ключа в конфиге.
Glama — карточка коннектора с проверкой работоспособности.
Официальный реестр MCP — запись pw.hubris/hubris-mcp, домен подтверждён.
npm: hubris-mcp — для клиентов, которым нужен локальный процесс: npx hubris-mcp поднимает stdio-мост к тому же серверу (ключ — в HUBRIS_API_KEY, см. выше).

Клиенты с автоматическим обнаружением серверов находят его сами, по черновику спецификации MCP Server Cards (SEP-2127): каталог домена https://hubris.pw/.well-known/ai-catalog.json ссылается на карточку сервера https://api.hubris.pw/mcp/server-card — имя, версия, адрес подключения и поддерживаемые версии протокола. Карточка открыта без ключа.

Проверено на MCP Inspector 2.7.0, официальном SDK 1.30.0, hubris-mcp 0.1.1, mcp-remote 0.14.2 и Claude Code 2.1.251, 16 сентября 2026; 14 октября 2026 — 15 инструментов на проде (список, поиск по tool, реранкер, расход) и hubris-mcp 0.2.0; 25 сентября 2026 — Claude Code 2.1.251, Codex CLI 0.144.5, OpenClaw 2026.6.35, Hermes Agent 0.21.5, Gemini CLI 0.61.0, Qwen Code 0.24.5, OpenCode 1.18.32, VS Code 1.138.0 (установка кнопкой и вход по OAuth), claude.ai (кнопка «Подключить к Claude» и вход по OAuth), Cursor (кнопка «Добавить в Cursor» и вход по OAuth).

Что дальше

Страница подключения MCP — кнопки и команды для Claude, ChatGPT, Cursor, OpenClaw, Hermes и других агентов.
Каталог моделей — все активные модели и цены в рублях.
POST /v1/chat/completions — API-референс LLM-запросов.
/keys — управление API-ключами.
Биллинг — пополнение баланса через СБП.

Обновлено: 14 октября 2026 г.

MCP-сервер