Beta. Фича стабильна, но набор инструментов и формат ответов могут уточняться по мере фидбэка.

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

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

Каталог моделей с ценой в рублях, фильтрами по capability, цене и длине контекста.
Баланс аккаунта — чтобы агент знал, сколько ему доступно.
Запросы к LLM через chat_complete (полный паритет с /v1/chat/completions).
Готовый prompt compare-models для сравнения моделей под конкретную задачу.

Что такое MCP

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

Hubris реализует MCP через Streamable HTTP transport — единственный URL без дополнительной инфраструктуры.

Требования

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

Подключение

Claude Desktop

Claude Desktop пока не умеет напрямую подключаться к удалённым HTTP-MCP-серверам — он работает только со stdio-серверами. Для подключения к Hubris нужен локальный шим mcp-remote: он стартует как stdio-процесс и проксирует все вызовы на https://api.hubris.pw/mcp.

Не используйте окно «Add custom connector (BETA)» в claude.ai / Claude Desktop. Эта форма рассчитана на сервера с OAuth 2.1 (у Hubris пока Bearer-авторизация), и для произвольных HTTP-MCP-серверов известно падает с ошибкой Couldn't reach the MCP server. … ofid_… ещё до отправки запроса нам — это баг на стороне Anthropic. Подключайтесь только через JSON-конфиг ниже.

Откройте файл конфигурации:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Добавьте секцию mcpServers:

{
  "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-..."
      }
    }
  }
}

Подставьте свой ключ в AUTH_TOKEN (формат: Bearer sk-gw-…). Заголовок в --header передаётся как Authorization:${AUTH_TOKEN} без пробела вокруг двоеточия — это рекомендация mcp-remote из-за особенностей экранирования в некоторых клиентах.

Перезапустите Claude Desktop. В чате появится индикатор подключённого MCP-сервера и список доступных инструментов.

Claude Code

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

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

claude mcp list

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

Любой MCP-клиент с поддержкой Streamable HTTP transport подключается тем же URL и Bearer-ключом. Параметры те же:

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

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

Инструменты

Инструмент	Что делает
`models_list`	Полный каталог активных моделей с курсорной пагинацией.
`models_search`	Поиск по capability (vision / reasoning / tools / web_search / audio / image_gen), цене, длине контекста.
`models_get_pricing`	Тариф конкретной модели в рублях.
`balance_get`	Текущий баланс аккаунта.
`chat_complete`	LLM-запрос к выбранной модели. Полный паритет с `/v1/chat/completions`.

Ресурсы

URI	Содержимое
`hubris://catalog/models`	Каталог моделей одним JSON-документом.
`hubris://docs/quickstart`	Главная страница быстрого старта.

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

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

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

OAuth-авторизация (без копирования ключа в конфиг) — на дорожной карте.

Что дальше

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

Обновлено: 26 мая 2026 г.

MCP-сервер

На этой странице