The short version
公開URL、実際の5ツール、30秒の指示、正直な本番テストを使った実践ガイドです。
Claudeは制作を調整できますが、映像そのものをレンダリングしません。TapVid MCPへ接続し、公開API/MCPページを資料として30秒、16:9、英語の説明動画を依頼しました。重要なのはツール順序、非同期状態、人の確認です。
Review TapVid API and MCP access
01
Claudeが調整し、TapVidがレンダリングする
ここでの「Claude video generation」は、Claudeがフレームを描きMP4を書き出す意味ではありません。Claudeは目標を理解し、構造化ツールを呼び、結果を観察します。TapVidが資料を処理し、シーンを組み、レンダリングします。MCPは両者の接続層です。
TapVidは記事、文書、台本、PDF、PRD、商品ページなど既存コンテンツを構造化された情報動画に変えます。資料が事実を、指示が対象者と制約を与えます。精度、権利、テンポ、公開は人が承認します。一つのシーンだけを再生成し、残りを維持できます。
埋め込み動画はMotionによる外部のMotion MCP参考例であり、今回のTapVid実測結果ではありません。検証済みのTapVid証拠は後のスクリーンショットと時間記録に示します。
02
Bearer API KeyでClaudeを接続する
現在の公開設定はRESTとMCPで同じBearer API Keyを使います。API Keysで作成し、安全に保存し、Claudeをhttps://mcp.tapvid.ai/mcpへ接続します。最初に`get_account`で接続と残高を確認します。
- `/developer/apikey`でキーを作り安全に保存する。
- `https://mcp.tapvid.ai/mcp`とBearer headerをClaudeに追加する。
- `get_account`で接続とcreditsを確認する。
- `upload_material`で承認済みHTTPS URLを入れる。
- 長さ、画角、言語、対象、禁止事項を決めてから作成する。
03
実際に確認したMCPツール
計測したcreate-and-export workflowでは5ツールを使用しました。現在のconnectorには`edit_video`もありますが、この6番目のtoolは計測テストでは呼びませんでした。
| ツール | 役割 | 注意 |
|---|---|---|
| `get_account` | 接続確認 | emailを隠す |
| `upload_material` | URLを取り込む | private ID |
| `create_video` | ジョブ開始 | private ID |
| `get_video_status` | 状態確認 | intervalを守る |
| `get_video_download` | 書き出し | 期限付きURL |
| `edit_video` | completed videoを編集 | 計測では未使用 |
指示には30秒、16:9、英語、開発者、TapVidページを資料にすること、素材から非同期生成、ダウンロードまでを示すこと、実績や機能を捏造しないことを含めました。
04
30秒テストで起きたこと
2026年8月7日のテストでは、URLアップロードは約0.4秒、`create_video`は約0.3秒でした。約60秒でrunning 50%となり、18分以上続いた後、約28分20秒でcompletedになりました。最初のexportは36秒間recordingでしたが、後の確認でsigned URLが返りました。使用量は90 credits増えました。
進捗率は直線的な時計ではありません。`pollAfterSeconds`を守り、video IDを保存し、全体タイムアウトを設け、最後の状態を伝える必要があります。completed前にダウンロード完了と判断してはいけません。
05
MCPエラーの切り分け
最初のアカウント呼び出しでは一時的なtransport errorも起きました。ネットワーク、認証、引数、credits、長時間ジョブは別々に処理します。読み取りの一時障害だけを制限付きで再試行します。
| 症状 | 層 | 対応 |
|---|---|---|
| 通信失敗 | network | 読み取りのみ制限再試行 |
| 401 | key | secret確認 |
| 400 | arguments | 値を修正 |
| credits不足 | account | 停止 |
| 50%が続く | async job | ID、interval、timeoutを維持 |
応答が消えたからcreateが失敗したとは限りません。受付済みなら再作成で二重課金になります。material IDとvideo IDは次の通信より先に永続化します。
06
公開前に映像を確認する
完成ファイルも下書きです。資料との一致、シーン順、実時間、字幕、画角、音楽、権利、CTAを確認します。Claudeはチェックを支援できますが、公開責任は持ちません。
- 事実が資料にある。
- シーン順が正しい。
- 長さが指示に近い。
- 16:9で文字が読める。
- 権利とブランドを確認。
- 人が公開を承認。
07
会話はMCP、本番コードはREST
MCPは会話しながら試す作業に向き、RESTは永続状態、再試行、指標、キュー、定期実行に向きます。違いは生成ではなく、オーケストレーションを誰が持つかです。
| 必要 | MCP | REST |
|---|---|---|
| 試行 | 最適 | 手動 |
| 対話診断 | 最適 | UIが必要 |
| 永続状態 | session依存 | app所有 |
| 再試行と指標 | client依存 | program可能 |
| 大量処理 | 標準ではない | 最適 |
プロンプトと受け入れ条件はMCPで試し、繰り返す処理はRESTに移すのが実用的です。新しさではなく、対話と決定性のどちらが必要かで選びます。
08
キーとクレジットを守る
API Keyはcreditsと所有リソースへアクセスします。プロンプト、画像、Issue、ソースに入れません。読み取り、生成、公開を分け、MCP security guidanceも確認します。
- キーをsecret storeに置く。
- キー、email、ID、signed URLを公開しない。
- 読み取りと課金を分ける。
- 受付IDを即保存する。
- 再試行を制限する。
- headerなしで状態を記録する。
09
一つの資料と測定可能な目標から始める
承認済みの一ページ、一対象、一メッセージ、16:9、30秒から始めます。Claudeにツール順を説明させ、状態とcreditsを記録し、見た目ではなく資料との一致を評価します。TapVid API/MCP overviewから始められます。
10
Frequently asked questions
Claudeだけで動画を作れますか？
Claudeは計画とツール呼び出しを行い、TapVidがレンダリングします。
使えたツールは？
現在のconnectorにはget_account、upload_material、create_video、get_video_status、get_video_download、edit_videoがあります。計測では最初の5つを使いました。
OAuthですか？
今回の公開設定はBearer API Keyです。実装前に最新文書を確認してください。
なぜpollしますか？
生成は非同期です。pollAfterSecondsを守りterminal statusまで確認します。
RESTを使う場面は？
永続状態、定期処理、再試行、指標が必要な本番アプリです。
Kenneth Chen が、Discord で動画クリエイター仲間との会話にあなたを招待しています。
Discord で Kenneth に参加Turn them into a clear, publishable video
Keep reading
Related stories
Claude動画生成：Seedance 2.5とTapVidの使い分け
Claudeだけでは動画を書き出せません。Seedance 2.5とTapVidの使い分けを、実測結果と再利用できるプロンプト付きで解説します。
Aug 8, 2026
Text-to-Video API: 10分で組み込むチュートリアル
約10分でREST連携を組み、レンダリングは永続状態を持つ非同期ジョブとして扱います。
Aug 7, 2026
解説動画(エクスプレイナービデオ)とは？種類・用途・作り方
解説動画とは？プロダクトやアイデアを素早く伝える短い動画です。種類、それぞれの使いどころ、作り方を解説します。
Jul 17, 2026