Skip to main content
Glama
vidalytics

@vidalytics/mcp

Official
by vidalytics

@vidalytics/mcp

npm version CI license

Установка одной командой, которая подключает вашего ИИ-ассистента для программирования к данным видеоаналитики Vidalytics через Model Context Protocol.

Работает с Claude (CLI и Desktop), Windsurf, Cursor и любым другим MCP-совместимым клиентом.

Установка

npx @vidalytics/mcp install

Вот и всё. Установщик определяет, какие ИИ-клиенты у вас установлены, позволяет выбрать, какие из них настроить, и подключает их. Перезапустите клиент — при первом использовании откроется окно браузера для авторизации через 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. При первом использовании откроется окно браузера для авторизации через OAuth в вашей учётной записи Vidalytics — не нужно задавать API-ключ или переменные окружения.

Что он делает

  • Определяет установленные MCP-клиенты (Claude CLI, Claude Desktop, Windsurf, Cursor), проверяя файлы конфигурации, каталоги приложений, исполняемые файлы в $PATH и пакеты приложений (например, /Applications на macOS)

  • Представляет интерактивный контрольный список (обнаруженные клиенты предварительно выбраны), чтобы вы настроили именно те, которые хотите, — или выберите их неинтерактивно с помощью --client

  • Добавляет Vidalytics как MCP-сервер в конфигурацию каждого выбранного клиента

  • Проверяет после записи: конфигурация корректна и MCP-сервер доступен

  • Неинтерактивные терминалы (CI) и любой явный флаг выбора (--client, --all, --yes) пропускают контрольный список и ведут себя предсказуемо

Доступные инструменты

После подключения ваш ИИ-ассистент получает доступ к:

Инструмент

Описание

set_user_context

ОБЯЗАТЕЛЬНО должен быть вызван перед любым другим инструментом для включения аналитики

list_videos

Список видео с пагинацией

get_video

Получить сведения о видео

get_video_by_embed_guid

Найти видео по его embed 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

Установить миниатюру видео из одного из его кадров

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 можно повторять для нескольких файлов. Целевой файл должен соответствовать формату { "mcpServers": {} }, используемому Claude Desktop, Cursor и Windsurf — полезно для неподдерживаемых клиентов, таких как Zed или VS Code с MCP-плагином.

Устранение неполадок

Проблемы с авторизацией или нужно повторно пройти аутентификацию? Сбросьте учётные данные, которые mcp-remote кэширует в вашем домашнем каталоге, затем перезапустите клиент:

ОС

Команда

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-клиенты, поддерживающие реестр, могут подключаться к нему напрямую по адресу:

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

Не требуется API-ключ или переменные окружения — авторизация выполняется через OAuth при первом использовании.

Требования

  • Node.js 18+

  • Учётная запись Vidalytics

Лицензия

MIT

Related MCP Connectors

Related MCP Servers