ClaudeとTapVid MCPでモーショングラフィックスを作る方法

01

Claudeが調整し、TapVidがレンダリングする

「Claude video generation」というフレーズは、Claudeがフレームを直接描画し、レイヤーをアニメーション化し、オーディオをミックスし、MP4をエクスポートすることを示唆しています。 それはここで起こることではありません。 Claudeは目標を読み、呼び出す外部ツールを決定し、構造化された引数を提供し、結果を観察し、ワークフローを続行します。 TapVid はソース資料を受け取り、解説動画を作成し、生成ジョブを実行し、エクスポートを準備します。 MCPは、これら二つのシステム間の型付き接続です。 この境界は、デバッグすべき場所を示すため重要です。 弱いプロンプトは計画の問題です。 拒否されたパラメータはツール呼び出しの問題です。 遅いレンダリングは発電サービスの問題です。 誤解を招くシーンは、情報源およびレビューの問題です。

TapVidは、記事、文書、スクリプト、PDF、PRD、または製品ページなどの既存のコンテンツを、構造化されたマルチシーン情報ビデオに変換します。 それは、生のテキストからビデオへのモデルにシネマティックな5秒ショットを依頼することとは異なります。 情報源はシステムの事実と構造を提供します。 プロンプトは、対象者、期間、視覚的指示、および除外事項を提供します。 Claudeはツールを呼び出す間、これらの制約を可視化しておくことができますが、個人は依然として事実に基づく承認、ペース、権利、そして最終リリースを所有しています。 機関や中小企業にとって、実用的な価値は規模です。明確なソース境界とシーンレベルの再放送により、1つのシーンが修正を必要とする場合に必要となるフルビデオのレビューや再構築の量が削減されます。

埋め込み動画はMotionによる外部のMotion MCP参考例であり、今回のTapVid実測結果ではありません。検証済みのTapVid証拠は後のスクリーンショットと時間記録に示します。

02

Bearer API KeyでClaudeを接続する

現在の公開設定では、REST と MCP に同じ Bearer API キーを使用します。API キーページでキーを作成し、表示された時点でコピーして、クライアントのシークレット管理ガイドに従って保存してください。Claude Code では、TapVid のhttps://mcp.tapvid.ai/mcpを指定したカスタム HTTP コネクタを追加し、チャットのプロンプトではなく、コネクタ設定時に Authorization ヘッダーを設定します。下記の `claude mcp list` による実環境チェックでは `tapvid … Connected` が返りました。サーバーはステートレスな Streamable HTTP を使用するため、各ツール呼び出しは個別に認証されます。素材をアップロードしたりクレジットを消費したりする前に、読み取り専用のアカウント確認から始めてください。失敗した場合は、生成をむやみに送信せず、先に接続を修正します。

• `/developer/apikey`でキーを作り安全に保存する。
• `https://mcp.tapvid.ai/mcp`とBearer headerをClaudeに追加する。
• `get_account`で接続とcreditsを確認する。
• 承認された HTTPS ソース URL を `upload_material` でアップロードしてください；URL が利用できない場合にのみ Base64 ファイルを使用してください。
• 長さ、画角、言語、対象、禁止事項を決めてから作成する。

03

実際に確認したMCPツール

制御された作成およびエクスポート実行は、5つのツールを使用しました： `get_account`、`upload_material`、`create_video`、`get_video_status`、および `get_video_download`。 現在のコネクタおよび公式 MCP ページは `edit_video` も公開しており、完成した動画の編集を開始し、ステータスポーリング用に編集 ID を返します。 その6番目のツールはタイムランで呼び出されませんでした。 AIクライアントが手書きのHTTPスクリプトではなくサーバーを呼び出すことができることを証明するために、ライブビデオIDを持つ`get_video_status`というCodexセッションが実行状態を50%で取得しました。 スクリーンショットは、ツール名、引数、結果、および端末の状態を保持しつつ、認証情報と署名済み URL を省略しています。

共通ブリーフは意図的に具体化しました。TapVid APIとMCPへのアクセスを検討する開発者向けに、簡潔な30秒・16:9・英語のモーショングラフィックス解説動画を作成すること。提供したTapVidページを事実情報の出典として使うこと。TapVidが既存コンテンツを構造化された解説動画に変換することを説明し、素材のアップロード、非同期生成、ダウンロードを見せること。最後は控えめなドキュメントへのCTAで締め、性能に関する主張、顧客成果、裏付けのない機能を捏造しないこと。このブリーフにより、Claudeには対象者、出典、尺、形式、必須の展開、事実上の境界が与えられます。「かっこいい製品動画を作って」より、はるかにレビューしやすくなります。

04

30秒テストで起きたこと

最初の制御テストでは、2026年8月7日に MCP と API の接続先 `https://tapvid.ai/api-mcp` でワークフローを実行しました。アカウントのメールアドレスを公開せず、アカウント確認で利用可能量を確認しました。URL のアップロードは約0.4秒、`create_video` は約0.3秒でキュー入りしたジョブを返しました。約28分20秒後に完了し、アカウント使用量は90クレジット増えました。記事改訂時の2回目は、Markdown の完全な原稿をアップロードし、字幕付きの30秒、16:9の英語要約を指定しました。GMT+8の21:24:33にキューへ入り、21:53:04、約28分30秒後に完了しました。ステータス確認の1回で一時的な通信エラーが発生しましたが、回数を制限した再試行で成功しました。1日の使用量は180から270クレジットへ増え、差分は再び90クレジットでした。TapVid Studio には `Video ready`、0:30のプレーヤー、字幕、透かし入りの出力が表示されました。

