zzo.ai MCP:Claude Code・Codex・Cursorなど手元のAIエージェントから画像と動画を生成
zzo.aiをパソコンで動くAIエージェントにつなぐと、チャットから動画や画像の生成を頼めます。クレジット残高も料金もサイトと同じで、呼び出しごとの追加料金もサブスクもありません。
https://zzo.ai/api/mcp実際のやりとり
アシスタントが料金を確認し、実行してよいかを尋ねてから生成します。動画はワークスペースにも保存されます。

やりとりの一例です。言い回しはアシスタントによって変わりますが、ツールと料金は実際のものです。
3ステップで接続
- 1
APIキーを作成
「設定 → APIキー」でキーを作成します。sk_で始まるキーが表示されるので、すぐにコピーしてください。
キーを作成 - 2
エージェントに設定を任せる
下のプロンプトをコピーし、sk_your_keyを自分のキーに置き換えてエージェントに送ります。アプリ用の設定を自分でコピーしてもかまいません。
- 3
再起動して、頼む
エージェントに言われたらアプリを再起動し、たとえば「zzo.aiで、夕暮れの灯台を5秒・720pの動画にして。先に料金を教えて。」のように頼みます。
エージェントに送る設定プロンプト
Claude Code、Codex、Cursor、GitHub Copilotなど、パソコン上のファイルを編集できるエージェントで使えます。キーはパソコン内のエージェント自身の設定に書き込まれ、プロジェクトには入りません。
zzo.aiのMCPサーバーをあなたの設定に追加して、zzo.aiで動画や画像を作れるようにしてください。 - サーバーURL:https://zzo.ai/api/mcp(リモートMCPサーバー、Streamable HTTP) - すべてのリクエストに付けるヘッダー:Authorization: Bearer sk_your_key - サーバー名:zzo 1. これは私のパソコンで動いているエージェント専用です。クラウド(Webのチャットやクラウドのサンドボックス)で動いている場合は、何も変更せずにそう伝えてください。 2. 上のキーがsk_your_keyのままなら、先に私のキーを聞いてください。 3. あなたのアプリのドキュメントどおりに追加してください。専用のコマンドがあればそれを使い、なければMCPの設定ファイルに書きます。すでにあるサーバーは残してください。 4. プロジェクトのフォルダー内のファイルではなく、ユーザー単位(グローバル)の設定に書いてください。キーがgitリポジトリに入らないようにするためです。キーをほかの場所に書いたり、もう一度表示したりしないでください。 5. 再起動が必要なら教えてください。zzoのツールが使えるようになったら、get_balanceで接続を確認してください(クレジットは使いません)。私が頼むまでgenerateは呼ばないでください。
自分で設定する
ターミナルで実行します。--scope user を付けるとすべてのプロジェクトで使え、キーがリポジトリに入りません。
claude mcp add --transport http --scope user zzo https://zzo.ai/api/mcp \ --header "Authorization: Bearer sk_your_key"
パソコン上で動き、Authorizationヘッダー付きのStreamable HTTPでリモートMCPサーバーに接続できるエージェントなら、同じ方法で使えます。上のサーバーURLと、ヘッダーAuthorization: Bearer sk_your_keyを設定してください。
ツール
ツールは5つです。クレジットを消費するのはgenerateだけで、ほかの4つは消費しません。
list_models使えるモデルと、それぞれのモード・オプション、最低料金(クレジット)。
消費なしestimate_cost実行する前に、生成の料金をクレジットとドルで確認し、残高で足りるかどうかを返します。
消費なしgenerate動画または画像の生成を開始し、そのクレジットを消費します。タスクIDをすぐに返します。
クレジットを消費get_generation生成の状態と、結果のリンク。アシスタントは完了するまで約10秒ごとに確認します。
消費なしget_balance残高、今日キーで使ったクレジット、1日の上限。
消費なし- 1回のリクエストで使うのは最大1,500クレジットです。
- キー全体で使えるのは1日(UTC)最大3,000クレジットです。アカウントごとに、これより低く設定できます。
- 同時に実行できる生成は最大5件です。
- 失敗した生成のクレジットは、サイトと同じく自動で戻ります。
よくある質問
MCP経由だと、生成の料金は高くなりますか?
いいえ。料金はサイトと同じで、同じクレジット残高から消費されます。
残高がなくなるとどうなりますか?
generateツールが料金ページへのリンク付きのエラーを返し、クレジットは消費されません。クレジットパックを購入してから、もう一度お試しください。クレジットに有効期限はありません。
自分の画像を動かせますか?
はい。画像の公開https URLをアシスタントに渡してください。MCP経由でファイルを直接アップロードすることには、まだ対応していません。
キーが漏れたらどうすればいいですか?
「設定 → APIキー」で削除すると、そのキーはすぐに使えなくなります。削除するまでの間も、1日の上限によってキーが使える量は制限されています。
ChatGPTやClaude.ai、クラウドのエージェントでも使えますか?
まだ使えません。現在はClaude Code、Codex、Cursor、VS CodeのGitHub Copilot、Claude Desktopなど、自分のパソコンで動くAIエージェント向けです。ChatGPT、ClaudeのWeb版とモバイルアプリ、クラウドで動くエージェントは、APIキーでは接続できません。