VIVID AI Studio

vivid-mcp

VIVID 用の MCP サーバーです。E コマース向け AI コンテンツスタジオである VIVID のアカウントを Claude Desktop、Claude Code、Cursor、または任意の Model Context Protocol クライアントに接続して、チャットから画像や動画を生成したり、ギャラリーを閲覧したり、ジョブを管理したりできます。

できること

ツール	機能
vivid_whoami	キーにリンクされたアカウントのプランとクレジットを確認します
vivid_usage	月間の使用量とプランの上限を確認します
vivid_buy_credits	ユーザーがクレジットパックを購入したり、自動チャージを有効にしたりするためのリンクです。エージェントが支払うことはなく、ユーザーがブラウザーで確定します
vivid_list_models	画像／動画／LLM のモデルと、価格および機能を一覧表示します
vivid_generate_image	テキストから画像を生成します（任意で製品／人物／コンテキストを参照できます）。結果が出るまで待機します
vivid_generate_video	動画の生成を開始します（Seedance 2.5、Kling O3、MiniMax H3、Gemini Omni、LTX、Grok…）
vivid_job_status	ジョブの状態を確認し、アセットとダウンロード URL を取得します
vivid_list_jobs	最近の生成結果を一覧表示します
vivid_list_assets · vivid_get_asset	ギャラリーを閲覧します
vivid_download_asset	アセットをローカルフォルダーに保存します
vivid_share_asset	アセットを公開して共有リンクを取得し、お気に入りを切り替えます
vivid_upload_file	ローカルファイルまたは URL をアップロードし、参照／開始フレーム／音声として使用します
vivid_list_references	保存済みの製品（製品分析から作成）と、名前および ID 付きの推薦者／キャラクターを一覧表示します。vivid_generate_image の products／testimonials では名前を使用します。アプリでの #Product／@Testimonial に相当します
vivid_analyze_product · vivid_create_testimonial	写真から製品を保存する（無料、プランの上限を消費）か、3 枚の写真または属性から再利用可能な推薦者を作成します（50 クレジット）。どちらも作成後は名前で使用できます
vivid_list_voices	TTS プロバイダーと、クレジットコスト付きのプリセット音声を一覧表示します
vivid_chat	VIVID の LLM ルーティング（Grok、Claude、OpenAI GPT、Kimi（Wavespeed））でチャットを 1 回実行します
vivid_generate_music · vivid_music_status · vivid_list_music_providers	簡単な説明からオリジナルのトラックを生成します。Suno V6（デフォルト。2 テイクで 6 クレジット、インストゥルメンタルは指定した長さどおり）または MiniMax Music 3.0（14 クレジット。長さは目安で、エディターでトリミングできます）を使用します。ボーカルは任意で、生成完了時に課金されます。レンダリングには 20 秒～3 分かかります。ツールは waitSec まで待機し、その後 vivid_music_status 用の taskId を返します
vivid_analyze_audio	音楽／音声ファイルのテンポ（BPM、ビートグリッド）とトランジェントピークをサーバー側で計算します（無料）。ダイナミックなモンタージュのカットポイントを取得できます。また、CUT_TO_BEAT で自動的に使用されます（グリッドは beats | peaks）
vivid_search_sounds	Freesound.org で既存の音楽、ループ、効果音を検索します（無料）。デフォルトでは商用利用に安全なライセンス（CC0、CC BY）のみを対象とし、CC BY 用のクレジット表記も用意します。タイムラインに追加できる MP3 プレビュー URL を返します
vivid_transcribe	音声のテキスト変換（Deepgram Nova-3、無料）を行います。単語ごとのタイムスタンプ、読みやすい字幕、SRT／VTT エクスポートに対応し、アセット、URL、ローカルファイルを入力できます
vivid_retouch	画像内のオブジェクトを 1 つ編集します（テキストによる対象指定、領域指定、またはマスク）。それ以外はバイト単位で変更されません。2～6 クレジット
vivid_compare_product	レンダリング結果と SKU 写真を視覚的に品質チェックします。一致スコア、判定、差異、修正用プロンプトを返します。1 クレジット
vivid_product_sheet	保存済み製品の参照シートと、新規作成時の価格を読み取ります（無料）
vivid_create_product_sheet	参照シートを作成します。正面、2 つの角度、着用時の各画像を実際の写真と照合します（無料の再試行は 1 回。再試行後も失敗した場合は返金）。13 クレジット。無料プランでは最初の 1 回は無料です
vivid_generate_voice	テキストから音声を生成します。Gemini 3.1 Flash のプリセット、MiniMax Speech 2.8 HD（プリセット、感情、アカウント所有者が音声の所有権を確認したうえで VIVID ウェブアプリに保存した音声）、OmniVoice の音声デザイン、Deepgram に対応します。音声ファイルや URL から音声をクローンすることはできません
vivid_list_projects	プロジェクトを一覧表示します
vivid_list_editor_projects	保存済みの動画エディターのタイムラインを一覧表示します
vivid_create_editor_project · vivid_get_editor_project · vivid_edit_timeline	ウェブエディターと同じエンジンを使い、ヘッドレスで動画エディターのタイムライン（クリップ、トリミング、速度、トランジション、16:9↔9:16、テキスト、マスク、キーフレーム）を作成・編集します。タイムラインの編集を参照してください
vivid_render_project · vivid_render_status	エディタープロジェクトの MP4 レンダリングをキューに入れ、状態を確認します（下記のレンダリングを参照）
vivid_record_ui	ローカルの Chromium を使って、vividai.tv（または任意のサイト）のスクリプト付き操作を画面録画します。カーソル、滑らかな動き、クリック時の波紋を記録し、動画アセットとしてアップロードします（下記のUI 録画を参照）