その結果は、数値を洗練された成功事例に置き換えるよりも有用です。 それは、進捗が線形の時計ではなく、「50%」が残りの時間が経過時間と等しいことを意味するわけではないことを示しています。 Claude ワークフローは `pollAfterSeconds` を尊重し、適切な全体タイムアウトを使用し、ビデオ ID を保持し、最後に既知の状態をユーザーに報告すべきです。 世代が始まったからといって、完了を宣言すべきではありません。 ダウンロードツールは、完了した状態の後に属すべきであり、推測された待機期間の後ではありません。

05

MCPエラーの切り分け

最初のアカウント呼び出しでも、再試行が成功する前にMCPエンドポイントへの一時的なトランスポート失敗が発生しました。 一時的な接続エラー、認証エラー、無効なマテリアル、サポートされていない列挙値、クレジット不足、長時間実行されるジョブは、異なる応答を必要とします。 すべての失敗を再度試みることは安全ではありません。 境界付きバックオフでネットワーク障害を再試行してください。 再呼び出しする前に、拒否された引数を修正してください。 不足したクレジットで停止してください。 重複を作成する代わりに、受け入れられたジョブのポーリングを継続してください。 ジョブが通常のインタラクティブウィンドウを超えてアクティブな状態を保持した場合、ユーザーに表示します。

よくある高くつくミスは、応答がないことを作成呼び出しの失敗だと判断してしまうことです。サーバーがリクエストを受理した後にクライアントの接続が切れた場合、同じ動画を再送信するとクレジットを二重に消費するおそれがあります。返された素材IDと動画IDは、ワークフローを管理するアプリケーションに直ちに永続保存してください。対話セッションでは、次の書き込みを許可する前に、ステータス確認など最後に安全に実行した読み取り操作をClaudeに繰り返させます。本番コードでは、独自の冪等性レコードをリクエストに紐づけ、認証情報を含めずにサーバー応答を記録してください。

06

公開前に映像を確認する

完了したエクスポートは、まだ編集上の審査が必要です。 ナレーションと画面上のテキストをソースページと比較してください。 シーンが約束された順序でワークフローを説明しているか確認してください。 30秒のブリーフが実際に30秒に近いことを確認してください。 意図したアスペクト比で、キャプションと主要なUI参照を検査してください。 音楽と動きが理解力を支えていることを確認してください。 生成されたファイルは、チェックが通るまでドラフトとして扱ってください。 Claudeはチェックリストの作成や違いの要約を支援できますが、創作者に対する法的、事実的、またはブランド上の責任は受け入れられません。

• 事実が資料にある。
• シーン順が正しい。
• 長さが指示に近い。
• 16:9で文字が読める。
• 権利とブランドを確認。
• 人が公開を承認。

07

会話はMCP、本番コードはREST

MCPは、作業が探索的で会話的であるときに最も強力です。 Claudeに情報源を提供し、利用可能なツールの説明を依頼し、ブリーフを洗練させ、シーケンスを実行し、同じスレッドで失敗について議論することができます。 RESTは、製品が安定したコード、耐久性のあるジョブストレージ、明示的なリトリト、メトリクス、そしてキューやWebhookとの統合を必要とする場合に、より強力になります。 両方のパスは同じ基礎となる職種に到達します。 違いは、オーケストレーションを所有する者です。MCP セッションの AI クライアント、または REST コード内のアプリケーションです。

ソロクリエイターやプロダクトマーケターにとって、実用的な手順は、MCP を通じてプロンプトと受諾チェックリストのプロトタイプを作成し、その後、繰り返し可能な大量ジョブを REST に移行することです。 エンジニアリングチームにとって、REST は通常、本番環境のパスであり、MCP はデバッグ、内部運用、そして支援実験に適しています。 MCPは新しいように聞こえるので、選択しないでください。 自然言語による計画やインタラクティブツールの使用が実際の作業を減らすときは、それを選択してください。 決定論的制御、永続性、観測性がより重要になると、REST を選択してください。

08

キーとクレジットを守る

API Keyはcreditsと所有リソースへアクセスします。プロンプト、画像、Issue、ソースに入れません。読み取り、生成、公開を分け、MCPセキュリティガイドも確認します。

• キーをsecret storeに置く。
• キー、email、ID、signed URLを公開しない。
• 読み取りと課金を分ける。
• 受付IDを即保存する。
• 再試行を制限する。
• headerなしで状態を記録する。

09

一つの資料と測定可能な目標から始める

優れた最初のClaudeビデオ生成プロジェクトは、検査できるほど小規模でありながら、全体のワークフローを公開できるほど完成しています。 承認された記事または製品ページを1つ、対象者を1つ、メッセージを1つ、アスペクト比を1つ、30秒の期間を選択してください。 Claudeに、作成前に計画されたツール呼び出しを述べるよう依頼してください。 アップロードの応答、受理されたジョブ、ステータス遷移、クレジット、および端末結果を記録してください。 それから、単に印象的に見えるかどうかを尋ねるのではなく、出力をソースと見直してください。 公開の TapVid API・MCP概要 から開始し、最初の実験は意図的に絞り込むことができます。

10

Frequently asked questions