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。」

如需包含 Skills 和疑難排解的完整 Claude Code 設定說明，請參閱 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	在一次免費試執行中驗證 params payload 並估算點數費用	否
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），或一次最多 10 個檔案，使用 files。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 → 在一次免費呼叫中驗證 payload 並估算費用
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 目錄參考涵蓋 251 個模型。MCP 是否提供特定模型，取決於伺服器版本。使用 picsart_model_catalog 或 picsart_list_models 依模式、提供者或用途篩選，或瀏覽模型目錄。

生成的檔案會存放在哪裡？

預設情況下，每個媒體結果也會儲存至您的 Picsart Drive，位於 Drive 根目錄的 picsart-genai-mcp 資料夾中。傳入 folderUid 可將檔案存放在其他位置，或傳入 "saveToDrive": false 停用儲存。使用 picsart_drive 可自行上傳 URL 或聊天附件。請參閱檔案與 Drive。

如何在執行模型前得知費用？

使用模型 ID 和預計使用的參數呼叫 picsart_preflight。它會驗證 payload 並傳回點數估算，不會執行生成。

如果點數用完了會怎樣？

使用 picsart_credits 查看餘額，並在重試前前往 picsart.com 儲值。