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: submagic-mcp-server

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

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

UpdatingMaintainers
UpdatingResponse time
1wRelease cycle
8Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.

  • Talk to your live-events CRM (campaigns, analytics, paid ads, segments) in Claude and ChatGPT.

  • Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vidalytics/vidalytics-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server