Artillect MCP

Подключите генерацию изображений, видео, аудио и 3D, upscale и chat в Codex, ChatGPT, Claude, Cursor, Hermes и любом MCP-клиенте. Один URL, OAuth или API-ключ, тот же баланс что в Studio.

Публичная бета

MCP-сервер в публичной бете. У агента есть бесплатный инструмент submit_feedback — если какой-то тул повёл себя не так, описание ввело в заблуждение или чего-то не хватило, он может прислать отчёт прямо из диалога, и этот отчёт дойдёт до нас. Просите агента сообщать о проблемах: так они чинятся быстрее всего. Вопросы живого человека — по-прежнему через форму обратной связи.

Seedance 2.5: формат видео

В generate_video для модели seedance-2.5 можно передать output_format: mp4 (по умолчанию, компактный и широко совместимый) или mov (выше битрейт для монтажа, файл больше). Та же настройка доступна в estimate; для остальных моделей параметр не поддерживается.

generate_video({
  model: "seedance-2.5",
  prompt: "cinematic product shot",
  output_format: "mov"
})

Gemini Omni Flash 1.1: мультимодальное видео

В generate_video модель gemini-omni-flash-11 поддерживает text-to-video, frame-to-video, first-and-last-frame и reference-to-video. Кадры и references взаимоисключающие; в reference-to-video можно передать до 7 image references, один video clip. Общая quota считается как images + 2 × video и не должна превышать 7.

Для video reference clip — максимум 10 секунд и 100 MB. Доступны duration 4|6|8|10, resolution 360p|720p|1080p|4k и aspect_ratio 16:9|9:16. Цена зависит от duration, resolution и наличия video input; оценку можно получить через estimate.

generate_video({
  model: "gemini-omni-flash-11",
  prompt: "cinematic product reveal",
  reference_images: ["https://example.com/reference.png"],
})

Примерка одежды

В generate_image используйте model: "google-virtual-try-on" и ровно два input_urls: сначала человек, затем вещь. n / num_images — 1–4; промпт не нужен. Цена — 8 токенов за результат.

Meta Muse Image

В generate_image используйте model: "muse-image". Без input_urls это text-to-image, с 1–10 входами — edit. Доступны n / num_images 1–10, девять aspect ratios, output_format jpeg|png|webp и sync_mode; цена — 1 токен за картинку.

MiniMax H3 Max

Для generate_video доступны текстовый, frame-to-video и reference-to-video режимы модели minimax-h3-max: без медиа — t2v, с первым кадром — i2v, с первым и последним — flf2v, с image/video/audio references — ref2v. Кадры и references взаимоисключающие; последний кадр без первого не поддерживается. В ref2v нужен хотя бы image или video, audio не может быть единственным reference; максимум 12 файлов суммарно.

Параметры: resolution 480P|768P, duration 5–15, aspect_ratio adaptive|21:9|16:9|4:3|1:1|3:4|9:16, seed, prompt_expansion_mode disabled|balanced|quality, enable_safety_checker и sync_mode. Последний параметр возвращает base64 вместо CDN URL; он доступен в MCP, но не нужен обычному Studio submit.

Быстрое подключение

Это MCP-сервер, а не веб-страница. Скопируйте URL и добавьте его в своём клиенте — подключение и OAuth всегда делает человек (агент не может вписать коннектор сам).

URL

https://app.artillect.pro/mcp

Claude Desktop / claude.ai: Settings → Connectors → Add custom connector → вставьте URL → Authenticate.
Claude Code (CLI): claude mcp add --transport http artillect https://app.artillect.pro/mcp → /mcp → Authenticate.
Codex / Cursor / Hermes: см. свой раздел ниже (Streamable HTTP + OAuth).

После подключения наберите /mcp__artillect__quickstart (Claude) или попросите агента вызвать get_started — дальше он сам пойдёт по циклу generate → get_task.

Remote URL

URL

https://app.artillect.pro/mcp

Codex Desktop

Это MCP endpoint, а не обычная веб-страница. Transport — Streamable HTTP.

Settings → MCP servers → Add server
URL: https://app.artillect.pro/mcp, затем сохраните сервер
Нажмите Authenticate и завершите OAuth в браузере
После подключения перезапустите Codex или откройте новую задачу
Проверьте сервер через /mcp, затем дайте агенту первый запрос ниже
Inline image content в результате get_task уже считается доставкой. Если у Codex есть writable workspace, дополнительно скачайте каждый media_url, проверьте файл и укажите абсолютный локальный путь; для video/audio/mesh дайте все ссылки явно.

Первый запрос агенту

