Prizmad

Prizmad MCP Server

あらゆる商品 URL から AI UGC 動画広告を生成 — AI エージェントから直接操作できます。

Prizmad 用の Model Context Protocol サーバーです。Amazon、Shopify、WooCommerce、独自ストアなど、あらゆる商品 URL を、プラットフォームですぐに使える動画広告に 3～8 分で変換します。50 種類以上のアバター、ElevenLabs のナレーション、8 種類の字幕スタイル、9 種類の音楽スタイル、3 種類の CTA スタイル、10 種類の画像スタイルプリセット、画像／動画／音楽向けのフリーテキストのプロンプトヒント。 出力は 9:16／1:1／16:9 の Full HD で、TikTok、Instagram Reels、Facebook Ads、YouTube Shorts、Shopify、Amazon ですぐに使えます。商用利用権もすべて含まれています。

このサーバーはエージェント向けの操作インターフェースです。テンプレートを選び、商品画像を添付し、見た目をカスタマイズしてレンダリングし、ブランドに配慮したリンクを返します。Claude Desktop、Claude.ai、ChatGPT、Cursor、Zed、Continue、n8n、カスタム MCP SDK クライアントで動作します。

• リモート MCP：https://prizmad.com/api/mcp
• トランスポート：streamable-http
• 認証：OAuth 2.1 + PKCE + Dynamic Client Registration（「Connect」ボタン）、API キー Bearer、または OAuth client_credentials。
• npm：@prizmad/mcp-server

---

⚡ クイックスタート — クライアントを選択

Claude Desktop / Claude.ai / ChatGPT / Cursor / Zed（Connect ボタン）

この URL でカスタムコネクターを追加するだけです — OAuth + DCR フローが自動的に実行されるため、インストールも API キーも不要です。

https://prizmad.com/api/mcp

Claude Desktop では、Settings → Connectors → Add custom connector → URL: https://prizmad.com/api/mcp を選択します。ブラウザーが開いたら Prizmad にサインインし、Authorize をクリックすると、コネクターが自動的に設定されます。

必要に応じて、手動で設定します。

{
  "mcpServers": {
    "prizmad": {
      "transport": "streamable-http",
      "url": "https://prizmad.com/api/mcp"
    }
  }
}

OAuth に対応していないクライアントでは、代わりに API キーを設定してください。

{
  "mcpServers": {
    "prizmad": {
      "transport": "streamable-http",
      "url": "https://prizmad.com/api/mcp",
      "headers": { "Authorization": "Bearer przmad_sk_live_..." }
    }
  }
}

stdio ブリッジ（@prizmad/mcp-server）— stdio のみ対応するクライアント向け

{
  "mcpServers": {
    "prizmad": {
      "command": "npx",
      "args": ["-y", "@prizmad/mcp-server"],
      "env": { "PRIZMAD_API_KEY": "przmad_sk_live_..." }
    }
  }
}

または、グローバルにインストールします。

npm install -g @prizmad/mcp-server

{
  "mcpServers": {
    "prizmad": {
      "command": "prizmad-mcp",
      "env": { "PRIZMAD_API_KEY": "przmad_sk_live_..." }
    }
  }
}

.cursor/mcp.json の設定例（プロジェクト単位）

{
  "mcpServers": {
    "prizmad": {
      "url": "https://prizmad.com/api/mcp"
    }
  }
}

---

🛠 利用可能なツール

ツール	認証	機能
list_templates	不要	機能、再生時間、トークンコストを含むテンプレートの全カタログを表示します。
list_avatars	不要	名前、性別、年齢、おすすめの音声を含む、組み込みのアバタープリセットを表示します。
recommend_template	不要	意図と音声／アバター／再生時間／予算の条件から、上位 3 件のテンプレートを提案します。カタログから推測するのではなく、create_video の前にこのツールを使ってください。
list_my_videos	必要	projectUrl／shareUrl／downloadUrl を含む最近のプロジェクトを表示します。以前のセッションの videoId を探したり、「前回の動画をリミックス」したりする場合などに使えます。
upload_image	必要	画像（URL または base64）をアップロードし、productImages または avatarImageUrl に使える prizmad.com ホストの URL を返します。
create_video	必要	レンダリングを開始し、videoId を返します。字幕／音楽／CTA／画像スタイルのプリセットと、フリーテキストのプロンプトヒントを指定できます。
get_video_status	必要	デフォルトではステータスのスナップショットを返します。wait: true を指定すると、サーバー側で処理を待機し、終了状態になるまで notifications/progress を送信します（最長 10 分）。ポーリングよりもこちらを推奨します。
get_download_url	必要	完成した動画の、prizmad.com 上の認証済みダウンロード URL を返します。
create_video_batch	必要	1～20 件のレンダリングを並行して開始します。各項目では create_video の全パラメーターを指定できるため、A/B バリエーションのテストに最適です。

