MCP

MCP — протокол, по которому агенты (Claude Code, Claude Desktop, Cursor, Cline, OpenClaw и другие) подключают внешние инструменты. Mixen поднимает собственный MCP-сервер в режиме Streamable HTTP: агент получает модели напрямую — спросить текст, сгенерировать картинку, посмотреть каталог и баланс, — не написав ни строчки интеграции.

Подключение

Авторизация — тем же ключом mxn-… (Ключи и аутентификация): скоупы ключа и лимит запросов наследуются.

Claude Code:

claude mcp add --transport http mixen https://api.mixen.ai/v1/mcp \
  --header "Authorization: Bearer mxn-ваш-ключ"

Cursor (.cursor/mcp.json в корне проекта; добавьте файл в .gitignore, чтобы ключ не попал в репозиторий):

{
  "mcpServers": {
    "mixen": {
      "type": "http",
      "url": "https://api.mixen.ai/v1/mcp",
      "headers": {"Authorization": "Bearer mxn-ваш-ключ"}
    }
  }
}

Любой другой MCP-клиент: URL https://api.mixen.ai/v1/mcp, транспорт Streamable HTTP, заголовок Authorization: Bearer mxn-….

Инструменты

Тулза	Что делает
mixen_chat	Спросить текстовую модель: model, prompt, опционально system, reasoning_effort, max_tokens, web_search (auto/native/exa)
mixen_generate_image	Сгенерировать изображение — результат приходит картинкой, агент её «видит»
mixen_list_models	Каталог: id, тип, цены в ₽
mixen_get_balance	Баланс аккаунта
mixen_get_topup_link	Ссылка на пополнение: amount (₽ 10–10000 или $ 1–200 при amount_usd=true), method — tochka/cryptobot/cryptocloud
mixen_list_transactions	Последние транзакции: дата, тип, сумма, модель (limit 1–50, по умолчанию 10)

Агенту достаточно попросить: «спроси у mixen, что нового» или «сгенерируй обложку через mixen» — дальше он сам вызовет тулзы. Кончился баланс — агент сам проверит его mixen_get_balance и выдаст ссылку на пополнение через mixen_get_topup_link, а отчёт о расходах соберёт mixen_list_transactions.

Биллинг и лимиты

Расход идёт с того же баланса, что у бота, кабинета и API; списания видны в GET /v1/history (Токены и списания). Действуют скоупы ключа (ключ только-для-chat не сможет генерировать картинки) и общий лимит запросов — 60 в минуту. Ошибки приходят текстом тулзы: invalid api key, требование пополнения, превышение лимита.

Границы

• Стриминга текста в MCP нет — ограничение протокола, не бэкенда: результат тулзы по спецификации приходит одним сообщением, агенты не рендерят частичный текст (доступны только progress-нотификации). Потоковые дельты — через SSE /v1/chat/completions.
• Видео, музыка, история генераций и файловое хранилище в MCP не вынесены — они доступны по HTTP API.