Picsart GenAI MCP

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

Впервые знакомитесь с MCP? Сначала прочитайте Что такое MCP?.

Что вам понадобится

• Аккаунт Picsart. При первом подключении агента войдите в него в браузере.
• Кредиты на этом аккаунте для генерации. Просматривать каталог и узнавать стоимость можно бесплатно.
• Агент с поддержкой удалённых MCP-серверов (HTTP) с входом через OAuth. Такая поддержка есть в Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT и Gemini CLI.

Вот и всё. Сервер размещён на стороне Picsart, поэтому устанавливать что-либо на компьютер не нужно. Для работы с MCP вам не нужны gen-ai CLI, gen-ai login или API-ключ.

Адрес сервера:

https://api.picsart.com/gen-ai/mcp

Как работает вход

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

Если срок действия сеанса истёк, переподключите сервер или пройдите аутентификацию заново в настройках MCP или подключений агента. Инструкции приведены в каждом руководстве по интеграции.

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

Claude (веб-версия и приложение для компьютера)

Перейдите в Settings → Connectors → Add custom connector, вставьте https://api.picsart.com/gen-ai/mcp и войдите в Picsart в открывшемся окне. Если у вас тариф Claude Team или Enterprise, владелец организации может добавить подключение для всех пользователей.

Claude Code

claude mcp add --transport http picsart-gen-ai https://api.picsart.com/gen-ai/mcp

Затем в Claude Code выполните /mcp, выберите picsart-gen-ai и нажмите Authenticate, чтобы войти. Используйте его в любом диалоге:

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

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

Cursor

Добавьте следующий фрагмент в .cursor/mcp.json в проекте или в ~/.cursor/mcp.json, чтобы он применялся ко всем проектам:

