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 サーバーに接続し、エージェントが pitchboom アカウントで動画の準備、見積もり、作成開始、編集、ダウンロードを行えるようにします。料金が発生する手順では、まず見積もりが提示され、お客様が承認した後にのみクレジットが消費されます。

無料で始められます： 新規アカウントには、登録時にカード不要で 500 クレジットが付与されます（約 30 秒の Standard 動画 1 本分）。その後は、月間クレジット付きの月額 €30（VAT 別）からプランを選べます。MCP サーバーは Pro と Premium プランに含まれます。無料アカウントでは、ウェブアプリで Standard 動画を作成できます。

プラン	月額料金（VAT 別）	クレジット	MCP サーバー	4K 書き出し	最長動画時間	1 バッチあたりの動画数
無料アカウント	€0	登録時に 500（1 回限り）	いいえ（ウェブアプリのみ）	いいえ	30 秒	1
Starter	€30	毎月 3,000	いいえ	いいえ	60 秒	3
Pro	€99	毎月 11,000	はい	1 秒あたり +4 クレジット	90 秒	10
Premium	€300	毎月 37,500	はい	含まれます	120 秒	25

動画の料金（ストーリーボード、ナレーション、音楽、1080p レンダリングを含む）：Standard は 1 秒あたり 13 クレジット、Studio は 100 クレジットです。コードを使う場合：Standard は 1 秒あたり +10 クレジット、Studio は +20 クレジットです。15 秒未満の動画は 15 秒分として請求されます。Studio 動画は最低 20 秒分として請求されます。コードから画面を再構築する場合、コードの追加料金は最低 30 秒分として請求されます。例：15 秒の Standard 動画は 195 クレジットです（Starter 料金では約 €1.95、Premium では €1.56）。Starter 料金では 1 クレジット = €0.01 です（Pro では全クレジットが 10% 割引、Premium では 20% 割引になります）。

クレジットの請求方法： 料金が発生する操作では、毎回最初に見積もりが表示されます。承認すると、見積もり分が残高から確保されます。完了した各手順でその分のクレジットが消費され、ジョブ終了時に未使用分が解放されます。当社側の問題でレンダリングに失敗した場合、消費されたクレジットは自動的に返金されます。

料金は価格バージョン 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 トランスポート。サインイン方法は2つあります。

   • OAuth 2.1（claude.ai、Claude Desktop のカスタムコネクター、ChatGPT、Claude Code、MCP Inspector、およびOAuth 2.1に対応するその他のクライアント）：URLだけを追加します。クライアントからpitchboomが開くので、サインインしてアプリを承認し、権限を選択します。接続済みのアプリはhttps://pitchboom.io/settings/apiで一覧表示され、接続を解除することもできます。
   • 個人用APIキー（その他すべてのクライアント向け）：https://pitchboom.io/settings/apiで作成し、`Authorization: Bearer を送信します。キーは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（1つのプロジェクト用）に追加します。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 CLI、IDE 拡張機能、ChatGPT デスクトップアプリで共有される、~/.codex/config.toml 内の同じ設定です（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、動画あたりと合計のクレジット数、処理後の残高です。課金はされません。
2. アシスタントが見積もりを提示し、その正確な金額を承認するかどうかを確認します。
3. その後に限り、confirm_operation(quote_id) を呼び出してクレジットを確保し、作業を開始します。ストーリーボードの承認待ちの動画は、承認した合計額の範囲内で approve_storyboard(max_total) を呼び出すと再開します。価格が上がっていた場合は何も実行されず、新しい合計額が提示されます。

見積もりの有効期限は30分です。クレジットを消費するツールは confirm_operation と approve_storyboard だけです。どちらも破壊的操作としてマークされており、Claude Code に毎回、呼び出し前の確認を求めるよう指示します。支出なしキーを使うと、アシスタントは見積もりの作成とストーリーボードの編集を行い、有料の作業はウェブアプリで確認できます。

一般的なフロー

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、翻訳、別の形式、新しいテイク、4K には request_variant を使用します。

試してみるプロンプト：

• 「https://example.com 向けに、サインアップを目標とした15秒の9:16 TikTok 広告を作成してください。課金が発生する前に見積もりを提示してください。」
• 「最後の pitchboom 動画をフランス語とドイツ語に翻訳してください。先に見積もりを提示してください。」
• 「pitchboom のクレジットはあといくつありますか？」

ツール

サーバーは各キーに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つのツールを使って、シェルを備えたエージェント（Claude Code、Codex、Gemini CLI）が製品のコードを送信し、動画に実際の画面を再現できます。事前に確認を求めます。コードがマシンの外に送信されます。

ツール	機能	キーの権限	クレジットを消費
prepare_code_upload	ソースコードを送信する（全2段階のうちステップ1）	準備と編集	いいえ。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	アカウントに有料プランがありません。	無料アカウントではウェブアプリを使用してください。有料プランは 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	ウェブサイトの分析が完了していません。	analysis_status が ready になるまで get_project を繰り返し呼び出し、その後、同じ見積もりを再度確認してください。
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 には絶対に記載しないでください。
• ストーリーボードやサイト分析に含まれるテキストはウェブサイトに由来します。サーバーはエージェントに対し、そのテキストを指示ではなくデータとして扱うよう伝えます。
• 動画はデフォルトで pitchboom ギャラリーに公開されます。create_project に visibility: "private" を渡すか、アカウント設定で非公開をデフォルトにしてください。
• get_video のダウンロードリンクは 1 時間有効です。ファイルをすぐにダウンロードし、リンクを保存したり共有したりしないでください。
• ソースコード関連のツールは、コードが端末の外部に送信されるため、事前に確認を求めます。delete_code_source は、保存済みの Brand Kits とレンダリング済み動画を除き、アップロードされたコードと、そこから派生したすべてのものを削除します。

このリポジトリの内容

パス	用途
server.json	公式 MCP レジストリ（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 Skills 形式）
assets/	アイコン
scripts/sync-from-source.mjs	pitchboom のソースコードから情報とツール一覧を再生成します

pitchboom サーバーは pitchboom がホストしており、そのコードは公開されていません。このリポジトリには設定とドキュメントのみが含まれます。「GENERATED」とマークされたブロックは、ライブサーバーおよび https://pitchboom.io/llms.txt と同じソースファイルから scripts/sync-from-source.mjs によって生成されます。

リンク

• 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] またはこのリポジトリの issue

ライセンス

このリポジトリのファイルは MIT ライセンス（LICENSE）の下で提供されています。pitchboom サービスの利用には、利用規約が適用されます。

フランス語

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 サーバーに接続します。

まずはじめに： 新規アカウントには、登録時に一度だけ、クレジットカード不要で無料クレジットが 500 クレジット付与されます。MCP サーバーは Pro プラン（月額 99 €（税別））と Premium プラン（月額 300 €（税別））に含まれています。無料アカウントではウェブアプリをご利用ください。

• サーバーアドレス： https://pitchboom.io/api/mcp（Streamable HTTP）。Claude（カスタムコネクター）、ChatGPT、Claude Code、その他の OAuth 対応クライアントは、アドレスを入力するだけで利用できます。pitchboom が開き、ログインと権限の選択を行えます。それ以外の場合は、https://pitchboom.io/settings/api で作成した個人用キーを Authorization: Bearer pb_live_… ヘッダーに指定してください。共有ファイルや 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