🎨 create_video のクリエイティブなカスタマイズ

各項目は省略可能です。省略した項目は、レンダリング時にランダムに選択されます。

パラメーター	値
captionStyle	classic、bold-impact、karaoke、pop、bounce、neon、typewriter、glow
musicStyle	energetic、friendly、professional、luxury、funny、cinematic、lo-fi、hip-hop、acoustic
ctaStyle	classic、blurred-photo、dark-solid
imageStyle	warm-golden、bright-neutral、cool-diffused、window-light、earthy-ambient、studio-clean、moody-dramatic、pastel-soft、nordic-minimal、sunset-warm
imagePromptHint	AI クリエイティブの方向性を指定する自由記述テキスト（400 文字以内）。
videoPromptHint	AI で商品動画クリップを生成する際の方向性を指定する自由記述テキスト。
musicPromptHint	音楽ジェネレーターの方向性を指定する自由記述テキスト。
language、tone、voiceId、avatarPresetId、duration、script	標準項目です。

🔗 出力 URL（ユーザーと共有するリンク）

すべてのステータス応答には、優先順位順に 3 種類の URL が含まれます。

フィールド	用途
projectUrl	https://prizmad.com/projects/<id> — プレーヤー、リミックス、編集、アセットライブラリを備えた、所有者専用のダッシュボードです。サインイン中のユーザーにはこのリンクを優先して共有してください。
shareUrl	https://prizmad.com/share/<token> — 公開共有ページです。アカウント外に転送する場合にのみ使用してください。
downloadUrl	https://prizmad.com/api/v1/videos/<id>/download — prizmad.com を経由する、認証済みの mp4 ストリームです。

Vercel Blob の生 URL がエージェントに表示されることはありません。

🔐 認証

方法	使用する場面	入手方法
OAuth 2.1 Authorization Code + PKCE + DCR	対話型クライアント（接続ボタン）	自動 — セットアップ不要
API key（Bearer）	ローカルの stdio ブリッジ、スクリプト、開発	https://prizmad.com/api-keys
OAuth 2.0 client_credentials	ヘッドレスのサーバー間通信	oauth skill

API による動画生成にはPro プランが必要です。UI での生成はすべてのプランで利用できます。Pro の制限はプログラムからのアクセスにのみ適用されます。

🧠 エージェントの一般的なワークフロー

recommend_template ─► (optional upload_image) ─► create_video
                                                  └─► get_video_status (wait: true)
                                                           └─► projectUrl + downloadUrl

接続後は、次のような内容をエージェントに依頼できます。

「この Amazon 商品の 30 秒のエネルギッシュなショーケース広告を作成してください。 https://amazon.com/dp/B0EXAMPLE — moody-dramatic な雰囲気で、シネマティックな音楽を使用してください。」

エージェントはテンプレートを選び、スタイルのヒントとともに URL を設定してレンダリングを開始します。ライブの進行状況通知を確認しながら完了を待ち、https://prizmad.com/projects/<id> のリンクを返します。

🌐 検出とメタデータ

• サーバーカード: https://prizmad.com/.well-known/mcp/server-card.json
• OAuth メタデータ: https://prizmad.com/.well-known/oauth-authorization-server
• 保護されたリソースのメタデータ（RFC 9728）: https://prizmad.com/.well-known/oauth-protected-resource
• JWKS: https://prizmad.com/.well-known/jwks.json
• エージェントスキルのインデックス: https://prizmad.com/.well-known/agent-skills/index.json
• OpenAPI: https://prizmad.com/openapi.json
• API カタログ（RFC 9727）: https://prizmad.com/.well-known/api-catalog

📦 環境変数（stdio ブリッジのみ）

変数	必須	説明
PRIZMAD_API_KEY	はい	お使いの Prizmad API キー
PRIZMAD_BASE_URL	いいえ	API のベース URL（デフォルトは https://prizmad.com）

📚 リソース

• Prizmad — メインサイト
• API ドキュメント — インタラクティブな API ドキュメント（Scalar）
• MCP サーバーのスキル — エージェント向けの詳細なリファレンス
• OAuth スキル — 3 つの認証フローの詳細
• プライバシーポリシー · セキュリティポリシー

🏷 Topics / categories

mcp · mcp-server · model-context-protocol · claude · chatgpt-apps · ai-agents · oauth · remote-mcp · ai-video · video-ads · ugc-ads · ad-creative · ai-avatars · voiceover · elevenlabs · tiktok · instagram-reels · youtube-shorts · shopify · amazon · marketing

License

MIT