Picsart GenAI MCP

Сервер Picsart MCP предоставляет полный каталог моделей в виде инструментов Model Context Protocol. Подключите его к любому MCP-совместимому агенту, и этот агент сможет генерировать изображения, видео и аудио с использованием 201 модели с помощью естественного языка или структурированных вызовов инструментов.

Впервые с MCP? Начните с раздела Что такое MCP?.

Предварительные требования

1. Установите CLI gen-ai — см. Установка.
2. Запустите gen-ai login один раз (откроет браузер для OAuth).

На этом всё. MCP-сервер (gen-ai-mcp) поставляется вместе с CLI и использует те же учетные данные.

Подключение к вашему агенту

Claude Code

claude mcp add picsart-gen-ai -- gen-ai-mcp

Затем используйте его в любом разговоре:

«Сгенерируй изображение продукта на белом фоне с помощью Flux 2 Pro, соотношение сторон 4:3».

Полную настройку Claude Code, включая Skills и устранение неполадок, см. в разделе Интеграция с Claude Code.

Cursor

Добавьте следующее в файл конфигурации MCP в Cursor (.cursor/mcp.json или эквивалент):

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

См. Интеграция с Cursor.

Windsurf

Добавьте в конфигурацию MCP в Windsurf:

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

См. Интеграция с Windsurf.

VS Code (Copilot)

Добавьте в .vscode/mcp.json в вашем рабочем пространстве или в пользовательские настройки:

{
  "servers": {
    "picsart-gen-ai": {
      "type": "stdio",
      "command": "gen-ai-mcp"
    }
  }
}

См. Интеграция с VS Code.

Codex (OpenAI)

codex mcp add picsart-gen-ai -- gen-ai-mcp

См. Интеграция с Codex.

ChatGPT и другие MCP-клиенты

См. Интеграция с ChatGPT или официальную страницу на picsart.com/gen-ai-mcp для актуальной конфигурации коннектора.

---

Каталог инструментов

Подключение открывает доступ к инструментам генерации, каталога и Drive, перечисленным ниже, а также к инструментам picsart_media_* для создания видео и изображений из уже имеющихся материалов.

Строите, а не генерируете?

Picsart Media Studio — это коннектор, предназначенный именно для такой работы. Он добавляется и авторизуется отдельно и отлично работает вместе с этим.

Каждый инструмент доступен агенту после подключения. Инструменты, которые не расходуют кредиты, можно вызывать бесплатно сколько угодно раз.

Генерация

Инструмент	Назначение	Расходует кредиты
picsart_generate	Запуск любой модели целиком (изображение / видео / аудио / текст)	да
picsart_remove_bg	Удаление фона изображения	да
picsart_change_bg	Замена фона изображения по текстовому запросу	да
picsart_enhance	Увеличение разрешения / улучшение изображения	да
picsart_vectorize	Преобразование растрового изображения в SVG	да
picsart_music_studio	Открытие Music Studio (музыка / звуковые эффекты / обложка альбома)	нет¹

¹ Открытие студии бесплатно; генерация внутри неё расходует кредиты.

Каталог и стоимость

Инструмент	Назначение	Расходует кредиты
picsart_list_models	Виджет выбора модели — для визуального просмотра пользователем	нет
picsart_model_catalog	Тот же каталог в виде обычных данных для собственных рассуждений агента	нет
picsart_model_params	Схема параметров одной модели (тип, обязательность, enum, мин/макс)	нет
picsart_preflight	Проверка полезной нагрузки параметров и расчёт стоимости в кредитах — один бесплатный пробный запуск	нет
picsart_credits	Текущий баланс кредитов и разбивка по квотам	нет
picsart_job_status	Опрос задания, запущенного через picsart_generate с помощью async: true	нет

Drive

Инструмент	Назначение	Расходует кредиты
picsart_drive	Единая точка входа в Picsart Drive — поведение выбирается параметром action	нет

picsart_drive принимает параметр action; отдельных инструментов Drive для каждой операции нет:

action	Что делает
list	Просмотр папки (folderUid опущен = корень; flat: true перечисляет все файлы)
create_folder	Создание папки (name, необязательный родитель folderUid, description)
upload	Сохранение файла — либо file (вложение из чата), либо url + name (HTTPS-URL или встроенный URI data:). result.url — это CDN-URL, готовый для передачи в imageUrls
move	Перемещение itemUids в targetFolderUid
delete	Мягкое удаление itemUids в корзину (permanent: true для полного удаления)
update	Установка пользовательских атрибутов для одного файла (itemUid + attributes)