Вызови Artillect get_started, затем get_balance. Для генерации используй generate_image, возьми task_id/poll_args из ответа и вызывай get_task до done: true и непустого media_urls. После этого покажи каждый результат: inline image content уже считается доставкой; если есть writable workspace, дополнительно скачай каждый media_url, проверь файл и укажи абсолютный локальный путь. Для video/audio/mesh дай все ссылки явно. Не показывай результат только если я явно это попросил.

ChatGPT Web / Work

После публикации в ChatGPT MCP подключается через установленный плагин Artillect и его OAuth. Добавление URL в локальные настройки Codex Desktop не подключает этот сервер к ChatGPT Web. В рабочем workspace доступность и установка плагина могут контролироваться администратором.

Если плагин уже опубликован или установлен в workspace, выберите Artillect
Завершите OAuth-связывание аккаунта
В новом чате попросите вызвать get_started

Claude (Connectors)

Settings → Connectors → Add custom connector
Name: Artillect, URL: выше
Authenticate (OAuth, scope mcp) или Bearer art_…
Спросите: «сгенерируй картинку…» / «видео…» — агент вызовет tools и поллит get_task

Или наберите слэш-команду /mcp__artillect__quickstart — холодный агент сразу вызовет get_started и пойдёт по каноническому циклу. Есть также /mcp__artillect__generate_image и /mcp__artillect__character_video.

Claude Code (CLI)

Один терминальный вызов добавляет remote MCP через HTTP transport:

Add server

claude mcp add --transport http artillect https://app.artillect.pro/mcp

Выполните команду выше
В сессии наберите /mcp → выберите artillect → Authenticate (OAuth в браузере, scope mcp)
Стартуйте с слэш-команды /mcp__artillect__quickstart (или дайте первый запрос ниже)

Первый запрос агенту

Вызови Artillect get_started, затем get_balance. Для генерации используй generate_image, возьми task_id/poll_args из ответа и вызывай get_task до done: true и непустого media_urls. После этого покажи каждый результат: inline image content уже считается доставкой; если есть writable workspace, дополнительно скачай каждый media_url, проверь файл и укажи абсолютный локальный путь. Для video/audio/mesh дай все ссылки явно. Не показывай результат только если я явно это попросил.

Cursor

Remote MCP (рекомендуется). Вставьте в MCP settings / mcp.json:

mcp.json snippet

{
  "mcpServers": {
    "artillect": {
      "url": "https://app.artillect.pro/mcp"
    }
  }
}

Хост откроет OAuth (IdP поддерживает Dynamic Client Registration + PKCE). Альтернатива: stdio + ARTILLECT_API_KEY. Агент: сначала get_started (рецепты + дефолты). Resource artillect://agent/recipes. Remote upload: upload_file с публичным HTTPS url (/api/v1/files/from-url), create_upload_url + PUT + finalize_upload (image/audio), или file_base64 + filename (у hosted нет клиентского диска; file_path — только stdio). get_task — wait_sec (рекомендуем 60 + повтор, max 300). Это единственный polling-инструмент для всех модальностей — kind выводится из task_id. Канонический идентификатор — task_id; id и taskId оставлены как aliases. list_models по умолчанию slim; каждая модель несёт parameters — машиночитаемые допустимые значения (aspect_ratio / resolution / quality / output_format / …), не надо угадывать (detail: full добавляет aliases и остальное). Лимит prompt также приходит как max_prompt_chars; для chat-моделей доступны context_length_tokens, provider_max_output_tokens, max_input_chars и max_output_tokens. У seedance-2.5 prompt максимум около 40 000 символов (оценка для лимита провайдера 10 000 токенов). Медиа — тот же MinIO/S3, что Studio; дверь агента — /api/v1/files/* (API key / OAuth), не Studio session multipart.

Hermes Agent

OAuth без API-ключа (рекомендуется). Первичный логин — в интерактивном терминале у человека: агент в неинтерактивном шелле не может открыть браузер. После логина перезапустите приложение Hermes — tools подхватываются на старте (mcp_artillect_*).

OAuth

hermes mcp add artillect --url https://app.artillect.pro/mcp --auth oauth
hermes mcp login artillect

В своём терминале: команды выше → браузер IdP → согласие (scope mcp)
Проверка: hermes mcp list / hermes mcp test artillect
Рестарт Hermes (или reload MCP, если есть в UI)
В новой сессии: сначала get_started, затем generate_* → get_task

Токен протух: снова hermes mcp login artillect. Альтернатива — hermes mcp add … --auth header с ключом art_… с /api. Не вставляйте ключ в чат агенту без необходимости.

Батчи: не слать много generate_* параллельно — выдерживайте минимум 0.5 с между submit на ключ (429 + retry_after_sec). media_urls — только наш MinIO (app.artillect.pro/…/media/download), не CDN провайдера.

Что умеет агент

