vidalytics

@vidalytics/mcp

Model Context Protocol を介して、AI コーディングアシスタントを Vidalytics の動画分析データに接続する、ワンコマンドセットアップです。

Claude（CLI とデスクトップ）、Windsurf、Cursor、およびその他の MCP 対応クライアントで動作します。

セットアップ

npx @vidalytics/mcp install

これで完了です。インストーラーがインストール済みの AI クライアントを検出し、設定するクライアントを選択できるようにして、接続を設定します。クライアントを再起動すると、初回使用時に OAuth 認証用のブラウザーウィンドウが開きます。

Cursor

または、インストーラーを使用：

npx @vidalytics/mcp install --client cursor

または手動で — 以下を ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "vidalytics": {
      "url": "https://api.vidalytics.com/public/v1/mcp"
    }
  }
}

Cursor を再起動します。初回使用時にブラウザーウィンドウが開き、Vidalytics アカウントで OAuth 認証を行います。API キーや環境変数の設定は不要です。

できること

• 設定ファイル、アプリディレクトリ、$PATH 内のバイナリ、アプリバンドル（macOS の /Applications など）を確認して、インストール済みの MCP クライアント（Claude CLI、Claude Desktop、Windsurf、Cursor）を検出します
• 対話型チェックリストを表示します（検出されたクライアントはあらかじめ選択されています）。設定するクライアントだけを選べるほか、--client を使って非対話形式で選択できます
• 選択した各クライアントの設定に Vidalytics を MCP サーバーとして追加します
• 書き込み後に検証します。設定が有効で、MCP サーバーに接続できることを確認します
• 非対話型ターミナル（CI）や選択フラグ（--client、--all、--yes）を明示的に指定した場合、チェックリストを省略し、予測可能な動作をします

利用可能なツール

接続すると、AI アシスタントは以下のツールを利用できるようになります。

多くの書き込みツール（設定、チャプター、キャプション、タグ、CTA、一時停止画面、サムネイル）は、変更を動画の下書きに保存します。公開するには publish_video を呼び出してください。書き込みツールには読み取りと書き込みの両方の認可が必要です。読み取り専用の接続では SCOPE_INSUFFICIENT が返されます。

変更のプレビュー。 update_video_settings は dryRun を受け付け、保存せずに検証を行い、変更前後の差分を返します。下書きベースのその他の書き込みには dryRun がありません。下書きに保存してから、publish_video を呼び出す前に、対応する get_*／list_* ツール（例：get_video_chapters、get_video_tags、get_video_captions）で読み戻してプレビューしてください。未公開の下書き編集のみを削除する操作も、公開までは取り消し可能です。すでに公開済みのコンテンツを削除した場合、変更は次回の公開時に反映されます。

動画とメタデータ

ツール	説明
set_user_context	分析を有効にするため、他のツールを呼び出す前に必ず呼び出してください
list_videos	ページネーションを使用して動画を一覧表示します
get_video	動画の詳細を取得します
get_video_by_embed_guid	埋め込み GUID で動画を検索します
update_video	動画のタイトルまたはフォルダーを更新します
get_video_embed	埋め込みコードと設定を取得します
get_video_settings	再生設定（自動再生、コントロールなど）を取得します
update_video_settings	再生設定を下書きとして更新します（dryRun は検証を行い、差分のみを返します）
duplicate_video	動画を複製し、複製した動画を公開します
publish_video	動画の保留中の下書き設定を公開します

分析

ツール	説明
get_video_stats	再生回数、再生率、視聴時間、コンバージョン
get_video_dropoff	パーセンテージ別の視聴者維持率
get_video_percentage_watched	各ポイントまで視聴した視聴者の割合
get_video_live_metrics	リアルタイムのアクティブ視聴者数と視聴率
get_videos_stats_batch	最大30本の動画の統計情報を一度に取得
get_videos_timeline	最大5本の動画のタイムライン統計情報

チャプター、字幕、タグ

