pitchboom

pitchboom MCP 服务：通过 AI 助手制作视频广告

pitchboom.io 是一款面向视频广告的 AI 动态设计工作室。 输入产品 URL 或简短需求，它就能撰写脚本、制作可编辑的分镜、添加配音和音乐，并生成 16:9、9:16、1:1、4:5 和 3:4 格式的 MP4 视频（1080p；Pro 和 Premium 支持 4K）。此仓库将 AI 助手（Claude Code、Claude Desktop 和 claude.ai、Cursor、VS Code、Gemini CLI、Codex）连接到 pitchboom 的远程 MCP 服务，让 Agent 能在你的 pitchboom 账户中准备、报价、启动、编辑和下载视频。付费步骤会先返回报价，只有你批准后才会扣除点数。

免费起步： 每个新账户在注册时都会获得 500 个免费点数，无需绑定银行卡（约可制作一条 30 秒的 Standard 视频），之后可选择每月 €30 起的套餐（不含 VAT），套餐含月度点数。MCP 服务包含在 Pro 和 Premium 套餐中；免费账户可在网页应用中制作 Standard 视频。

套餐	月价（不含 VAT）	点数	MCP 服务	4K 导出	最长视频时长	每批视频数
免费账户	€0	注册时一次性赠送 500	否（仅限网页应用）	否	30 s	1
Starter	€30	每月 3,000	否	否	60 s	3
Pro	€99	每月 11,000	是	每秒 +4 点数	90 s	10
Premium	€300	每月 37,500	是	已包含	120 s	25

视频费用（包含分镜、配音、音乐和 1080p 渲染）：Standard 每秒 13 点数，Studio 每秒 100 点数；使用你的代码：Standard 每秒 +10 点数，Studio 每秒 +20 点数。短于 15 s 的视频按 15 s 计费。Studio 视频至少按 20 s 计费；如果使用从你的代码重建的屏幕，代码附加费用至少按 30 s 计费。例如：一条 15 秒的 Standard 视频需要 195 点数（按 Starter 费率约 €1.95，按 Premium 费率约 €1.56）。按 Starter 费率，1 点数 = €0.01（Pro 的每个点数均可享 10% 折扣，Premium 的每个点数均可享 20% 折扣）。

点数扣费方式： 每项付费操作都会先显示预估费用。确认后，系统会从你的余额中暂时冻结预估点数；每个完成的步骤会扣除相应点数，任务结束时会释放未使用的点数。如果渲染在我们这边失败，已扣除的点数会自动退还。

价格截至 pricing version 2026-10-24。最新价格请见 https://pitchboom.io/pricing 和 https://pitchboom.io/llms.txt。

完整文档：https://pitchboom.io/docs/mcp

目录

• 开始之前
• 快速入门：Claude Code、Claude Desktop 和 claude.ai、Cursor、VS Code、Gemini CLI、Codex、其他客户端
• 费用规则
• 典型流程
• 工具
• 错误
• 安全与隐私
• 此仓库的内容
• 法语版

开始之前

1. 一个订阅了包含 MCP 服务套餐的 pitchboom 账户（见上表）。

2. 服务地址： https://pitchboom.io/api/mcp，使用 Streamable HTTP 传输。两种登录方式：

   • OAuth 2.1（claude.ai 和 Claude Desktop 自定义连接器、ChatGPT、Claude Code、MCP Inspector 及其他支持此方式的客户端）：只需添加 URL。客户端会打开 pitchboom，你登录并批准应用，然后选择其权限。已连接的应用会列出，也可以在 https://pitchboom.io/settings/api 断开连接。
   • 个人 API 密钥，适用于其他所有客户端：在 https://pitchboom.io/settings/api 创建密钥，并发送 Authorization: Bearer <your key>。密钥以 pb_live_ 开头；创建密钥时可选择其权限，也可随时在此撤销。服务不接受通过 URL 传入的密钥。