Генерация: generate_image / generate_video / upscale / SwitchX → get_task
Аудио и 3D: generate_audio / generate_mesh → poll через get_task; перед submit используйте estimate.
Проекты и Element Library: list_projects, list_project_elements, create_image_element / create_video_element / create_project_element (image/video элементы; @name или element_names в image/video submit; native Kling и pseudo-element модели)
Каталог и баланс: list_models, recommend_model, get_balance, estimate
Chat и project operations: chat_completion, server-side conversations, tags, likes, favorites, copy/move/delete и управление участниками проекта.
Webhooks: upsert_webhook / list_webhook_deliveries (публичный HTTPS callback)
Media editing: edit_media / get_media_operation / cancel_media_operation видны в MCP, но сейчас помечены WIP и в production возвращают MEDIA_OPERATIONS_WIP.

Wan 3 и Wan 3 Prime

В generate_video доступны модели wan-30 и wan-30-prime. Это единый мультимодальный контракт: текст, first/last frame, до 10 image refs, до 5 video refs, до 5 audio refs, либо один документ reference_file_urlsили одна публичная страница reference_link_urls. Документ и страница, а также frames и refs, взаимоисключающие.

Параметры: resolution 480P|720P|1080P, aspect_ratio adaptive|16:9|4:3|1:1|3:4|9:16, duration 2–30 или -1, audio, seed 0–2147483647 и nsfw_checker. У video refs каждый клип 1–15 секунд, суммарно не более 15 секунд и input+output не более 30 секунд. Полная схема приходит из list_models; сервер валидирует лимиты до списания.

FLUX Video Upscale

В generate_upscale укажите model: "flux-video-upscale", video_url и параметры upscale_factor 1.5–3, creativity 0/1, необязательный prompt и safety_tolerance 0–4. Видео — до 20 секунд и 50 MB; стоимость считается по разрешению результата и режиму.

Доставка результата в чат (по умолчанию)

done: true означает завершение генерации, но не доставки. В Codex Desktop и других coding-host с shell агент обязан скачать каждый файл в writable workspace, проверить его и встроить в финальный ответ абсолютным локальным путём. Все URL из media_urls, не только первый. Не слать в чат — только если пользователь явно попросил не показывать результат.

Completed images по умолчанию также приходят как typed MCP image content (до 4 файлов по 5 MiB), а каждый результат — как typed resource link. Для host без клиентского shell это основной канал вместе с MCP Apps preview. Если видимое вложение невозможно, все media_urls можно дать как явно помеченный деградированный fallback, не утверждая, что inline-доставка подтверждена. Видео из-за размера остаётся resource link / URL.

Directory listing (Claude / Cursor)

Для Claude / Cursor hosted MCP готов к подаче в каталоги: OAuth + PRM, tool title и annotations (readOnlyHint / destructiveHint). Саму заявку в Anthropic / Cursor отправляет человек — агент не может «влистить» сервер автоматически.

Для публикации плагина в ChatGPT остаётся auth-runtime follow-up: объявить OAuth securitySchemes у каждого tool и возвращать mcp/www_authenticate с error и error_description из tool-level challenge. Текущий Bearer gate корректно даёт server-level 401, но останавливает запрос до tool handler.

MCP URL: https://app.artillect.pro/mcp
Privacy (для ревьюеров): https://app.artillect.pro/privacy
Test account: API-ключ art_ через /api. Секреты в заявку не класть. Владелец review-аккаунта — Rustam.
Docs для скринов: эта страница · /docs/use-cases · /docs/features

Ops checklist (человек)

Live QA: Claude custom connector + Cursor URL
Claude Connectors Directory: admin-settings/directory/submissions/new (нужен Owner на Team/Enterprise org). Поля: MCP URL https://app.artillect.pro/mcp, OAuth, privacy, docs /docs/mcp, test credentials (не в git)
Cursor plugins / MCP listing — если актуально
Записать дату + ticket IDs в plans/156-mcp-directory-s57.md и APP_HEALTH S57

Биллинг

generate_* и chat_completion списывают токены с того же баланса, что Studio. Сначала get_balance / estimate. Ключи: /api.

Без project_id используется личный проект и ваш баланс. Для своего проекта результат тот же. В общем проекте участник обязан передать billing_source: self списывает его собственный баланс, а owner — баланс владельца проекта с проверкой роли и лимита. Неверное или пропущенное значение в общем проекте возвращает ошибку до генерации.

Use cases (UGC / overnight): /docs/use-cases · brief #for-agents · механика /docs/features

Interactive API: /docs · CLI: /docs/cli · Human guide

Ops (вручную): QA Claude custom connector → Cursor URL → Hermes mcp login → опционально Claude directory / Cursor plugins listing.