セットアップ

1. API キーを取得します。vividai.tv にサインインし、Settings → API key を選択します。
2. クライアントを接続します。次の3つの方法から1つを選んでください。

	方法	Node が必要？	ローカル専用ツール（vivid_download_asset、vivid_record_ui、ローカルパス）
リモート	https://mcp.vividai.tv/mcp + Authorization: Bearer vk_…	いいえ	いいえ
コネクター（Claude.ai）	OAuth を使用して https://mcp.vividai.tv/mcp に接続 — キーの貼り付けは不要	いいえ	いいえ
コネクター（ChatGPT）	OAuth を使用して https://mcp.vividai.tv/chatgpt に接続 — キーの貼り付けは不要	いいえ	いいえ
Claude Code プラグイン	/plugin install vivid@vivid — OAuth と VIVID スキル	いいえ	いいえ
Claude Desktop 拡張機能	vivid-mcp.mcpb をダウンロードし、ダブルクリックしてキーを貼り付けます	いいえ（ランタイムを同梱）	はい
ローカル（npx）	VIVID_API_KEY を設定して npx -y vivid-mcp を実行します	Node.js 20+	はい
コマンドライン	VIVID_API_KEY を設定して npx -y vivid-mcp call <tool> '<json>' を実行します — MCP クライアントは不要です	Node.js 20+	はい

リモート（インストール不要）

同じサーバーが、Cloudflare Worker として https://mcp.vividai.tv/mcp で実行されます（ステートレスな Streamable HTTP）。リクエストごとに API キーを送信してください。

# Claude Code
claude mcp add --transport http vivid https://mcp.vividai.tv/mcp --header "Authorization: Bearer vk_xxx"

// Cursor and other clients that take a URL + headers
{ "mcpServers": { "vivid": { "url": "https://mcp.vividai.tv/mcp", "headers": { "Authorization": "Bearer vk_xxx" } } } }

GET https://mcp.vividai.tv/ はバージョンとエンドポイントを返します。ファイルには公開 URL が必要です（vivid_upload_file は URL を受け付けます）。outputDir / outputPath は無視されます。

コネクター：ChatGPT、Claude.ai（OAuth）

ヘッダーを送信できないクライアントは、代わりに OAuth 2.1 で認証します。URL に https://mcp.vividai.tv/mcp（Claude.ai → Settings → Connectors → Add custom connector）または https://mcp.vividai.tv/chatgpt（ChatGPT → Settings → Connectors → Create）を指定してコネクターを追加し、OAuth を選択します。クライアントは /.well-known/oauth-protected-resource を検出して自身を登録し（動的クライアント登録）、vividai.tv/oauth/consent に移動します。そこでサインインし、Authorize をクリックします。各コネクターには独自の認証情報（vc_…。API キーではありません）が割り当てられ、アセットやクレジットを使用できますが、パスワードの変更、API キーのローテーション、アカウントの削除はできません。Settings → Connected apps からいつでも失効できます。

/chatgpt は OpenAI のプラグインガイドラインに沿って、同じツールを提供します。vivid_buy_credits は含まれません（クレジット不足エラーは、チェックアウトやアップグレードボタンのない情報ページ vividai.tv/credits を案内します）。vivid_chat も含まれず、実在人物の写真や録画を入力として使用することもできません（vivid_create_testimonial が受け取るのは attributes のみです。vivid_generate_image に modelImageUrls はありません。vivid_generate_video が受け取るのは vivid_generate_voice / vivid_generate_music で作成した音声のみで、参照として使用できるのはギャラリー動画のみです。フレーム、参照画像、商品写真やシーン写真、レタッチ元、vivid_upload_file など、その他すべての画像は API の人物チェックを通過します。このチェックでは、顔が認識可能な場合は拒否されます）。応答にはタイムスタンプ、プロジェクトの生データ、API パス、プロバイダーの詳細は含まれません。

