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.

Каскад моделей: делегирование

mixen_chat — способ получить любую модель каталога внутри одной сессии, даже если ведущий агент ограничен своим семейством (Claude Desktop, например, держит сессию только на Claude-моделях). Паттерн «дорогой ведущий + дешёвые исполнители»:

• модель — параметр каждого вызова: mixen_chat с z-ai/glm-5.3-flash (0.50 ₽ за 1M входа) переведёт и классифицирует, с deepseek/deepseek-v4-pro — разберёт код, с google/gemini-4-argon — порассуждает;
• список доступных и цены — не хардкод: mixen_list_models отдаёт живой каталог, агент может вызвать его и выбрать модель по цене на лету («выбери дешевле 1 ₽ за 1M входа и переведи текст»);
• чтобы агент делегировал сам, без напоминаний, — зафиксируйте правило в проекте (CLAUDE.md / AGENTS.md / правила воркспейса): «рутину делегируй в mixen_chat с z-ai/glm-5.3-flash, картинки — mixen_generate_image». Готовый CLAUDE.md в корень воркспейса (Claude Desktop — вкладка Code; глобально для всех проектов — ~/.claude/CLAUDE.md):

- Рутинные текстовые задачи (перевод, классификация, черновики, разбор тикетов)
  делегируй в mixen_chat с моделью z-ai/glm-5.3-flash — не отвечай на них сам.
- Картинки генерируй через mixen_generate_image с моделью recraft/recraft-v4.1-flash.

Модель в правиле — обычный id из каталога; поменяете на другую (например openai/gpt-6-luna для текста, black-forest-labs/flux-3-image-klein для картинок) — агент послушается с новой сессии.

Правила + память + задачи: CLAUDE.md / MEMORY.md / TODO.md

CLAUDE.md — единственный файл, который движок читает сам; память и задачи удобно вынести рядом и подключить @-импортом (вложенность до 5 уровней). Это механизм агента-хоста (Claude Code и вкладка Code в Claude Desktop), не нашего MCP: у Codex CLI тот же приём ляжет в AGENTS.md, у других клиентов — в их файлы правил:

CLAUDE.md

- Рутинные текстовые задачи (перевод, классификация, черновики) делегируй
  в mixen_chat с моделью z-ai/glm-5.3-flash — не отвечай на них сам.
- Картинки генерируй через mixen_generate_image с моделью recraft/recraft-v4.1-flash.
- Явная просьба в чате (названная модель или «ответь сам») всегда важнее этого правила.
- Выполненное из TODO.md вычёркивай, новые договорённости и факты дописывай:
  задачи — в TODO.md, знания — в MEMORY.md.

@MEMORY.md
@TODO.md

MEMORY.md — накопленные факты (межчата-память: каждый новый чат читает их):

- Доставка цветов: только Москва в пределах МКАД, утром до 11:00;
  поставщик — оранжерея «Садовый», только местные цветы.

TODO.md — живой список задач:

- [ ] Придумать 5 названий для сервиса доставки
- [x] Сгенерировать логотип 1:1

Диалоги между чатами не перетекают — файлы и есть общая память. Говорите агенту «запиши в MEMORY.md, что…» или «выполни первый пункт из TODO.md и вычеркни» — он отредактирует файлы, и следующий чат продолжит с того же места. Модель можно называть и разговорно: пусть GPT-6 Luna придумает… — имена есть в mixen_list_models.

Картинки — тот же приём: Claude в сессии сам не генерирует изображения, а mixen_generate_image вернёт результат, который агент «видит» и использует дальше.

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

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

Границы

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