Skip to main content
Glama
vidalytics

@vidalytics/mcp

Official
by vidalytics

@vidalytics/mcp

npm version CI license

Einrichtung mit einem einzigen Befehl, die Ihren KI-Codierungsassistenten über das Model Context Protocol mit Vidalytics-Videoanalysedaten verbindet.

Funktioniert mit Claude (CLI & Desktop), Windsurf, Cursor und jedem anderen MCP-kompatiblen Client.

Einrichtung

npx @vidalytics/mcp install

Das war's. Der Installer erkennt, welche KI-Clients Sie installiert haben, lässt Sie auswählen, welche konfiguriert werden sollen, und richtet sie ein. Starten Sie den Client neu – bei der ersten Verwendung öffnet sich ein Browserfenster für die OAuth-Autorisierung.

Related MCP server: YouTube MCP

Cursor

Vidalytics zu Cursor hinzufügen

Oder über den Installer:

npx @vidalytics/mcp install --client cursor

Oder manuell – fügen Sie dies zu ~/.cursor/mcp.json hinzu:

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

Starten Sie Cursor neu. Bei der ersten Verwendung öffnet sich ein Browserfenster für die OAuth-Autorisierung mit Ihrem Vidalytics-Konto – es müssen keine API-Schlüssel oder Umgebungsvariablen festgelegt werden.

Was es tut

  • Erkennt installierte MCP-Clients (Claude CLI, Claude Desktop, Windsurf, Cursor), indem es Konfigurationsdateien, App-Verzeichnisse, Binärdateien in $PATH und App-Bundles (z. B. /Applications unter macOS) prüft

  • Zeigt eine interaktive Checkliste (erkannte Clients sind vorausgewählt), sodass Sie genau diejenigen konfigurieren können, die Sie möchten – oder wählen Sie sie nicht-interaktiv mit --client aus

  • Fügt Vidalytics als MCP-Server in die Konfiguration jedes ausgewählten Clients ein

  • Überprüft nach dem Schreiben: Die Konfiguration ist gültig und der MCP-Server ist erreichbar

  • Nicht-interaktive Terminals (CI) und jede explizite Auswahloption (--client, --all, --yes) überspringen die Checkliste und verhalten sich vorhersehbar

Verfügbare Tools

Sobald die Verbindung hergestellt ist, erhält Ihr KI-Assistent Zugriff auf:

Tool

Beschreibung

set_user_context

MUSS vor jedem anderen Tool aufgerufen werden, um Analysen zu aktivieren

list_videos

Videos mit Paginierung auflisten

get_video

Videodetails abrufen

get_video_by_embed_guid

Ein Video anhand seiner Embed-GUID finden

update_video

Titel oder Ordner eines Videos aktualisieren

get_video_embed

Einbettungscode und Konfiguration abrufen

get_video_settings

Wiedergabeeinstellungen abrufen (Autoplay, Steuerelemente usw.)

get_video_thumbnail

Die URL des Thumbnail-Bilds abrufen

get_video_stats

Aufrufe, Abspielrate, Wiedergabezeit, Conversions

get_video_dropoff

Zuschauerbindung in Prozent

get_video_percentage_watched

Prozentsatz der Zuschauer, die jeden Punkt erreicht haben

get_video_live_metrics

Aktive Zuschauer und Abspielrate in Echtzeit

get_video_ctas

CTAs für ein Video abrufen

get_video_pause_screens

Pausebilder für ein Video abrufen

get_video_ctas

CTAs für ein Video abrufen

get_video_pause_screens

Pausebilder für ein Video abrufen

get_videos_stats_batch

Statistiken für bis zu 30 Videos auf einmal

get_videos_timeline

Zeitverlaufsstatistiken für bis zu 5 Videos

list_folders

Videoordner auflisten

list_settings_templates

Einstellungsvorlagen auflisten

get_api_usage

Aktuelle API-Nutzung und Kontingent abrufen

list_connections

Mit Ihrem Konto verbundene Apps auflisten

revoke_connection

Eine App oder sich selbst trennen

upload_video_from_url

Ein Video von einer Remote-URL hochladen

get_video_upload_url

Eine signierte URL für den Upload lokaler Dateien abrufen

validate_upload

Einen direkten Video-Upload abschließen

publish_video

Ausstehende Entwurfseinstellungen eines Videos veröffentlichen

duplicate_video

Ein Video duplizieren und die Kopie veröffentlichen

create_folder

Einen Videoordner erstellen, optional unter einem anderen Ordner verschachtelt

apply_settings_template

Eine wiederverwendbare Player-Einstellungsvorlage auf ein Video anwenden

create_video_cta

Einen Call-to-Action auf einem Video erstellen

update_video_cta

Einen vorhandenen Call-to-Action auf einem Video aktualisieren

set_video_thumbnail_from_url

Das Thumbnail eines Videos von einer öffentlichen Bild-URL festlegen

set_video_thumbnail_from_frame

Das Thumbnail eines Videos aus einem seiner Frames festlegen

delete_video_thumbnail

Ein benutzerdefiniertes Thumbnail entfernen und den Standard wiederherstellen

Optionen

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)

Bei Ausführung ohne Flags in einem interaktiven Terminal erhalten Sie eine Checkliste der zu konfigurierenden Clients (erkannte sind vorausgewählt; Leertaste zum Umschalten, Eingabetaste zum Bestätigen). --client cursor,windsurf führt dieselbe Auswahl nicht-interaktiv aus.

Das --config-Flag kann für mehrere Dateien wiederholt werden. Die Zieldatei muss dem Format { "mcpServers": {} } entsprechen, das von Claude Desktop, Cursor und Windsurf verwendet wird – nützlich für nicht unterstützte Clients wie Zed oder VS Code mit einem MCP-Plugin.

Fehlerbehebung

Autorisierungsprobleme oder erneute Authentifizierung erforderlich? Setzen Sie die Anmeldedaten zurück, die mcp-remote in Ihrem Home-Verzeichnis zwischenspeichert, und starten Sie den Client neu:

Betriebssystem

Befehl

macOS / Linux

rm -rf ~/.mcp-auth

Windows (CMD)

rd /s /q "%USERPROFILE%\.mcp-auth"

Windows (PowerShell)

Remove-Item -Recurse -Force "$HOME\.mcp-auth"

MCP Registry

Dieser Server ist im offiziellen MCP Registry als com.vidalytics/mcp veröffentlicht. Es handelt sich um einen Remote-Server (streamable-http), sodass Registry-fähige MCP-Clients direkt eine Verbindung zu ihm herstellen können unter:

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

Es sind keine API-Schlüssel oder Umgebungsvariablen erforderlich – die Autorisierung erfolgt bei der ersten Verwendung über OAuth.

Voraussetzungen

  • Node.js 18+

  • Ein Vidalytics-Konto

Lizenz

MIT

Related MCP Connectors

Related MCP Servers