Claude Code プラグイン（OAuth + スキル）

このリポジトリは Claude Code プラグインであり、独自のマーケットプレイスでもあります。OAuth（キーの貼り付け不要）でリモートサーバーに接続し、skills/ にあるスキル（商品写真、商品動画、ブランドキャスト）を追加します。

/plugin marketplace add loopotv/vivid-mcp
/plugin install vivid@vivid

次に /mcp を実行し、vivid を選んで認証します。ブラウザーで vividai.tv/oauth/consent が開きます。マニフェストは .claude-plugin/ にあります。インストール済みプラグインは version が変更された場合にのみ更新されるため、その値は package.json と一致している必要があります（テストで確認されます）。claude plugin validate --strict . で確認してください。

Claude Desktop（ワンクリック拡張機能）

vivid-mcp.mcpb をダウンロードし、Claude Desktop で開きます。独自の Node ランタイムとともにサーバーがインストールされ、API キーの入力を求められます（Claude がシークレットとして保存します）。manifest.json から npm run build && npx @anthropic-ai/mcpb pack を実行してビルドします。

ローカル（npx、Node.js 20+）

Claude Code

claude mcp add vivid -e VIVID_API_KEY=vk_xxx -- npx -y vivid-mcp

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "vivid": {
      "command": "npx",
      "args": ["-y", "vivid-mcp"],
      "env": { "VIVID_API_KEY": "vk_xxx" }
    }
  }
}

Cursor / その他のクライアント

同じコマンド npx -y vivid-mcp を使用し、環境変数に VIVID_API_KEY を設定します。

コマンドライン（MCP クライアントなし）

同じツールを、インメモリの MCP クライアントを介してシェルから実行できます。引数、検証、結果は同じです。 これは、MCP 接続はないもののターミナルを利用できるエージェントで vivid-studio スキルが使用する方法です。

export VIVID_API_KEY=vk_xxx
npx -y vivid-mcp tools                       # every tool with its title
npx -y vivid-mcp schema generate_image       # description + JSON schema of the arguments
npx -y vivid-mcp call whoami                 # the vivid_ prefix is optional
npx -y vivid-mcp call generate_image '{"prompt":"…","model":"nano-banana-2"}'
npx -y vivid-mcp call edit_timeline @args.json   # or - to read stdin

ツールのテキスト結果は stdout に出力されます。ツールがエラーを報告した場合、終了コードは 1 です。

環境

変数	必須	デフォルト
VIVID_API_KEY	はい	—
VIVID_API_URL	いいえ	https://vivid-api.vividoai.workers.dev

プロンプトの例

• 「VIVID で利用できる動画モデルと、それぞれの料金を教えてください。」
• 「nano-banana-2 を使って、大理石のカウンターに置かれた革製ハンドバッグの画像を 4:5 で 2 枚生成してください。」
• 「~/Desktop/bag.jpg をアップロードし、それを商品リファレンスとして Seedance 2.5 で 10 秒、9:16 の動画を作成してください。完了したら知らせてください。」
• 「最後に作成した動画を ~/Downloads にダウンロードして、公開リンクを教えてください。」
• 「商品紹介動画用に 30 秒のアップビートなインストゥルメンタルを作成し、両方のテイクを ./music に保存してください。」
• 「./voiceover.mp3 の音声を書き起こし、単語レベルの SRT を ./subs.srt に書き出してください。」
• 「最後に作成した 2 本の動画から 9:16 の編集プロジェクトを作成し、それぞれを 4 秒にカットして間にディゾルブを入れ、最初の 3 秒間タイトル「New drop」を表示してから、レンダリングしてください。」
• 「最後に生成した画像の薬指の指輪をシンプルなイエローゴールドのバンドに変更してから、./sku/ring-01.jpg と比較し、合格かどうか教えてください。」

タイムライン編集

