Skip to main content
Glama
vidalytics

@vidalytics/mcp

Official
by vidalytics

@vidalytics/mcp

npm version CI license

Configuración en un solo comando que conecta tu asistente de codificación con IA a los datos de analítica de video de Vidalytics mediante el Model Context Protocol.

Funciona con Claude (CLI y Desktop), Windsurf, Cursor y cualquier otro cliente compatible con MCP.

Configuración

npx @vidalytics/mcp install

Eso es todo. El instalador detecta qué clientes de IA tienes instalados, te permite elegir cuáles configurar y los conecta. Reinicia el cliente: se abrirá una ventana del navegador para la autorización OAuth en el primer uso.

Related MCP server: YouTube MCP

Cursor

Add Vidalytics to Cursor

O mediante el instalador:

npx @vidalytics/mcp install --client cursor

O manualmente — añade esto a ~/.cursor/mcp.json:

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

Reinicia Cursor. En el primer uso se abrirá una ventana del navegador para la autorización OAuth con tu cuenta de Vidalytics: no es necesario configurar ninguna clave de API ni variables de entorno.

Qué hace

  • Detecta los clientes MCP instalados (Claude CLI, Claude Desktop, Windsurf, Cursor) comprobando archivos de configuración, directorios de aplicaciones, binarios en $PATH y paquetes de aplicaciones (p. ej. /Applications en macOS)

  • Presenta una lista de verificación interactiva (los clientes detectados vienen preseleccionados) para que configures exactamente los que quieras, o elígelos de forma no interactiva con --client

  • Añade Vidalytics como servidor MCP en la configuración de cada cliente seleccionado

  • Verifica después de escribir: que la configuración es válida y que el servidor MCP es accesible

  • Los terminales no interactivos (CI) y cualquier indicador de selección explícito (--client, --all, --yes) omiten la lista de verificación y se comportan de forma predecible

Herramientas disponibles

Una vez conectado, tu asistente de IA obtiene acceso a:

Tool

Description

set_user_context

DEBE llamarse antes que cualquier otra herramienta para habilitar la analítica

list_videos

Lista videos con paginación

get_video

Obtiene los detalles de un video

get_video_by_embed_guid

Encuentra un video por su GUID de inserción

update_video

Actualiza el título o la carpeta de un video

get_video_embed

Obtiene el código de inserción y su configuración

get_video_settings

Obtiene la configuración de reproducción (autoplay, controles, etc.)

get_video_thumbnail

Obtiene la URL de la imagen en miniatura

get_video_stats

Vistas, tasa de reproducción, tiempo de visualización, conversiones

get_video_dropoff

Retención de audiencia por porcentaje

get_video_percentage_watched

% de espectadores que alcanzaron cada punto

get_video_live_metrics

Espectadores activos en tiempo real y tasa de visualización

get_video_ctas

Obtiene las CTAs de un video

get_video_pause_screens

Obtiene las pantallas de pausa de un video

get_videos_stats_batch

Estadísticas de hasta 30 videos a la vez

get_videos_timeline

Estadísticas de línea de tiempo de hasta 5 videos

list_folders

Lista las carpetas de videos

list_settings_templates

Lista las plantillas de configuración

get_api_usage

Obtiene el uso actual de la API y la cuota

list_connections

Lista las aplicaciones conectadas a tu cuenta

revoke_connection

Desconecta una aplicación o a ti mismo

upload_video_from_url

Sube un video desde una URL remota

get_video_upload_url

Obtiene una URL firmada para subir un archivo local

validate_upload

Completa una subida directa de video

publish_video

Publica los ajustes de borrador pendientes de un video

duplicate_video

Duplica un video y publica la copia

create_folder

Crea una carpeta de videos, opcionalmente anidada bajo otra

apply_settings_template

Aplica una plantilla de configuración de reproductor reutilizable a un video

create_video_cta

Crea una llamada a la acción en un video

update_video_cta

Actualiza una llamada a la acción existente en un video

set_video_thumbnail_from_url

Establece la miniatura de un video desde una URL de imagen pública

set_video_thumbnail_from_frame

Establece la miniatura de un video desde uno de sus fotogramas

delete_video_thumbnail

Elimina una miniatura personalizada y restaura la predeterminada

Opciones

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)

Ejecuta sin indicadores en un terminal interactivo para obtener una lista de verificación de clientes a configurar (los detectados vienen preseleccionados; usa la barra espaciadora para alternar y Enter para confirmar). --client cursor,windsurf hace la misma selección de forma no interactiva.

El indicador --config se puede repetir para varios archivos. El archivo de destino debe seguir el formato { "mcpServers": {} } que usan Claude Desktop, Cursor y Windsurf; útil para clientes no compatibles como Zed o VS Code con un plugin MCP.

Solución de problemas

¿Problemas de autorización o necesitas volver a autenticarte? Restablece las credenciales que mcp-remote guarda en caché en tu directorio personal y luego reinicia el cliente:

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"

Registro MCP

Este servidor está publicado en el Registro MCP oficial como com.vidalytics/mcp. Es un servidor remoto (streamable-http), por lo que los clientes MCP compatibles con el registro pueden conectarse directamente en:

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

No se requiere ninguna clave de API ni variables de entorno: la autorización se gestiona mediante OAuth en el primer uso.

Requisitos

  • Node.js 18+

  • Una cuenta de Vidalytics

Licencia

MIT

Related MCP Connectors

Related MCP Servers