Каждое действие возвращает текущий список файлов в папке, чтобы виджет Drive мог отобразить его. Подробности см. в разделе Файлы и Drive, а о том, как получить файл с вашего диска, — в разделе Локальные файлы → URL.

Ни один инструмент не принимает путь к файловой системе

Каждое входное изображение/видео — это URL. Параметра filePath нет нигде в MCP-контракте — см. Локальные файлы → URL для трёх способов, которые действительно работают.

Рекомендуемый порядок генерации

Инструменты спроектированы для последовательного использования. Эта последовательность позволяет избежать неожиданностей:

1. picsart_model_catalog (или picsart_list_models, чтобы пользователь выбрал визуально) → выбор модели
2. picsart_model_params → изучение её входных параметров
3. picsart_preflight → проверка полезной нагрузки и расчёт стоимости одним бесплатным вызовом
4. picsart_generate → непосредственный запуск

Если у вас уже есть идентификатор модели, сразу переходите к picsart_generate.

Примеры вызовов инструментов

Генерация изображения:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting, 4:3",
    "aspectRatio": "4:3",
    "count": 1
  }
}

Генерация видео:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "seedance-2.0",
    "prompt": "a cat skiing down a mountain",
    "duration": 8,
    "aspectRatio": "16:9",
    "generateAudio": true
  }
}

Сначала проверка и расчёт стоимости:

{
  "name": "picsart_preflight",
  "arguments": {
    "model": "veo-3.1",
    "params": { "prompt": "a drone shot over a snowy ridge", "duration": 8, "resolution": "1080p" }
  }
}

Удаление фона:

{
  "name": "picsart_remove_bg",
  "arguments": {
    "imageUrls": ["https://example.com/product.jpg"]
  }
}

Справочник входных параметров

picsart_generate принимает:

• Обязательные: model (идентификатор модели), prompt (текстовый запрос)
• Часто используемые необязательные: aspectRatio, resolution, duration, count (от 1 до 8), quality, style, negativePrompt
• Входное изображение: imageUrls (массив URL — для моделей image-to-image или image-to-video)
• Входное видео: videoUrl (один URL — для моделей video-to-video)
• Генерация аудио: generateAudio (логическое значение — для видеомоделей с поддержкой встроенного аудио)
• Улучшение запроса: enhancePrompt (логическое значение — маршрутизация через LLM перед генерацией)
• Специфичные для модели параметры: extra (объект произвольной формы — используйте picsart_model_params, чтобы узнать, что принимает модель)

Результаты возвращаются в виде results: [{ url, metadata? }]. Ресурсы — это URL, никогда не base64. Каждый результат также содержит resource_link, чтобы агент мог ссылаться на него в последующих вызовах инструментов.

Часто задаваемые вопросы

Требуется ли для MCP-сервера отдельный API-ключ?

Нет. Он использует ту же OAuth-сессию, что и CLI. Запустите gen-ai login один раз; MCP-сервер автоматически подхватит эти учетные данные.

Можно ли использовать MCP и CLI на одной машине одновременно?

Да. Оба используют один и тот же файл учетных данных (~/.gen-ai/credentials.json) и один и тот же баланс кредитов. Параллельная работа допустима.

Агент подключился, но инструменты не отображаются.

Перезапустите агента после добавления MCP-конфигурации. Большинство агентов загружают список инструментов при запуске, а не динамически.

Какие модели работают через MCP?

Все 201 модель из каталога. MCP-специфичного подмножества нет. Используйте picsart_list_models для фильтрации по режиму или провайдеру либо просмотрите Каталог моделей.

Может ли агент сохранять сгенерированные файлы в Drive?

Да. Передайте "saveToDrive": true в аргументах picsart_generate или используйте picsart_drive для загрузки локального файла или URL. См. Файлы и Drive.

Как узнать стоимость модели до её запуска?

Вызовите picsart_preflight с идентификатором модели и параметрами, которые вы планируете использовать. Он проверит полезную нагрузку и вернёт оценку стоимости в кредитах без запуска генерации.

Что произойдёт, если баланс кредитов закончится во время генерации?

Проверьте баланс с помощью picsart_credits и пополните его на picsart.com перед повторной попыткой.