3. 不要将密钥保存在文件中。 以下大多数密钥配置会从环境变量中读取：

   export PITCHBOOM_API_KEY=pb_live_YOUR_KEY   # for example in ~/.zshrc; never commit it
   

创建密钥或批准应用时提供的权限预设：

预设	权限	允许的操作
完全访问	读取、准备与编辑、消耗额度	读取、准备和编辑，并在你确认报价后消耗额度。
不消耗额度	读取、准备与编辑	准备报价、编辑分镜和草稿；付费工作的确认需在应用中进行。
只读	读取	列出并查看项目、视频、任务和额度。不会进行任何更改。

快速入门

Claude Code

将此仓库安装为插件。它会添加 MCP 服务和一个技能，指导 Claude 撰写需求简报、展示报价并等待你批准：

/plugin marketplace add arseneHuot/pitchboom
/plugin install pitchboom@pitchboom

插件会从启动 Claude Code 时所在的环境中读取 PITCHBOOM_API_KEY。运行 /mcp 检查连接。

若只添加服务而不安装技能，并使用 OAuth 登录（运行 /mcp，选择 pitchboom，然后选择 Authenticate）：

claude mcp add --transport http pitchboom https://pitchboom.io/api/mcp

也可以使用密钥：添加 --header "Authorization: Bearer pb_live_YOUR_KEY"。

添加 --scope user，即可在每个项目中使用。文档：Claude Code 中的 MCP、插件市场。

Claude Desktop 和 claude.ai

• Claude Desktop，Code 标签页： 将以下内容粘贴到 Code 标签页的聊天中（Claude 会为你运行），或在终端中运行，然后开始新聊天：

  claude mcp add --transport http --scope user pitchboom https://pitchboom.io/api/mcp --header "Authorization: Bearer pb_live_YOUR_KEY"
  

• 自定义连接器（claude.ai、Claude Desktop 和移动端聊天）： 在 Customize > Connectors 中选择 Add custom connector，输入 https://pitchboom.io/api/mcp（OAuth 客户端 ID 和密钥留空），然后选择 Connect：pitchboom 会打开，你登录并选择权限，然后返回 Claude。Team 和 Enterprise 套餐中的每位成员都需连接自己的 pitchboom 账户。

