AI動画生成MCPサーバー

VidFlux動画MCPサーバーとは？

Model Context Protocol（MCP）は、AIアシスタントが外部ツールを呼び出すためのオープン標準です。VidFlux MCPはホスティング済みのエンドポイントで、テキストから動画、画像から動画、モーションコントロールの生成ジョブの開始、進捗の確認、完成したMP4の取得といった動画生成ツールをAIアシスタントに提供します。プロンプト作成、モデル・尺・アスペクト比の選択、レンダリング完了の待機までアシスタントが行い、チャットやエディタを離れずにファイルを受け取れます。

エンドポイントの裏側ではvidflux.aiの動画生成と同じ仕組みが動いているため、モデルのバージョン、料金、返還ルールはすべて同じです。各タスクはアカウントの履歴にも表示されます。

対応しているAI動画モデル

model引数にモデルIDを指定します。クレジットはデフォルト設定時の料金で、尺が長い・解像度が高い・音声ありの場合は高くなります。dry_runを使えば任意の設定の正確な料金がわかります。

キーフレーム・サムネイル用の画像モデル

開始フレーム、商品画像、サムネイルを作成・編集し、上の画像から動画モデルで動かせます。

クイックスタート：3ステップで接続

1. VidFluxにログインし、「設定 → API & MCP」でAPIキーを作成します。新規アカウントには無料のお試しクレジットが付きます。
2. 下の設定例を使って、お使いのAIクライアントにサーバーを追加します。
3. 動画を頼むだけです。例：「Seedance 2でラテアートを注ぐ5秒・9:16のスローモーション動画を作って、./assetsに保存して」

MCPクライアントの設定

vf_your_api_keyをご自身のキーに置き換えてください。環境変数に対応したクライアントでは、設定ファイルに直接書かずVIDFLUX_API_KEYに保存するのがおすすめです。

Claude Code

claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \
  --header "Authorization: Bearer vf_your_api_key"

# verify
claude mcp list

Claude Desktop

Claude DesktopからAPIキー付きでリモートサーバーに接続するにはmcp-remoteを使います（Node.jsが必要）。claude_desktop_config.jsonを編集してClaudeを再起動します：

{
  "mcpServers": {
    "vidflux": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vidflux.ai/api/mcp",
        "--header", "Authorization: Bearer vf_your_api_key"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json（全プロジェクト）または.cursor/mcp.json（プロジェクト単位）に追加します：

{
  "mcpServers": {
    "vidflux": {
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

OpenAI Codex CLI

export VIDFLUX_API_KEY=vf_your_api_key
codex mcp add vidflux --url https://vidflux.ai/api/mcp \
  --bearer-token-env-var VIDFLUX_API_KEY

VS Code (GitHub Copilot agent mode)

.vscode/mcp.jsonに追加します：

{
  "servers": {
    "vidflux": {
      "type": "http",
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.jsonに追加します：

{
  "mcpServers": {
    "vidflux": {
      "serverUrl": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Cline、Roo Codeなどその他のクライアント

カスタムヘッダー付きのStreamable HTTPサーバーに対応したクライアントなら、同じURLとヘッダーで接続できます。stdioのみ対応のクライアントは、Claude Desktop向けのmcp-remoteの設定を使ってください。

MCPツール

動画生成は非同期です。エージェントの典型的な流れは次のとおりです：

list_models            → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
                duration: 5, dry_run: true}
                       → {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
                       → {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."}   (every 15 s)
                       → {"status": "completed", "video_url": "https://...mp4"}

料金：従量課金のクレジット制

• サーバーへの接続と、list_models・get_task・get_creditsの呼び出しは無料です。
• 動画1本あたりの消費クレジットはvidflux.aiと同じです（上の表を参照）。クレジットパックは500クレジット4.98ドルからで、大きいパックほど割安になり、購入したクレジットに有効期限はありません。
• dry_run: trueを付けると、生成せずに引数の検証と正確な料金、残高が足りるかどうかを返します。
• 失敗したタスクや拒否されたタスクのクレジットは自動で返還されます。

クレジットパックとプランを見る

こんな使い方ができます

VidFlux MCP・各社公式API・セルフホストMCPの比較

トラブルシューティング

接続済みと表示されるのに動画ツールが出てこない

クライアントを再起動するかMCPサーバーを再読み込みし、Agentモードになっているか確認してください（Cursor、VS Code）。Claude Codeでは/mcpでツール一覧を確認できます。

401 Unauthorized、「Missing or invalid API key」と表示される

ヘッダーは正確にAuthorization: Bearer vf_…である必要があります。キーが無効化されていないか、余分な引用符やスペースが入っていないか確認してください。

402 INSUFFICIENT_CREDITSと表示される

残高がdry_runで返された料金より少ない状態です。クレジットを追加するか、より短い・低解像度・安価なモデルを選んでください。

動画がprocessingのまま長時間終わらない

ほとんどの動画は1〜5分で完成しますが、Seedance 2.5の長尺や4KのGemini Omniはさらに時間がかかります。get_taskで確認を続けてください。失敗した場合はエラーが返り、クレジットは返還されます。

Claude Desktopでspawn npx ENOENTと表示される

mcp-remoteにはNode.js 18以上が必要です。Node.jsをインストールするか、commandにnpxのフルパスを指定してください。

参照画像がエラーになる

image_urlsには、公開されているHTTPSの画像URL（JPG、PNG、WebP）を指定してください。ローカルのファイルパスやログインが必要なリンクは読み込めません。

よくある質問