Генерация картинок через AI-агента — MCP-сервер InPersona

Подключите Claude, Cursor, Hermes, OpenCode и другие AI-агенты к InPersona по протоколу MCP. Готовые конфиги для каждого клиента, один токен — генерация картинок и видео из чата с агентом.

Зачем подключать InPersona к AI-агенту#

Если вы пишете код или ведёте проект в Claude Code, Cursor, Hermes — изображения и видео InPersona можно генерировать прямо оттуда, не переключаясь в браузер. Агент получает доступ к тем же моделям, которые работают на сайте, и тратит ваши кредиты так, как будто это вы кликаете «Сгенерировать».

Примеры запросов, которые сразу заработают:

  • «Сделай мне три варианта баннера для лендинга — формат 16:9, тёплый свет, минимализм»
  • «Сгенерируй 10-секундное видео — товар на кухонной столешнице»
  • «Покажи сколько у меня кредитов и какие модели сегодня доступны»

Технически — это Model Context Protocol (MCP), открытый стандарт от Anthropic. InPersona поднимает MCP-сервер по адресу https://inpersona.ru/mcp, любой совместимый агент к нему подключается одним конфигом + токеном.

Кому доступно#

MCP-сервер и API-токены работают на тарифах Pro и Бизнес (и у админов InPersona). На бесплатном и Стартовом плане выпуск токенов и обращения к /mcp отключены. Это та же фича api_access, что отображается в списке возможностей тарифа на странице подписки.

При попытке выпустить токен на младшем плане откроется окно апгрейда. Если вы перешли на младший план уже после того, как выпустили токены — токены остаются в списке (их можно отозвать), но новые обращения по ним вернут ошибку forbidden.

Шаг 1 — выпустите токен#

  1. Залогиньтесь на inpersona.ru.
  2. Откройте Настройки → API-токены.
  3. Нажмите Создать токен. Дайте ему имя (например, «Claude Code на ноутбуке») и выберите scope:
    • read — список моделей, статусы задач, баланс кредитов.
    • generate — генерация изображений и видео (тратит кредиты).
    • admin — доступ к админ-эндпоинтам, если у вас роль администратора.
  4. Скопируйте токен формата ips_… — он показывается один раз.

Хранить токен в открытом виде в mcp.json не обязательно — большинство клиентов поддерживают переменные окружения (${env:INPERSONA_TOKEN} или ${INPERSONA_TOKEN}).

Шаг 2 — подключите клиента#

Ниже — рабочие конфиги для популярных агентов. Везде используется HTTP-транспорт (streamable HTTP) — для InPersona не нужен mcp-remote, прокси или OAuth-обвязка.

Claude Code (CLI)#

claude mcp add --transport http inpersona https://inpersona.ru/mcp \
  --header "Authorization: Bearer ips_ваштокен"

После этого в любой сессии Claude Code появятся инструменты generate_image, generate_video, get_credits_balance, list_image_models, list_video_models, get_image_generation, get_video_generation.

Claude Desktop#

Откройте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows. Добавьте:

{
  "mcpServers": {
    "inpersona": {
      "type": "http",
      "url": "https://inpersona.ru/mcp",
      "headers": {
        "Authorization": "Bearer ips_ваштокен"
      }
    }
  }
}

Перезапустите Claude Desktop. Если в вашей версии нет нативного HTTP-транспорта, используйте mcp-remote (см. секцию «Старые клиенты» ниже).

Cursor#

Создайте .cursor/mcp.json в корне проекта (или ~/.cursor/mcp.json глобально):

{
  "mcpServers": {
    "inpersona": {
      "url": "https://inpersona.ru/mcp",
      "headers": {
        "Authorization": "Bearer ips_ваштокен"
      }
    }
  }
}

Откройте Settings → MCP Servers — Cursor подхватит сервер автоматически.

Hermes Agent (Nous Research)#

Hermes ищет конфиг в ~/.hermes/config.yaml:

mcp_servers:
  inpersona:
    url: "https://inpersona.ru/mcp"
    headers:
      Authorization: "Bearer ips_ваштокен"

InPersona работает по статическому Bearer-токену, OAuth-флоу настраивать не нужно (auth: oauth оставьте только для серверов вроде Linear/Sentry).

OpenCode#

В корне проекта добавьте в opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "inpersona": {
      "type": "remote",
      "url": "https://inpersona.ru/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer ips_ваштокен"
      }
    }
  }
}