• 通过本地桥接连接 Claude Desktop 聊天（需要 Node.js）：将以下内容添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\），然后重启 Claude Desktop。

  {
    "mcpServers": {
      "pitchboom": {
        "command": "npx",
        "args": ["-y", "mcp-remote@latest", "https://pitchboom.io/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
        "env": { "AUTH_HEADER": "Bearer pb_live_YOUR_KEY" }
      }
    }
  }
  

  标头的冒号后没有空格，因为某些客户端会按空格拆分参数（mcp-remote README）。

Cursor

将以下内容添加到 ~/.cursor/mcp.json（适用于每个项目）或 .cursor/mcp.json（适用于单个项目）。Cursor 会从环境中读取 ${env:PITCHBOOM_API_KEY}（Cursor MCP 文档）：

{
  "mcpServers": {
    "pitchboom": {
      "url": "https://pitchboom.io/api/mcp",
      "headers": { "Authorization": "Bearer ${env:PITCHBOOM_API_KEY}" }
    }
  }
}

此仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json、mcp.json 和技能）。将其安装为插件时，请在 Dashboard > Plugins > Configure 下的 PITCHBOOM_API_KEY 插件变量中设置密钥（Cursor 插件变量）。

VS Code

将以下内容添加到 .vscode/mcp.json。VS Code 会提示你输入一次密钥，并安全地保存它（VS Code MCP 配置）：

{
  "inputs": [
    { "type": "promptString", "id": "pitchboom-key", "description": "pitchboom API key", "password": true }
  ],
  "servers": {
    "pitchboom": {
      "type": "http",
      "url": "https://pitchboom.io/api/mcp",
      "headers": { "Authorization": "Bearer ${input:pitchboom-key}" }
    }
  }
}

Gemini CLI

将此仓库安装为扩展。安装期间会要求你提供 API 密钥，并将其保存在系统密钥链中；还会添加该技能：

gemini extensions install https://github.com/arseneHuot/pitchboom

若只添加服务（每个项目使用 --scope user）：

gemini mcp add --transport http --header "Authorization: Bearer pb_live_YOUR_KEY" pitchboom https://pitchboom.io/api/mcp

文档：Gemini CLI 扩展，Gemini CLI 中的 MCP 服务。

Codex

export PITCHBOOM_API_KEY=pb_live_YOUR_KEY
codex mcp add pitchboom --url https://pitchboom.io/api/mcp --bearer-token-env-var PITCHBOOM_API_KEY

--bearer-token-env-var 接受的是变量名，而不是密钥。以下是在 ~/.codex/config.toml 中设置的相同配置，Codex CLI、IDE 扩展和 ChatGPT 桌面应用共用该配置（Codex MCP 文档）：

[mcp_servers.pitchboom]
url = "https://pitchboom.io/api/mcp"
bearer_token_env_var = "PITCHBOOM_API_KEY"

其他 MCP 客户端

任何支持 Streamable HTTP 和自定义标头的客户端都可使用：

URL:        https://pitchboom.io/api/mcp
Transport:  Streamable HTTP
Header:     Authorization: Bearer pb_live_YOUR_KEY

仅能运行本地服务的客户端可以使用桥接程序 npx -y mcp-remote@latest https://pitchboom.io/api/mcp --header "Authorization: Bearer <key>"。支持 OAuth 的客户端只需要 URL。若要检查服务，请使用 MCP Inspector：npx @modelcontextprotocol/inspector（Streamable HTTP，只需 URL：它会通过 OAuth 登录）。

费用规则

未经明确确认，不会收取任何费用。

1. create_project、get_estimate、request_variant 和付费编辑只会返回一份报价：quote_id、每个视频和总计所需的 credits，以及扣费后的余额。不会扣费。
2. 助手会向你展示报价，由你决定是否批准该确切金额。
3. 只有在此之后，它才会调用 confirm_operation(quote_id)，预留 credits 并开始处理。等待分镜审批的视频可通过 approve_storyboard(max_total) 在你接受的总额范围内继续处理；如果价格上涨，则不会进行任何操作，你会收到新的总价。

报价会在 30 分钟后过期。confirm_operation 和 approve_storyboard 是仅有的会消耗 credits 的工具；两者都标记为有破坏性的操作，并会要求 Claude Code 在每次调用前征求你的同意。使用不允许消费密钥时，助手会准备报价并编辑分镜，你则在 Web 应用中确认付费工作。

典型流程

get_credit_balance
→ get_options, list_brand_kits             accepted values, Brand Kits
→ create_project                           a quote; the free website analysis starts
→ you approve the quote → confirm_operation
→ get_job_status(wait_seconds=50)          until the storyboard waits for approval
→ get_storyboard → update_storyboard       free edits
→ you approve → approve_storyboard(max_total)
→ get_job_status                           until succeeded
→ get_video                                download links valid 1 hour

渲染完成后：使用 edit_video 进行修改，使用 request_variant 进行翻译、转换为其他格式、生成新版本或输出 4K 视频。

可尝试的提示词：

• “为 https://example.com 制作一条 15 秒的 9:16 TikTok 广告，目标是获取注册。扣费前先向我展示报价。”
• “将我最近制作的 pitchboom 视频翻译成法语和德语。先给我报价。”
• “我还剩多少 pitchboom credits？”

工具

服务会向每个密钥列出 18 个工具：

工具	功能	密钥权限	是否消耗点数
get_credit_balance	点数和套餐	读取	否
get_options	允许的设置和价格	读取	否
list_brand_kits	品牌套件	读取	否
list_projects	项目	读取	否
get_project	项目详情	读取	否
analyze_url	读取网站	准备和编辑	否
create_project	准备视频（报价）	准备和编辑	否
get_estimate	报价（刷新或读取）	读取	否
confirm_operation	确认并消耗点数	消耗点数	是，仅在你批准报价后；Claude Code 会在每次调用前询问你
get_job_status	任务进度	读取	否
cancel_job	取消任务	准备和编辑	否（停止或删除）
get_storyboard	分镜	读取	否
update_storyboard	编辑分镜（免费）	准备和编辑	否
approve_storyboard	批准分镜	消耗点数	是，仅在你批准报价后；Claude Code 会在每次调用前询问你
list_videos	视频	读取	否
get_video	视频详情和下载	读取	否
request_variant	准备变体（报价）	准备和编辑	否
edit_video	编辑已渲染的视频	准备和编辑	否

当你的账户启用了源代码输入时，另外 5 个工具可让拥有 Shell 的 Agent（Claude Code、Codex、Gemini CLI）发送你产品的代码，让视频重新构建真实的屏幕。它们会先询问你：你的代码会离开你的设备。

工具	功能	密钥权限	是否消耗点数
prepare_code_upload	发送你的源代码（第 1 步，共 2 步）	准备和编辑	否；Claude Code 会在每次调用前询问你
complete_code_upload	分析上传的代码	准备和编辑	否
import_code_from_github	读取 GitHub 仓库	准备和编辑	否；Claude Code 会在每次调用前询问你
get_code_source	代码分析	读取	否
delete_code_source	立即删除上传的代码	准备和编辑	否（停止或删除）

每个工具的完整说明和输入架构都来自服务端（tools/list），也可访问 https://pitchboom.io/docs/mcp 查看。

错误

工具错误以 ERROR <code>: 开头，后面会说明如何修复。常见错误如下：

代码	含义	处理方法
plan_required	当前套餐不包含此功能（MCP 访问权限、4K、更长的视频）。	前往 https://pitchboom.io/billing 升级，或选择更短的时长。
subscription_required	账户没有付费套餐。	免费账户请使用 Web 应用；套餐请访问 https://pitchboom.io/pricing。
insufficient_scope	密钥缺少相应权限（例如仅有读取权限的密钥）。	使用正确的预设创建密钥。
insufficient_credits	点数不足以支付报价。未扣除任何点数。	前往 https://pitchboom.io/billing#top-up 充值，或减少视频数量、缩短视频时长。
quote_expired、quote_stale	报价已超过 30 分钟，或价格发生变化。	使用 get_estimate 获取最新报价并再次展示。
estimate_changed	分镜有所增加，费用超出已接受的总额。	展示新的总额；只有在你同意时，才以该金额调用 approve_storyboard。
analysis_running	网站分析尚未完成。	轮询 get_project，直到 analysis_status 为 ready，然后再次确认相同的报价。
batch_too_large	一次请求的视频数量超出套餐允许范围。	减小 quantity。
video_busy	此视频已有任务正在运行。	使用 get_job_status 等待。
rate_limited	请求过于频繁。	等待后重试。

HTTP 错误采用 JSON 格式 { "error": { "code", "message", "docs" } }：401 对应 missing_api_key、malformed_api_key、invalid_api_key 或 key_in_url；429 对应 rate_limited，并包含 Retry-After 标头；服务短暂不可用时返回 503。

安全与隐私

• 密钥属于个人。pitchboom 只存储密钥的哈希，并在每次请求时进行检查，因此在 https://pitchboom.io/settings/api 撤销密钥、更改套餐或暂停服务都会立即生效。
• 请将密钥存放在环境变量、客户端的密钥存储区或密钥链中；切勿将其放入代码仓库、聊天内容或 URL。
• 故事板和网站分析中的文本来自网站：服务端会告知 Agent 将其视为数据，绝不能视为指令。
• 默认情况下，视频会公开显示在 pitchboom 画廊中。向 create_project 传入 visibility: "private"，或在账户设置中将默认值设为私密。
• get_video 返回的下载链接有效期为 1 小时：请立即下载文件，且不要存储或分享这些链接。
• 源代码工具会先征求你的同意，因为你的代码会离开你的设备。delete_code_source 会删除上传的代码及其衍生内容，但已保存的 Brand Kit 和渲染后的视频除外。

此代码仓库包含什么

路径	用途
server.json	在官方 MCP Registry 中的条目（io.pitchboom/pitchboom）
.claude-plugin/plugin.json、.claude-plugin/marketplace.json、.mcp.json	Claude Code 插件及其市场
.cursor-plugin/plugin.json、mcp.json	Cursor 插件
gemini-extension.json、GEMINI.md	Gemini CLI 扩展
skills/pitchboom-video-ads/SKILL.md	Agent 技能（Agent Skills 格式），由插件和扩展共用
assets/	图标
scripts/sync-from-source.mjs	从 pitchboom 的源代码重新生成事实信息和工具列表

pitchboom 服务由 pitchboom 托管，其代码不公开：此代码仓库仅包含配置和文档。标记为“GENERATED”的部分由 scripts/sync-from-source.mjs 根据与线上服务及 https://pitchboom.io/llms.txt 相同的源文件生成。

链接

• MCP 文档：https://pitchboom.io/docs/mcp
• 定价：https://pitchboom.io/pricing
• 面向 AI 助手的事实信息：https://pitchboom.io/llms.txt
• 条款：https://pitchboom.io/legal/terms · 隐私：https://pitchboom.io/legal/privacy
• 支持：[email protected] 或在此代码仓库中提交问题

许可证

此代码仓库中的文件采用 MIT 许可证（LICENSE）。pitchboom 服务的使用受其服务条款约束。

法语

pitchboom.io 是一个面向视频广告的 AI 动效设计工作室。 输入产品 URL 或简短需求后，它会撰写脚本、制作可编辑的故事板、添加旁白和音乐，并交付 MP4 视频（1080p；Pro 和 Premium 套餐支持 4K），支持 16:9、9:16、1:1、4:5 和 3:4 格式。此仓库可将您的 AI 助手（Claude Code、Claude Desktop 和 claude.ai、Cursor、VS Code、Gemini CLI、Codex）连接到 pitchboom 的远程 MCP 服务。

快速开始： 每个新账户在注册时可一次性获得 500 个免费额度，无需银行卡。Pro 套餐（每月 99 €，不含税）和 Premium 套餐（每月 300 €，不含税）包含 MCP 服务；免费账户请使用 Web 应用。

• 服务地址： https://pitchboom.io/api/mcp（Streamable HTTP）。Claude（自定义连接器）、ChatGPT、Claude Code 和其他兼容 OAuth 的客户端只需填写此地址：它们会打开 pitchboom，让您登录并选择权限。也可以使用 Authorization: Bearer pb_live_… 请求头，并通过 https://pitchboom.io/settings/api 创建个人密钥；切勿将其放入共享文件或 URL 中。
• 安装： 在 Claude Code 中运行 /plugin marketplace add arseneHuot/pitchboom，然后运行 /plugin install pitchboom@pitchboom；在 Gemini CLI 中运行 gemini extensions install https://github.com/arseneHuot/pitchboom。其他客户端（Cursor、VS Code、Codex、Claude Desktop）的安装说明见上文。
• 费用规则： 付费工具会先返回报价。助手会向您展示报价，您批准确切金额后，才会调用 confirm_operation。报价 30 分钟后过期。
• 文档（英文）：https://pitchboom.io/docs/mcp · 价格：https://pitchboom.io/pricing