{
  "mcpServers": {
    "picsart-gen-ai": {
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

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

Windsurf

Добавьте в mcp_config.json (откройте его через меню ... в Cascade → Open MCP config file):

{
  "mcpServers": {
    "picsart-gen-ai": {
      "serverUrl": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

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

VS Code (Copilot)

Добавьте в .vscode/mcp.json в рабочей области или в пользовательскую конфигурацию MCP:

{
  "servers": {
    "picsart-gen-ai": {
      "type": "http",
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

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

Codex (OpenAI)

codex mcp add picsart-gen-ai --url https://api.picsart.com/gen-ai/mcp
codex mcp login picsart-gen-ai

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

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

Добавьте подключение (иногда оно называется удалённым или пользовательским MCP-сервером), указав адрес выше, и выберите OAuth в качестве метода аутентификации. См. Интеграция с ChatGPT и полный список интеграций.

---

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

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

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

Picsart Media Studio — подключение для таких задач. Его нужно добавить и авторизовать отдельно; оно отлично работает вместе с этим подключением.

После подключения агенту доступны все инструменты. Вызовы инструментов, не расходующих кредиты, бесплатны и могут выполняться сколько угодно раз.

Генерация

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

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

Инструмент	Назначение	Расходует кредиты
picsart_list_models	Виджет выбора модели для визуального просмотра пользователем	нет
picsart_model_catalog	Тот же каталог в виде обычных данных для анализа агентом	нет
picsart_model_params	Схема параметров одной модели (тип, обязательность, enum, min/max)	нет
picsart_model_choice	Показать пользователю короткий список моделей-кандидатов в виде карточек для выбора	нет
picsart_preflight	Проверить параметры и рассчитать стоимость в кредитах за один бесплатный пробный запуск	нет
picsart_credits	Текущий баланс кредитов и разбивка квот	нет
picsart_job_status	Проверить состояние задачи, запущенной с помощью picsart_generate	нет
picsart_render_monitor	Панель текущего хода выполнения для пакета запущенных генераций	нет

Просмотр

Инструмент	Назначение	Расходует кредиты
picsart_view_image	Позволить агенту просмотреть до 6 изображений, размещённых на Picsart, чтобы оценить результат или описать референс	нет

Drive

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

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

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

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

Творческие доски и создание медиа

Некоторые инструменты открывают в диалоге интерактивную панель вместо текстового ответа: например, консоль настройки фильма, доску списка кадров, доску проверки ресурсов, консоль настройки анимации и редактор сцен. Они помогают выполнять многоэтапные проекты, например создавать короткометражный фильм или видео с моушн-дизайном. Инструменты picsart_media_* (загрузка, шаблоны сцен, субтитры, транскрибация, изменение кадрирования, экспорт) относятся к тому же семейству, которое описано в разделе Media Studio → Возможности. Агент обнаруживает их автоматически — вызывать их по имени не нужно.

Инструменты не принимают пути к файлам

Все изображения и видео передаются по URL. В контракте MCP нигде нет параметра filePath. См. раздел Локальные файлы → URL, где описаны подходящие способы.

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

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

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

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

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

Создать изображение:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting",
    "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": {
    "image": "https://example.com/product.jpg"
  }
}

Инструменты picsart_remove_bg, picsart_change_bg, picsart_enhance и picsart_vectorize принимают по одному URL image и автоматически выбирают подходящую модель. Передайте model, чтобы выбрать другую модель.

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

Инструмент picsart_generate принимает:

• Обязательные: model (идентификатор модели), prompt (текстовый запрос)
• Часто используемые необязательные: aspectRatio, resolution, duration, count (от 1 до 10), quality, style, negativePrompt
• Входное изображение: imageUrls (массив URL для моделей преобразования изображения в изображение или видео)
• Входное видео: videoUrl (один URL для моделей преобразования видео в видео)
• Генерация аудио: generateAudio (логическое значение для видеомоделей с поддержкой встроенного аудио)
• Улучшение запроса: enhancePrompt (логическое значение; перед генерацией запрос обрабатывается через LLM)
• Drive: saveToDrive (по умолчанию true) и folderUid (папка Drive для сохранения результата)
• Асинхронный режим: async (для всех медиа-моделей по умолчанию используется true: вызов сразу возвращает идентификатор задачи, а агент опрашивает picsart_job_status, чтобы получить результат)
• Параметры модели: extra (объект произвольной структуры; используйте picsart_model_params, чтобы узнать, какие параметры принимает модель)

Готовые результаты возвращаются в виде assets: [{ id, type, url, ... }], а для каждого файла также предоставляется resource_link, чтобы агент мог ссылаться на него в последующих вызовах инструментов. Ресурсы передаются по HTTPS URL, а не в формате base64. Текстовые модели возвращают сгенерированный текст.

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

Нужен ли gen-ai CLI для работы с MCP?

Нет. Сервер MCP размещён на стороне Picsart, и агент подключается к нему по HTTPS. CLI — отдельный инструмент для терминала. Устанавливайте его, только если хотите генерировать из командной строки или использовать Skills.

Требуется ли серверу MCP API-ключ?

Нет. Вы входите через агента с помощью аккаунта Picsart. Копировать или обновлять ключ не нужно.

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

Да. Вход в них выполняется отдельно, но оба используют один аккаунт Picsart и общий баланс кредитов.

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

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

Какие модели доступны через MCP?

В справочнике SDK указана 251 модель. Доступность в MCP зависит от версии сервера. Используйте picsart_model_catalog или picsart_list_models, чтобы отфильтровать модели по режиму, провайдеру или назначению, либо просмотрите Каталог моделей.

Куда сохраняются созданные файлы?

По умолчанию каждый результат генерации медиа также сохраняется в Picsart Drive, в папке picsart-genai-mcp в корне Drive. Передайте folderUid, чтобы сохранить файл в другом месте, или "saveToDrive": false, чтобы не сохранять его. Используйте picsart_drive, чтобы самостоятельно загрузить URL или вложение из чата. См. раздел Файлы и Drive.

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

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

Что произойдёт, если кредиты закончатся?

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