Picsart GenAI MCP

公式

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

github.io で表示

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

  • 画像、動画、または音声を生成 — picsart_generate を使用して、201のモデルのいずれかでメディアを作成するようアシスタントに依頼します。アスペクト比、長さ、枚数などのオプションを指定できます。
  • 画像の背景を削除 — picsart_remove_bg を使用して、画像URLから背景除去をリクエストし、きれいな切り抜きを取得します。
  • コストの検証と見積もり — picsart_preflight を使用して、生成前にパラメータの有効性とクレジットコストを確認し、予期しない請求を回避します。
  • モデルカタログを閲覧 — 利用可能なモデルを尋ね、モードやプロバイダーでフィルタリングし、パラメータスキーマを調べて生成を計画します。
  • Picsart Driveでファイルを管理 — picsart_drive を使用して、アセットの一覧表示、アップロード、移動、削除を行い、生成に再利用できるCDN URLを取得します。

ドキュメント

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

MCPが初めてですか？まずはWhat is MCP?から始めてください。

前提条件

  1. gen-ai CLIをインストールします — Installationを参照してください。
  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のアスペクト比で白背景の製品画像を生成してください。」

Skillsやトラブルシューティングを含むClaude Codeの完全なセットアップについては、Claude Code integrationを参照してください。

Cursor

CursorのMCP設定ファイル（.cursor/mcp.jsonまたは同等のもの）に以下を追加します：

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

Cursor integrationを参照してください。

Windsurf

WindsurfのMCP設定に追加します：

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

Windsurf integrationを参照してください。

VS Code (Copilot)

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

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

VS Code integrationを参照してください。

Codex (OpenAI)

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

Codex integrationを参照してください。

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

現在のコネクタ設定については、ChatGPT integrationまたは公式ページ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_studioMusic Studioを開く（音楽 / SFX / アルバムアート）なし¹

¹ スタジオを開くのは無料です。内部での生成はクレジットを消費します。

カタログとコスト

ツール目的クレジット消費
picsart_list_modelsモデルピッカーウィジェット — ユーザーが視覚的に閲覧するためなし
picsart_model_catalogエージェント自身の推論のための、プレーンデータとしての同じカタログなし
picsart_model_params1つのモデルのパラメータスキーマ（型、必須、enum、最小/最大）なし
picsart_preflightparamsペイロードを検証し、そのクレジットコストを見積もる — 無料のドライラン1回なし
picsart_credits現在のクレジット残高と割り当ての内訳なし
picsart_job_statuspicsart_generateによって開始されたジョブをasync: trueでポーリングなし

Drive

ツール目的クレジット消費
picsart_drivePicsart Driveの単一エントリポイント — 動作はactionで選択なし

picsart_driveはactionパラメータを受け取ります。操作ごとの個別のDriveツールはありません：

action機能
listフォルダを閲覧（folderUid省略時 = ルート、flat: trueで全ファイルを一覧表示）
create_folderフォルダを作成（name、オプションの親folderUid、description）
uploadファイルを保存 — file（チャット添付ファイル）またはurl + name（HTTPS URLまたはインラインdata: URI）のいずれか。result.urlはimageUrlsに渡す準備ができたCDN URLです
moveitemUidsをtargetFolderUidに移動
deleteitemUidsをゴミ箱にソフト削除（permanent: trueで完全消去）
update1つのファイルにカスタム属性を設定（itemUid + attributes）

すべてのアクションは現在のフォルダ一覧を返すため、Driveウィジェットがレンダリングできます。詳細はFiles & Driveを、ディスクからファイルを取得する方法についてはLocal files → URLsを参照してください。

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

すべての画像/動画入力はURLです。MCP契約のどこにもfilePathパラメータはありません — 実際に機能する3つの方法についてはLocal files → URLsを参照してください。

推奨される生成フロー

ツールは連鎖するように設計されています。この順序で進めると問題を回避できます：

  1. picsart_model_catalog（またはユーザーが視覚的に選択できるようにするpicsart_list_models）→ モデルを選択
  2. picsart_model_params → その入力を学習
  3. picsart_preflight → ペイロードを検証し、コストを1回の無料呼び出しで見積もる
  4. picsart_generate → 実際に実行

すでにモデルIDがわかっている場合は、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（モデルID）、prompt（テキストプロンプト）
  • 一般的なオプション： aspectRatio、resolution、duration、count（1〜8）、quality、style、negativePrompt
  • 画像入力： imageUrls（URLの配列 — 画像から画像、または画像から動画のモデル用）
  • 動画入力： videoUrl（単一のURL — 動画から動画のモデル用）
  • 音声生成： generateAudio（ブール値 — ネイティブ音声をサポートする動画モデル用）
  • プロンプト拡張： enhancePrompt（ブール値 — 生成前にLLMを経由）
  • モデル固有のパラメータ： extra（自由形式のオブジェクト — モデルが受け入れるものを確認するにはpicsart_model_paramsを使用）

結果はresults: [{ url, metadata? }]として返されます。アセットはURLであり、base64ではありません。各結果にはresource_linkも含まれるため、エージェントは後続のツール呼び出しでそれを参照できます。

FAQ

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

いいえ。CLIと同じOAuthセッションを使用します。gen-ai loginを一度実行してください。MCPサーバーはその認証情報を自動的に取得します。

同じマシンでMCPとCLIを同時に使用できますか？

はい。両方とも同じ認証情報ファイル（~/.gen-ai/credentials.json）と同じクレジット残高を使用します。並行して実行しても問題ありません。

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

MCP設定を追加した後、エージェントを再起動してください。ほとんどのエージェントは起動時にツールリストを読み込みます。動的には読み込みません。

MCP経由でどのモデルが動作しますか？

カタログ内の全201モデルです。MCP固有のサブセットはありません。picsart_list_modelsを使用してモードやプロバイダーでフィルタリングするか、Model Catalogを閲覧してください。

エージェントは生成したファイルをDriveに保存できますか？

はい。"saveToDrive": trueをpicsart_generateの引数に渡すか、picsart_driveを使用してローカルファイルまたはURLをアップロードします。Files and Driveを参照してください。

実行前にモデルのコストを知るにはどうすればよいですか？

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

生成中にクレジット残高がなくなったらどうなりますか？

picsart_creditsで残高を確認し、再試行する前にpicsart.comでチャージしてください。