ツール	説明
get_video_chapters	動画のチャプター一覧と有効かどうかを取得
set_video_chapters	動画のチャプターマーカーを置き換え（下書き）
get_video_captions	動画の字幕トラック一覧を取得
add_video_caption	提供されたテキストから字幕トラックを追加または置き換え（下書き）
delete_video_caption	字幕の言語を削除
get_video_tags	動画のタグとカスタム変数の一覧を取得
set_video_tags	動画のタグ一覧全体を設定（下書き）

CTAと一時停止画面

ツール	説明
get_video_ctas	動画のCTAを取得
create_video_cta	動画に行動喚起を作成
update_video_cta	動画の既存の行動喚起を更新
delete_video_cta	動画から行動喚起を削除
get_video_pause_screens	動画の一時停止画面を取得
create_video_pause_screen	動画に一時停止画面を追加（下書き）
update_video_pause_screen	動画の一時停止画面を更新（下書き）
delete_video_pause_screen	動画から一時停止画面を削除

サムネイル

ツール	説明
get_video_thumbnail	サムネイル画像のURLを取得
set_video_thumbnail_from_url	公開画像URLから動画のサムネイルを設定
set_video_thumbnail_from_frame	動画のフレームからサムネイルを設定
delete_video_thumbnail	カスタムサムネイルを削除し、デフォルトに戻す

フォルダーと設定テンプレート

ツール	説明
list_folders	動画フォルダーの一覧を取得
create_folder	動画フォルダーを作成（別のフォルダー内に作成することも可能）
rename_folder	動画フォルダーの名前を変更
list_settings_templates	設定テンプレートの一覧を取得
create_settings_template	動画の現在の設定から設定テンプレートを作成
update_settings_template	設定テンプレートを更新（名前の変更、説明の更新、動画からの設定の再取得）
delete_settings_template	設定テンプレートを削除
apply_settings_template	再利用可能なプレーヤー設定テンプレートを動画に適用

アップロード

ツール	説明
upload_video_from_url	リモートURLから動画をアップロード
get_video_upload_url	ローカルファイルのアップロード用に署名付きURLを取得
validate_upload	動画の直接アップロードを完了

アカウント

ツール	説明
get_api_usage	現在のAPI使用状況とクォータを取得
list_connections	アカウントに接続されているアプリの一覧を取得
revoke_connection	アプリまたは自分自身の接続を解除

オプション

npx @vidalytics/mcp install [flags]

  --client <names>   Configure only these clients, comma-separated
                     (claude-cli, claude-desktop, windsurf, cursor)
  --all              Configure all known clients, even if not detected
  --config <path>    Also configure a custom config file (repeatable)
  --force            Re-apply even if already configured
  --yes              Skip prompts (configure detected clients)

対話型ターミナルでフラグを指定せずに実行すると、設定するクライアントのチェックリストが表示されます（検出されたクライアントはあらかじめ選択されています。スペースキーで切り替え、Enterキーで確定します）。--client cursor,windsurf を指定すると、同じ選択を非対話形式で行えます。

--config フラグは複数のファイルに対して繰り返し指定できます。対象ファイルは、Claude Desktop、Cursor、Windsurfで使用される { "mcpServers": {} } 形式に従う必要があります。ZedやMCPプラグインを使用するVS Codeなど、サポートされていないクライアントで便利です。

トラブルシューティング

認証に問題がある場合、または再認証が必要な場合は、ホームディレクトリにある mcp-remote がキャッシュした認証情報をリセットし、クライアントを再起動してください。

OS	コマンド
macOS / Linux	rm -rf ~/.mcp-auth
Windows（CMD）	rd /s /q "%USERPROFILE%\.mcp-auth"
Windows（PowerShell）	Remove-Item -Recurse -Force "$HOME\.mcp-auth"

MCP レジストリ

このサーバーは、公式の MCP レジストリ に com.vidalytics/mcp として公開されています。これはリモート（ストリーミング可能な HTTP）サーバーなので、レジストリに対応した MCP クライアントは、次の URL に直接接続できます。

https://api.vidalytics.com/public/v1/mcp

API キーや環境変数は必要ありません。初回使用時に OAuth で認証されます。

要件

• Node.js 18+
• Vidalytics アカウント

ライセンス

MIT