Prizmad

Prizmad MCP 服务

直接通过 AI Agent，根据任意产品网址生成 AI UGC 视频广告。

适用于 Prizmad 的 Model Context Protocol 服务。它可将任意产品网址（Amazon、Shopify、WooCommerce 或自定义商店）转换为适合各平台的视频广告，只需 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。包含完整商业使用权。

此服务提供驱动 Agent 的接口——选择模板、添加产品图片、自定义外观、渲染，并返回符合品牌规范的链接。适用于 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”按钮）或 Bearer API 密钥 或 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	否	根据意图以及语音 / 虚拟形象 / 时长 / 预算限制，推荐排名前三的模板。请在调用 create_video 前使用此工具，而不要凭模板目录猜测。
list_my_videos	是	最近的项目及其 projectUrl / shareUrl / downloadUrl。可查找之前会话中的 videoId、执行“remix my last video”等。
upload_image	是	上传图片（URL 或 base64）——返回托管在 prizmad.com 上的 URL，可用于 productImages 或 avatarImageUrl。
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（要分享给用户的链接）

每个状态响应都包含三种 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 绝不会显示给 Agent。

🔐 身份验证

方式	使用场景	获取方式
OAuth 2.1 Authorization Code + PKCE + DCR	交互式客户端（Connect 按钮）	自动完成，无需设置
API key (Bearer)	本地 stdio 桥接、脚本、开发	https://prizmad.com/api-keys
OAuth 2.0 client_credentials	无头服务器到服务器	oauth skill

API 视频生成需要 Pro 套餐。任何套餐均可使用 UI 生成；Pro 限制仅适用于程序化访问。

🧠 典型 Agent 工作流

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

连接后，你可以向 Agent 提出如下请求：

“为这款 Amazon 产品制作一支 30 秒的动感展示广告： https://amazon.com/dp/B0EXAMPLE — 氛围采用 moody-dramatic 风格，配以 cinematic 音乐。”

Agent 会选择一个模板，填入 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
• Agent 技能索引：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 服务技能 — 面向 Agent 的完整参考
• OAuth 技能 — 详细介绍三种身份验证流程
• 隐私政策 · 安全政策

🏷 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