Skip to main content
Glama
vidalytics

@vidalytics/mcp

Official
by vidalytics

@vidalytics/mcp

npm version CI license

1つのコマンドで、AIコーディングアシスタントをModel Context Protocol経由でVidalyticsの動画分析データに接続します。

Claude(CLI & Desktop)、Windsurf、Cursor、その他MCP互換クライアントで動作します。

セットアップ

npx @vidalytics/mcp install

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

Related MCP server: YouTube MCP

Cursor

Add Vidalytics to 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アシスタントは以下にアクセスできるようになります:

Tool

Description

set_user_context

アナリティクスを有効にするには、他のツールより先に呼び出す必要があります

list_videos

動画をページネーション付きで一覧表示します

get_video

動画の詳細を取得します

get_video_by_embed_guid

埋め込みGUIDで動画を検索します

update_video

動画のタイトルまたはフォルダを更新します

get_video_embed

埋め込みコードと設定を取得します

get_video_settings

再生設定(自動再生、コントロールなど)を取得します

get_video_thumbnail

サムネイル画像のURLを取得します

get_video_stats

再生回数、再生率、視聴時間、コンバージョン

get_video_dropoff

視聴者維持率(パーセンテージ)

get_video_percentage_watched

各ポイントに到達した視聴者の割合(%)

get_video_live_metrics

リアルタイムのアクティブ視聴者数と視聴率

get_video_ctas

動画のCTAを取得します

get_video_pause_screens

動画の一時停止画面を取得します

get_videos_stats_batch

最大30本の動画の統計を一度に取得します

get_videos_timeline

最大5本の動画のタイムライン統計

list_folders

動画フォルダを一覧表示します

list_settings_templates

設定テンプレートを一覧表示します

get_api_usage

現在のAPI使用量とクォータを取得します

list_connections

アカウントに接続されているアプリを一覧表示します

revoke_connection

アプリまたは自分自身の接続を解除します

upload_video_from_url

リモートURLから動画をアップロードします

get_video_upload_url

ローカルファイルアップロード用の署名付きURLを取得します

validate_upload

直接動画アップロードを完了します

publish_video

動画の保留中のドラフト設定を公開します

duplicate_video

動画を複製し、コピーを公開します

create_folder

動画フォルダを作成します(別のフォルダの下にネストすることも可能)

apply_settings_template

再利用可能なプレイヤー設定テンプレートを動画に適用します

create_video_cta

動画にコールトゥアクションを作成します

update_video_cta

動画の既存のコールトゥアクションを更新します

set_video_thumbnail_from_url

公開画像URLから動画のサムネイルを設定します

set_video_thumbnail_from_frame

動画のフレームの1つからサムネイルを設定します

delete_video_thumbnail

カスタムサムネイルを削除し、デフォルトに戻します

オプション

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

Command

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 Registryに**com.vidalytics/mcp**として公開されています。これはリモート(streamable-http)サーバーであるため、レジストリ対応のMCPクライアントは以下のURLで直接接続できます:

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

APIキーや環境変数は不要です。初回使用時にOAuthで認証が行われます。

要件

  • Node.js 18+

  • Vidalyticsアカウント

ライセンス

MIT

Related MCP Connectors

Related MCP Servers