# Для AI-ассистентов / MCP

> Подключите МиксМедиа к Claude, ChatGPT, Cursor и другим AI-ассистентам по MCP: модели, точные цены и генерация.

MCP-сервер МиксМедиа: `https://api.mixmedia.tech/mcp` (Streamable HTTP).

| Инструмент | Ключ | Что делает |
|---|---|---|
| `list_models` | не нужен | Модели и цены, фильтр по категории (image, video) |
| `get_model` | не нужен | Параметры модели и правила цены |
| `calculate_price` | не нужен | Точная цена в $ и ₽ для модели и параметров |
| `create_generation` | нужен | Запуск генерации, цена списывается с баланса как в createTask |
| `get_generation` | нужен | Статус и ссылки на результат |
| `get_balance` | нужен | Баланс аккаунта |

Ключ создаётся в [Кабинете → API-ключи](https://mixmedia.tech/cabinet/keys) и передаётся заголовком `Authorization: Bearer <API_KEY>` в настройках клиента. Без ключа доступны модели и цены.

## Cursor

Файл `~/.cursor/mcp.json` (или `.cursor/mcp.json` в проекте):

```json
{
  "mcpServers": {
    "mixmedia": {
      "url": "https://api.mixmedia.tech/mcp",
      "headers": {
        "Authorization": "Bearer sk-aim-..."
      }
    }
  }
}
```

## Claude Desktop

Файл `claude_desktop_config.json` (Настройки → Developer → Edit Config). Нужен Node.js:

```json
{
  "mcpServers": {
    "mixmedia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.mixmedia.tech/mcp",
        "--header",
        "Authorization: Bearer sk-aim-..."
      ]
    }
  }
}
```

Только модели и цены, без ключа: Настройки → Connectors → Add custom connector → URL `https://api.mixmedia.tech/mcp`.

## Claude Code

```bash
claude mcp add --transport http mixmedia https://api.mixmedia.tech/mcp \
  --header "Authorization: Bearer sk-aim-..."
```

## ChatGPT

Настройки → Приложения и коннекторы → Расширенные → режим разработчика → Создать коннектор: URL `https://api.mixmedia.tech/mcp`, авторизация — без авторизации. ChatGPT сможет подобрать модель и посчитать точную цену.

## Другие клиенты

Любой клиент с поддержкой удалённого MCP (Streamable HTTP): адрес `https://api.mixmedia.tech/mcp`, при необходимости заголовок `Authorization: Bearer <API_KEY>`.

## Файлы для AI и разработчиков

- [llms.txt](https://mixmedia.tech/llms.txt) и [llms-full.txt](https://mixmedia.tech/llms-full.txt) — что такое МиксМедиа, модели и цены одним текстом
- [prices.json](https://mixmedia.tech/prices.json) — цены всех моделей в $ и ₽ и правила расчёта (то же: `https://api.mixmedia.tech/v1/pricing`)
- [Калькулятор цены](https://api.mixmedia.tech/v1/pricing/calculate?model=seedance-2.0&resolution=720p&duration=5) — точная цена без ключа: `GET https://api.mixmedia.tech/v1/pricing/calculate?model=…&resolution=…&duration=…`
- [openapi.json](https://api.mixmedia.tech/openapi.json) — описание API в формате OpenAPI 3.1

> Ключ передавайте только в настройках клиента, не в чате. `create_generation` списывает деньги так же, как обычный запрос к API: ассистент должен сначала показать цену и получить ваше подтверждение.