Future Video Studio

Future Video Studio MCP

Future Video Studio MCP を使うと、エージェントは Future Video Studio Agent API を通じて、映画のような AI 動画のレンダリングを作成、監視、キャンセル、ダウンロードできます。

ホスト型 MCP サーバーは次の場所で利用できます。

https://mcp.future.video/mcp

同じサーバーは、この Python パッケージから stdio 経由でローカル実行することもできます。

ホスト型サービスは、ChatGPT Apps のドメイン検証エンドポイント https://mcp.future.video/.well-known/openai-apps-challenge も提供します。送信ダッシュボードでチャレンジ本文の完全一致が必要な場合にのみ、OPENAI_APPS_CHALLENGE_RESPONSE を設定してください。

ChatGPT アプリ

ホスト型 MCP サーバーは、開発者モードで ChatGPT アプリとして接続する準備も整っています。

Connector URL: https://mcp.future.video/mcp
App manifest:  https://mcp.future.video/chatgpt-app.json
Widget URI:    ui://future-video-studio/render-console-v1.html

このアプリは、ChatGPT 内に小規模なレンダリングコンソールを表示します。レンダリングの準備、アカウントウォレットを使ったジョブの送信、アカウント不要の Link 従量課金レンダリング見積もりの作成、ステータスの確認、支払いリンクの表示、FVS が署名付きの final_video_url を返した場合の完成動画の表示ができます。

ChatGPT コネクターの設定：

• アカウントモード：X-FVS-Agent-Key をシークレットのコネクターヘッダーとして追加します。
• 従量課金レンダリングモード：X-FVS-Agent-Key を設定しないか、X-FVS-Billing-Mode: pay-per-render を設定します。
• マーケットプレース連携モード：アカウント連携ゲートウェイから取得した署名付きの X-FVS-Marketplace-* ヘッダーを使用します。

ChatGPT で開発者モードを有効にし、コネクターを作成して、コネクター URL に https://mcp.future.video/mcp を指定します。ツールのメタデータでは、MCP Apps の ui.resourceUri フィールドと ChatGPT の openai/outputTemplate 互換フィールドを使って、レンダリングツールを FVS ウィジェットに関連付けています。

A2A / Gemini Enterprise プレビュー

ホスト型サービスは、Google Cloud Marketplace / Gemini Enterprise Track 3 向けの初の A2A 互換ラッパーも提供します。

https://mcp.future.video/.well-known/agent-card.json
https://mcp.future.video/message:send
https://mcp.future.video/tasks/{task_id}
https://mcp.future.video/tasks/{task_id}:cancel

A2A レイヤーでは、MCP サーバーと同じ X-FVS-Agent-Key アカウント認証情報、マーケットプレース連携アカウントヘッダー、または有料見積もりモードを使用します。message:send リクエストには、プレーンテキストのブリーフパートまたは構造化された fvs_render_request データパートを含められます。アカウントおよびマーケットプレース経由の送信では FVS Agent API のレンダリングが作成され、id が FVS の project_id である A2A タスクが返されます。有料見積もりの送信では HTTP 402 と、id が quote_id である A2A タスクが返されます。返された Link/Stripe MPP の payment_url で支払いを済ませた後、/tasks/{quote_id}?claim_token=... をポーリングしてください。

Agent Card では、公式 MCP レジストリ名 video.future/future-video-studio を通知します。そのため、エンタープライズエージェントは A2A 委任インターフェースとホスト型 MCP ツールの両方を確認できます。

課金方法

• アカウントモード：X-FVS-Agent-Key または FVS_AGENT_API_KEY を指定します。レンダリング料金は、Web アプリと同じクレジットモデルおよび保存済みのパイプライン既定値に基づいて、所有者の Future Video Studio アカウントウォレットに請求されます。
• マーケットプレース連携モード：連携済みのマーケットプレース顧客を示す X-FVS-Marketplace-Account を指定します。本番環境では、アカウント連携ゲートウェイから取得した X-FVS-Marketplace-Entitlement、X-FVS-Marketplace-Timestamp、X-FVS-Marketplace-Signature も設定してください。MCP サーバーはマーケットプレースアカウントを保存済みの FVS Agent API キーに対応付け、連携済みウォレットに請求します。
• 従量課金レンダリングモード：アカウント認証情報を省略するか、X-FVS-Billing-Mode: pay-per-render を設定します。サーバーは Link/Stripe MPP の支払い見積もりを返し、その後、エージェントが結果を取得できるようクレームトークン付きのステータス URL を提供します。

エージェントは、ウォレットに請求されるアカウントレンダリングを送信する前に、ユーザーから明示的な承認を得てください。

セキュリティ設定

マーケットプレースアカウントのマッピングは、MCP のデプロイ環境で環境変数を使って設定します。

$env:FVS_MARKETPLACE_MODE = "optional"
$env:FVS_MARKETPLACE_SHARED_SECRET = "replace-with-random-secret"
$env:FVS_MARKETPLACE_REQUIRE_SIGNATURE = "true"
$env:FVS_MARKETPLACE_ACCOUNT_KEYS_JSON = '{"acct_google_123":{"api_key":"fvs_live_replace_me","entitlement_id":"ent_123","plan":"starter","status":"active"}}'