Goose (Block)#

Запустите goose configure и выберите Add Extension → Remote Extension (Streamable HTTP). Параметры:

  • URI: https://inpersona.ru/mcp
  • Headers: Authorization: Bearer ips_ваштокен
  • Timeout: 60 секунд (генерация может занимать время)

Конфиг ложится в ~/.config/goose/config.yaml — туда же можно вписать руками, если CLI-визарда нет под рукой.

Cline (VS Code)#

Cline нативно поддерживает только stdio и SSE. Для HTTP-MCP подключайтесь через прокси mcp-remote:

{
  "mcpServers": {
    "inpersona": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inpersona.ru/mcp",
        "--header",
        "Authorization: Bearer ips_ваштокен"
      ]
    }
  }
}

GitHub Copilot (VS Code)#

В mcp.json рабочего пространства:

{
  "servers": {
    "inpersona": {
      "type": "http",
      "url": "https://inpersona.ru/mcp",
      "headers": {
        "Authorization": "Bearer ${input:inpersonaToken}"
      }
    }
  },
  "inputs": [
    {
      "id": "inpersonaToken",
      "type": "promptString",
      "description": "InPersona PAT (ips_…)",
      "password": true
    }
  ]
}

Так Copilot не положит токен в коммит — VS Code запросит его один раз и спрячет в Secrets.

Универсальный JSON (Continue, Hyperframes, кастомные агенты)#

{
  "mcpServers": {
    "inpersona": {
      "url": "https://inpersona.ru/mcp",
      "headers": {
        "Authorization": "Bearer ips_ваштокен"
      }
    }
  }
}

Большинство MCP-клиентов читают именно такой формат.

Старые клиенты без HTTP-транспорта#

Если клиент умеет только stdio (старые сборки Claude Desktop, Cline до релиза HTTP), оборачивайте сервер в mcp-remote:

{
  "mcpServers": {
    "inpersona": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://inpersona.ru/mcp",
        "--header",
        "Authorization: Bearer ips_ваштокен"
      ]
    }
  }
}

Что умеет MCP-сервер InPersona#

Семь инструментов, все возвращают валидный JSON-RPC:

  • generate_image — изображения. Обязательный параметр prompt. Опционально generation_model, aspect_ratio (1:1, 16:9, 9:16, 4:3, 3:4, 21:9), resolution (standard / high / ultra), до 14 референс-изображений по URL.
  • generate_video — видео. Операции t2v, i2v, r2v, v2v, frame_to_frame, extend, edit, upscale_video. Параметры duration_seconds, resolution, fps, audio_enabled, negative_prompt, кадры-якоря, референс-видео.
  • get_image_generation / get_video_generation — опрос задачи по id. Возвращают status (pending / processing / completed / failed) и URL результата после completed.
  • list_image_models / list_video_models — каталог доступных моделей и их возможностей (форматы, разрешения, цена в кредитах). Вызывайте один раз в начале сессии — данные стабильны между деплоями.
  • get_credits_balance — общий баланс + разбивка по трём типам кредитов (месячные / переносимые / купленные).

Все генерации асинхронные: тулза возвращает id, агент опрашивает get_*_generation пока статус не станет completed. Так агент не блокирует токены, пока ждёт картинку 40 секунд.

Лимиты и безопасность#

  • На один токен: 240 запросов в минуту на /mcp (с запасом покрывает любую разумную частоту опроса).
  • Тело запроса до 1 МБ — передавайте URL-ы референсов, не base64.
  • Токен можно отозвать в любой момент — Настройки → API-токены, кнопка Отозвать.
  • На сервере хранится только SHA-256 хеш токена. Восстановить утёкший секрет нельзя — выпускайте новый.
  • Если у вас несколько устройств — заведите отдельный токен на каждое (так видно по last_used_at, кто чем пользуется, и отзыв одного не ломает остальные).
  • Подписочные модели и высокое разрешение работают через MCP так же, как из веб-приложения: фича-гейт у токена тот же, что у вас в личном кабинете.

Известные ограничения v1#

  • Сервер stateless — нет SSE-стрима с прогрессом, только id + поллинг.
  • OAuth 2.1 пока не настроен. Если ваш клиент требует именно OAuth (а не статический Bearer), оборачивайте через mcp-remote.
  • Inline media (base64 в data: URL) не поддерживается — провайдеры на бэкенде не принимают, лимит 1 МБ всё равно не пустит.

Что дальше#