vivid_create_editor_project / vivid_edit_timeline は VIVID エディターをヘッドレスで実行し（vivid-editor-core。ウェブエディターと同じストアおよび AI コマンドオーケストレーターを使用します）、プロジェクトをアカウントに保存します。そのため、ここで作成したものは vividai.tv/tools/editor で開き、vivid_render_project でレンダリングできます。コマンドは { type, payload } オブジェクト（ADD_CLIP、UPDATE_CLIP、SPLIT_CLIP、SET_TRANSITION、SET_CANVAS_PRESET、ADD_TEXT、SET_ANIMATIONS、ADD_EFFECT、SET_MASK…）です。詳しくはツールの説明をご覧ください。メディアは VIVID アセット ID、URL、またはローカルパスを指定してインポートします。

UI の録画

vivid_record_ui は Playwright を介してローカルの Chromium を操作し、セッションを録画します。手順のリスト（Playwright セレクターを使用する goto、click、hover、type、fill、press、scroll、wait、hide、evaluate）を渡すと、鮮明な 2 倍解像度の動画（デフォルトの 1440×900 のビューポートでは 2880×1800）がギャラリーにアップロードされ、vivid_create_editor_project / vivid_edit_timeline ですぐに使用できます。ブラウザーは VIVID_API_KEY のアカウントに自動的にログインします（キーは POST /api/me/session を通じて短期間有効なセッションと交換されます）。ページ上にはクリック時に波紋が出るカーソルが描画され、ページ読み込み時の冒頭部分はトリミングされます。手順には optional を指定できます（要素が見つからない場合はスキップされます。例：一度だけ表示されるオンボーディングダイアログ）。クレジットは消費されません。

MCP サーバーを実行するマシンには、Google Chrome（または npx playwright install chromium）が必要です。MP4 出力には ffmpeg を PATH に設定してください（設定されていない場合、エディターで問題なくレンダリングできる raw webm がアップロードされます）。playwright-core はオプションの依存関係で、ツールを使用した場合にのみ読み込まれます。

レンダリング

VIVID の動画エディターはブラウザー内でレンダリングされるため（Canvas2D + WebCodecs）、vivid_render_project 単体ではファイルを生成しません。代わりに レンダージョブ をキューに登録し、openUrl を返します。その URL を、vividai.tv にログインしているブラウザーで開くか（または openBrowser: true を指定してこのマシン上で開くと）、エディターがプロジェクトを読み込み、エクスポートして、MP4 をギャラリーにアップロードします。vivid_render_status で進捗と最終アセットを確認でき、vivid_download_asset でダウンロードできます。

クレジット

生成ごとに、モデルに応じたVIVIDクレジットが課金されます（画像は1枚ごと、動画はクレジット／秒 × 長さ）。vivid_list_modelsで正確な料金を確認でき、vivid_whoamiで残高と自動チャージの有効・無効を確認できます。動画はジョブの開始時に前払いで課金されます。

クレジットはプランまたはクレジットパック（500／1,500／5,000クレジット、€12.99から、12か月間有効、サブスクリプション不要）で入手できます。ジョブの途中でクレジットが不足すると、失敗した呼び出しからチャージリンクが返されます。エージェントがリンクを表示し、ブラウザーで支払いを済ませると、エージェントが再試行します。完了済みの作業は保持されます。vivid_buy_creditsを使うと、必要な不足クレジット数に応じた同じリンクを、いつでも取得できます。自動チャージを有効にしている場合（vividai.tvのBillingページ）、ジョブは停止しません。設定したしきい値を下回ると、VIVIDが保存済みカードで同じパックを再購入します。再購入は、設定した月間上限の範囲内で、1日あたり最大5回です。MCPからカードに請求したり、自動チャージを有効にしたりすることはできません。

開発

npm install
npm run typecheck
npm test
npm run inspect   # opens the MCP Inspector against the built server

npm run buildはdist/にコンパイルします。GitHubからパッケージをインストールするときは、prepareスクリプトが自動的に実行されます。

ライセンス

MIT

スキル

skills/にはスキルバンドルが格納されています（各フォルダーにSKILL.mdが1つずつあります。SKILL.md形式を開く）。

• vivid-studio — スタジオ全体を1つのスキルにまとめています。画像、レタッチとQC、動画、音声、音楽、文字起こし、タイムライン編集とレンダリング、画面録画に対応します。SKILL.mdは各領域のreferences/*.mdを参照し、接続時はMCP経由で、そうでない場合は上記のコマンドラインからツールを実行します。
• vivid-product-photos、vivid-product-video、vivid-brand-cast — ChatGPTアプリとともに提出された、より対象を絞ったスキルです。

これらは上記のツールを利用するシンプルな手順書で、独自のコードはありません。 スキルフォルダーをZIP化すると（cd skills && zip -r vivid-studio.zip vivid-studio）、スキルマーケットプレイスで公開できます。