KI-Assistenten anbinden (MCP)

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Assistenten Werkzeuge externer Dienste nutzen. VideoOptimizer stellt einen MCP-Server bereit: Der Assistent sieht Ihre Bibliotheken und Videos und kann – im Rahmen der Rechte Ihres API-Tokens – Videos hinzufügen, Metadaten pflegen und Untertitel bearbeiten.

API-Token anlegen

Der Assistent meldet sich mit einem API-Token an – demselben wie für die REST-API. Er arbeitet genau mit den Rechten dieses Tokens und nur in dessen Organisation.

1. 1Organisations-Token: Integrationen → API-Tokens → „Neuer Token“ (nur Admins/Eigentümer). Persönlicher Token: Konto → API-Tokens.
2. 2Vergeben Sie einen sprechenden Namen, z. B. „Claude – Marketing“. Er erscheint im Audit-Log bei jeder Änderung, die der Assistent vornimmt.
3. 3Kopieren Sie den Token (beginnt mit vp_) sofort – er wird nur einmal angezeigt – und tragen Sie ihn wie unten beschrieben in Ihren Client ein.

Client einrichten

Der Server spricht „Streamable HTTP“. Tragen Sie die folgende Adresse ein und senden Sie den Token als Header „Authorization: Bearer vp_…“. Ersetzen Sie in den Beispielen vp_your_token_here durch Ihren Token.

https://api.videooptimizer.eu/api/v1/mcp

claude mcp add --transport http videooptimizer https://api.videooptimizer.eu/api/v1/mcp \
  --header "Authorization: Bearer vp_your_token_here"

{
  "mcpServers": {
    "videooptimizer": {
      "url": "https://api.videooptimizer.eu/api/v1/mcp",
      "headers": { "Authorization": "Bearer vp_your_token_here" }
    }
  }
}

{
  "servers": {
    "videooptimizer": {
      "type": "http",
      "url": "https://api.videooptimizer.eu/api/v1/mcp",
      "headers": { "Authorization": "Bearer vp_your_token_here" }
    }
  }
}

{
  "mcpServers": {
    "videooptimizer": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.videooptimizer.eu/api/v1/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer vp_your_token_here" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "videooptimizer": {
      "type": "remote",
      "url": "https://api.videooptimizer.eu/api/v1/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:VIDEOOPTIMIZER_TOKEN}" }
    }
  }
}

# ~/.codex/config.toml — token from the environment:
# export VIDEOOPTIMIZER_TOKEN=vp_your_token_here
[mcp_servers.videooptimizer]
url = "https://api.videooptimizer.eu/api/v1/mcp"
bearer_token_env_var = "VIDEOOPTIMIZER_TOKEN"

gemini mcp add --transport http -s user \
  --header "Authorization: Bearer vp_your_token_here" \
  videooptimizer https://api.videooptimizer.eu/api/v1/mcp

# ~/.hermes/config.yaml
mcp_servers:
  videooptimizer:
    url: "https://api.videooptimizer.eu/api/v1/mcp"
    headers:
      Authorization: "Bearer vp_your_token_here"

Zum Testen fragen Sie den Assistenten z. B. „Welche Bibliotheken habe ich in VideoOptimizer?“. Erscheint ein Fehler 401, ist der Token falsch, abgelaufen oder widerrufen.

Werkzeuge

Der Assistent wählt die Werkzeuge selbst. Alle Antworten entsprechen denen der REST-API.

Die markierten Werkzeuge ändern Daten und benötigen die angegebene Berechtigung. Videos und Bibliotheken lassen sich über MCP bewusst nicht löschen – nur einzelne Untertitel.

Beispiel-Prompts

• „Übersetze die deutschen Untertitel von „Produktvideo Sommer“ ins Englische und lade sie hoch.“
• „Füge https://example.com/videos/teaser.mp4 in die Bibliothek „Kampagnen“ ein, Titel „Teaser 2026“, Tag „Kampagne“, und gib mir den Einbettungscode, sobald es fertig ist.“
• „Welche Videos sind fehlgeschlagen und warum?“
• „Gib allen Videos der Bibliothek „Schulungen“, deren Titel mit „Onboarding“ beginnt, zusätzlich das Tag „Onboarding“.“
• „Wie viel Bandbreite hat VideoOptimizer uns im letzten Monat gespart?“

Sicherheit & Limits

• Der Assistent sieht und ändert nur, was der Token darf – nur in dessen Organisation. Widerrufen Sie den Token, ist der Zugriff sofort beendet.
• Jede Änderung über MCP erscheint im Audit-Log Ihrer Organisation, mit dem Namen des Tokens und dem verwendeten Werkzeug.
• Videos und Bibliotheken lassen sich über MCP nicht löschen. Prüfen Sie Änderungen, die der Assistent vorschlägt, bevor Sie sie bestätigen – besonders, wenn er Inhalte aus fremden Quellen verarbeitet.
• Jeder Werkzeug-Aufruf zählt zum API-Rate-Limit von 120 Anfragen pro Minute. Dateien vom eigenen Rechner hochladen geht über MCP nicht – nur per öffentlichem Link.