Picsart GenAI MCP

公式

150以上のモデルを使用したAI動画、画像、音声生成

Picsart GenAI MCPで何ができますか？

メディアを生成 — picsart_generate を使って、選択したモデルでプロンプトから画像、動画、または音声を作成するようエージェントに依頼します。
先に料金を見積もる — picsart_preflight を使った無料のドライラン1回で、モデルのパラメーターを検証し、クレジットの見積もりを取得します。
画像を編集 — picsart_remove_bg を使って画像URLの背景を削除するか、画像を変更、補正、ベクター化します。
モデルを閲覧 — 利用可能なモデルを一覧表示し、生成前にモデルのパラメータースキーマを確認します。
Driveファイルを管理 — picsart_drive のアクションを通じて、Picsart Drive内のファイルをアップロード、一覧表示、移動、または削除します。

ドキュメント

Picsart MCP サーバーは、利用可能なモデルを Model Context Protocol ツールとして公開します。MCP 対応のエージェントに接続すると、そのエージェントは自然言語または構造化されたツール呼び出しを使って、利用可能なモデルで画像、動画、音声を生成できます。

MCP を初めて使いますか？まず What is MCP? をご覧ください。

必要なもの

Picsart アカウント。エージェントが初めて接続するときに、ブラウザーでサインインします。
生成に使う、そのアカウントのクレジット。カタログの閲覧と料金の見積もりは無料です。
OAuth サインインに対応したリモート（HTTP）MCP サーバーをサポートするエージェント。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（Web およびデスクトップ）

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 integrationをご覧ください。

Cursor

プロジェクト内の .cursor/mcp.json、またはすべてのプロジェクトに適用する場合は ~/.cursor/mcp.json に、次の内容を追加します。

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

Cursor integrationをご覧ください。

Windsurf

mcp_config.json に追加します（Cascade の ... メニューから Open MCP config file を選択して開きます）。

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

Windsurf integrationをご覧ください。

VS Code（Copilot）

ワークスペースの .vscode/mcp.json またはユーザーの MCP 設定に追加します。

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

VS Code integrationをご覧ください。

Codex（OpenAI）

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

Codex integrationをご覧ください。

ChatGPT およびその他の MCP クライアント

上記のアドレスを使ってコネクター（リモートまたはカスタム MCP サーバーと呼ばれることもあります）を追加し、認証方法として OAuth を選択します。ChatGPT integrationおよび連携一覧をご覧ください。

ツールカタログ

接続すると、以下の生成、カタログ、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`	1 つのモデルのパラメータースキーマ（型、必須、列挙値、最小値 / 最大値）	いいえ
`picsart_model_choice`	ユーザーがカードから選べる候補モデルの短いリストを表示	いいえ
`picsart_preflight`	パラメーターのペイロードを検証し、無料のドライランでクレジット料金を見積もり	いいえ
`picsart_credits`	現在のクレジット残高とクォータの内訳	いいえ
`picsart_job_status`	`picsart_generate` で開始したジョブの状態を確認	いいえ
`picsart_render_monitor`	実行中の生成バッチのライブ進捗パネル	いいえ

表示

ツール	用途	クレジットを消費
`picsart_view_image`	エージェントが結果を評価したり参照画像を説明したりできるよう、Picsart がホストする画像を最大 6 枚表示	いいえ

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`	1 つのファイルにカスタム属性を設定（`itemUid` + `attributes`）

すべての操作は現在のフォルダー一覧を返すため、Drive ウィジェットで表示できます。詳しくは Files & Driveをご覧ください。また、ファイルを最初にディスクから取り出す方法については Local files → URLsをご覧ください。

クリエイティブボードとメディア制作

一部のツールはテキストで応答する代わりに、会話内でインタラクティブなパネルを開きます。たとえば、映画のセットアップコンソール、ショットリストボード、アセットレビューボード、モーションセットアップコンソール、シーンエディターなどです。短編映画やモーションデザイン動画など、複数の手順を要するプロジェクトをガイドします。picsart_media_* ツール（アップロード、シーンテンプレート、字幕、文字起こし、リフレーミング、エクスポート）は、Media Studio → What you can doに記載されているものと同じツール群です。エージェントがすべて自動的に検出するため、ツール名を指定して呼び出す必要はありません。

ツールはファイルシステムのパスを受け付けません

画像 / 動画の入力はすべてURLです。MCP コントラクトには filePath パラメーターはありません。実際に使えるパスについては、Local files → URLsをご覧ください。

ツール呼び出しの例

画像を生成する：

{
  "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 を 1 つ受け取り、適切なモデルを自動的に選択します。モデルを指定するには 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 はターミナル用の別ツールです。シェルから生成する場合や Skills を使う場合にのみインストールしてください。

MCP サーバーには API キーが必要ですか？

いいえ。エージェントを通じて Picsart アカウントにサインインします。コピーやローテーションが必要なキーはありません。

MCP と CLI を同時に使えますか？

はい。それぞれ別にサインインしますが、同じ Picsart アカウントとクレジット残高を使用します。

エージェントは接続済みですが、ツールが表示されません。

サインインが完了していることを確認してから、エージェントを再起動するか再読み込みしてください。ほとんどのエージェントは、接続時にツール一覧を読み込み、継続的には読み込みません。

MCP で使えるモデルはどれですか？

SDK カタログのリファレンスには 252 個のモデルが掲載されています。MCP で利用できるモデルはサーバーのバージョンによって異なります。picsart_model_catalog または picsart_list_models を使ってモード、プロバイダー、用途で絞り込むか、Model Catalogをご覧ください。

生成したファイルはどこに保存されますか？

デフォルトでは、各メディアの結果は Picsart Drive のルートにある picsart-genai-mcp フォルダーにも保存されます。別の場所に保存するには folderUid を渡し、保存をスキップするには "saveToDrive": false を渡します。picsart_drive を使うと、URL やチャットの添付ファイルを自分でアップロードできます。Files and Driveをご覧ください。

実行前にモデルの料金を確認するにはどうすればよいですか？

モデル ID と使用予定のパラメーターを指定して picsart_preflight を呼び出します。生成を実行せずにペイロードを検証し、クレジットの見積もりを返します。

クレジット残高がなくなるとどうなりますか？

picsart_credits で残高を確認し、再試行する前に picsart.com でクレジットを追加してください。