Picsart GenAI MCP

Picsart MCP 服务器将其可用模型作为 Model Context Protocol 工具公开。将它连接到任何兼容 MCP 的智能体，该智能体就能使用可用模型，通过自然语言或结构化工具调用生成图像、视频和音频。

刚接触 MCP？请先阅读 什么是 MCP？。

所需条件

• 一个 Picsart 账户。智能体首次连接时，你需要在浏览器中登录。
• 账户中有用于生成内容的积分。浏览目录和查询费用均免费。
• 一个支持远程（HTTP）MCP 服务器和 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	单个模型的参数架构（类型、必填项、枚举值、最小值/最大值）	否
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 或内联 data: URI），或使用 files 一次最多保存 10 个。result.url 是可直接传给 imageUrls 的 CDN URL
move	将 itemUids 移动到 targetFolderUid
delete	将 itemUids 软删除到回收站（使用 permanent: true 可彻底删除）
update	为单个文件设置自定义属性（itemUid + attributes）

每项操作都会返回当前文件夹列表，以便 Drive 小组件进行渲染。详情请参阅 文件和 Drive；有关如何先从磁盘获取文件，请参阅本地文件 → 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 → 获取结果（媒体模型默认异步运行）

如果你已经知道模型 ID，可直接跳到 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 均接受一个 image URL，并自动选择合适的模型。传入 model 可覆盖自动选择的模型。

输入参考

picsart_generate 接受以下参数：

• 必填： model（模型 ID）、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。文本模型则会返回生成的文本。

常见问题

使用 MCP 需要 gen-ai CLI 吗？

不需要。MCP 服务器由 Picsart 托管，你的智能体通过 HTTPS 连接到它。CLI 是一个独立的终端工具。只有在你想从 shell 生成内容或使用 Skills 时才需要安装它。

MCP 服务器需要 API 密钥吗？

不需要。你通过智能体使用 Picsart 账户登录，无需复制或轮换任何密钥。

我可以同时使用 MCP 和 CLI 吗？

可以。两者分别登录，但使用同一个 Picsart 账户和同一份积分余额。

智能体已连接，但工具没有显示。

请确认已完成登录，然后重启或重新加载智能体。大多数智能体会在连接时加载工具列表，而不是持续加载。

哪些模型可以通过 MCP 使用？

SDK 目录参考涵盖 252 个模型。MCP 的可用性取决于服务器版本。使用 picsart_model_catalog 或 picsart_list_models 按模式、提供商或用途筛选，也可以浏览模型目录。

生成的文件会保存在哪里？

默认情况下，每个媒体结果也会保存到 Picsart Drive 根目录下的 picsart-genai-mcp 文件夹中。传入 folderUid 可将文件保存到其他位置，传入 "saveToDrive": false 则可跳过保存。使用 picsart_drive 可自行上传 URL 或聊天附件。请参阅文件和 Drive。

如何在运行模型前了解费用？

使用模型 ID 和计划使用的参数调用 picsart_preflight。它会验证载荷并返回积分估算值，而不会运行生成任务。

如果积分余额用完了会怎样？

使用 picsart_credits 查看余额，并在重试前前往 picsart.com 充值。