マーケットプレース署名は、次の内容に対する HMAC-SHA256 です。

{unix_timestamp}.{marketplace_account_id}.{marketplace_entitlement_id}

X-FVS-Marketplace-Signature: sha256=<hex> として送信します。既定のタイムスタンプ許容時間は 300 秒です。FVS_MARKETPLACE_SIGNATURE_MAX_SKEW_SECONDS で変更できます。

Cloud Run の本番デプロイでは、FVS_MARKETPLACE_SHARED_SECRET_SECRET と FVS_MARKETPLACE_ACCOUNT_KEYS_JSON_SECRET を scripts/deploy_mcp_cloud.ps1 に渡してください。これにより、HMAC シークレットとアカウントキーのマッピングを平文の環境変数ではなく Secret Manager から取得できます。

ツール

• fvs_submit_render：レンダーリクエストを送信します。公開アセットの URL も指定できます
• fvs_create_paid_render_quote：アカウント不要の Link 決済見積もりを作成します
• fvs_get_render_status：project_id または status_url でレンダーのステータスを確認します
• fvs_get_paid_render_status：status_url、または quote_id と claim_token で有料レンダーのステータスを確認します
• fvs_cancel_render：project_id または cancel_url でレンダーをキャンセルします
• fvs_download_final_video：署名付き URL から完成したレンダーを保存します
• fvs_example_render_request：シーンのレンダーリクエストのペイロード例を返します
• fvs_open_chatgpt_app：レンダーを作成せずに ChatGPT アプリウィジェットを開きます

完成したレンダーのダウンロード

fvs_download_final_video は、完成したレンダーについて fvs_get_render_status または fvs_get_paid_render_status が final_video_url を返した後にのみ使用してください。 署名付き URL の有効期限が切れた場合は、該当するステータス確認ツールを再度呼び出して更新してください。

ダウンロードツールは次の処理を行います。

• 署名付き final_video_url に対して、認証なしの HTTPS GET を実行します
• 動画データを MCP サーバーのローカルファイルシステム上の output_path に書き込みます
• 存在しない親ディレクトリを作成します
• overwrite が true でない限り、既存ファイルの置き換えを拒否します
• FVS_AGENT_API_KEY は必要ありません
• ウォレットのクレジットを消費したり、レンダーを作成したり、ジョブをキャンセルしたり、リモート状態を変更したりすることはありません
• 大きな動画では数分かかる場合があり、リクエストのタイムアウトは 600 秒です

パラメーター：

• final_video_url：完成したレンダーのステータスレスポンスで返される、絶対 HTTPS 署名付き URL です。任意または信頼できない URL は渡さないでください。
• output_path：C:/Users/me/Videos/fvs-result.mp4 や /tmp/fvs-result.mp4 など、MCP サーバープロセスから参照できるローカルパスです。
• overwrite：デフォルトは false です。保存先ファイルを置き換える場合にのみ true に設定してください。

リモート MCP の設定

アカウントモード：

{
  "mcpServers": {
    "future-video-studio": {
      "url": "https://mcp.future.video/mcp",
      "headers": {
        "X-FVS-Agent-Key": "fvs_live_replace_me"
      }
    }
  }
}

レンダーごとの従量課金モード：

{
  "mcpServers": {
    "future-video-studio": {
      "url": "https://mcp.future.video/mcp"
    }
  }
}

マーケットプレイス連携モード：

{
  "mcpServers": {
    "future-video-studio": {
      "url": "https://mcp.future.video/mcp",
      "headers": {
        "X-FVS-Billing-Mode": "marketplace-linked-account",
        "X-FVS-Marketplace-Account": "acct_google_123",
        "X-FVS-Marketplace-Entitlement": "ent_123",
        "X-FVS-Marketplace-Timestamp": "<unix_timestamp>",
        "X-FVS-Marketplace-Signature": "sha256=<hmac>"
      }
    }
  }
}

ローカルインストール

python -m pip install future-video-studio-mcp
python -m fvs_mcp_server

ローカルの stdio MCP 設定例：

{
  "mcpServers": {
    "future-video-studio": {
      "command": "python",
      "args": ["-m", "fvs_mcp_server"],
      "env": {
        "FVS_AGENT_API_KEY": "fvs_live_replace_me",
        "FVS_AGENT_BASE_URL": "https://app.future.video"
      }
    }
  }
}

FVS_AGENT_API_KEY は任意です。従量課金の見積もりモードを使用する場合は、設定せずにおきます。 FVS_AGENT_BASE_URL のデフォルトは https://app.future.video です。

ローカル開発

python -m pip install -e ".[dev]"
python -m pytest
python -m fvs_mcp_server

HTTP トランスポートをローカルで実行します。

$env:FVS_MCP_TRANSPORT = "streamable-http"
python -m fvs_mcp_server

公開

パッケージをビルドして確認します。

python -m build
python -m twine check dist/*

このパッケージは、次の名前で PyPI に公開することを想定しています。

future-video-studio-mcp

MCP Registry のパッケージ検証マーカーは、この README の上部付近にある非表示コメントです。

リンク

• Future Video Studio：https://future.video
• Agent API ドキュメント：https://future.video/api-docs
• ホスト型 MCP マニフェスト：https://mcp.future.video/server.json
• MCP Registry の公式名称：video.future/future-video-studio