Menü der Dokumentation

MCP-Server

Mit dem MCP-Server kann ein KI-Assistent in deinem Evocal-Konto arbeiten: ein Video senden, die Synchronisation starten, Segmente prüfen und korrigieren und die Dateien herunterladen. Er nutzt deinen API-Schlüssel, mit denselben Credits und Regeln wie die App.

Aktualisiert am 20. Nov. 2026

Bevor du anfängst

  • Der MCP-Server gehört zu den Tarifen Pro, Studio und Enterprise, wie die API.
  • Erstelle einen Schlüssel in der App unter Konto, API. Gib dem Assistenten einen eigenen Schlüssel, damit du ihn widerrufen kannst, ohne etwas anderes anzuhalten.
  • Dein Assistent muss es erlauben, einen entfernten MCP-Server mit einem Header hinzuzufügen. Agenten, die in einem Terminal arbeiten, und Code-Editoren können das; Chat-Apps, die sich nur per Anmeldung verbinden, können ihn noch nicht nutzen.

Verbinden

Die Adresse des Servers ist https://www.evocal.app/api/mcp (Streamable HTTP). Er nimmt den Schlüssel im Header Authorization entgegen. Zum Beispiel in Claude Code:

claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
  --header "Authorization: Bearer evk_..."

Editoren, die ihre Server in einer JSON-Datei speichern, nehmen einen Eintrag wie diesen. Den Namen der Datei und ihre genaue Form findest du in der Anleitung deines Editors.

{
  "mcpServers": {
    "evocal": {
      "url": "https://www.evocal.app/api/mcp",
      "headers": { "Authorization": "Bearer evk_..." }
    }
  }
}

Dann bitte zum Beispiel: „Synchronisiere lesson-4.mp4 aus dem Portugiesischen ins Englische und sag mir vorher, was es kostet.“

Was der Assistent tun kann

WerkzeugWas es tut
get_accountDer Tarif und die Credits jetzt.
list_languagesDie Sprachpaare, die jetzt offen sind.
list_projectsDeine Projekte, die neuesten zuerst.
get_projectEin Projekt, mit dem Zustand seiner Datei und seinen Synchronisationen.
create_projectErstellt ein Projekt mit einer Synchronisation für jede Zielsprache.
start_uploadÖffnet den Upload der Datei und gibt die Adressen der ersten Teile.
get_upload_part_urlsAdressen für weitere Teile, oder neue für Teile, die fehlgeschlagen sind.
complete_uploadBeendet den Upload; danach wird die Datei geprüft.
start_dubStartet eine Synchronisation. Verbraucht Credits.
get_jobZustand und Fortschritt eines Jobs.
get_dubEine Synchronisation mit dem letzten Job, der darauf lief.
get_segmentsDie Segmente der Synchronisation: Zeiten, Texte und Hinweise. Kann nur die mit Hinweisen oder Änderungen zeigen.
edit_segmentSpeichert einen neuen Text für ein Segment.
quote_regenerationWas es kostet, einige Segmente neu zu erzeugen.
regenerate_segmentsErzeugt Segmente mit ihren gespeicherten Texten neu. Verbraucht Credits.
finish_dubSchließt die Bearbeitung ab und öffnet die Downloads.
get_download_linksLinks zu den Dateien der Synchronisation, 5 Minuten gültig.
get_subtitlesDie Untertitel als Text, in SRT oder WebVTT.
delete_projectLöscht ein Projekt mit seinen Dateien und Synchronisationen.

Die Datei senden

Der Assistent liest die Datei auf deinem Computer und sendet sie in Teilen, also muss er dort laufen, wo die Datei liegt, mit einem Terminal oder Zugriff auf deine Dateien. Er schneidet die Datei in Teile von part_size Bytes und sendet jeden mit einem PUT an seine Adresse.

Ein Assistent, der deine Dateien nicht erreicht, kann trotzdem an den Projekten arbeiten, die du in der App sendest: die Segmente lesen, korrigieren, neu erzeugen und herunterladen.

Credits und Sicherheit

  • Der Assistent verbraucht deine Credits: Eine Synchronisation kostet einen Credit pro Sekunde Video (mindestens 30), eine Neuerzeugung die Sekunden ihrer Segmente (mindestens 15). Der Server weist ihn an, dir vorher die Kosten zu nennen und auf dein Ja zu warten, aber du haftest für jeden Aufruf mit deinem Schlüssel.
  • Eine Synchronisation abschließen und ein Projekt löschen lässt sich nicht rückgängig machen. Der Assistent ist angewiesen, dich vorher zu fragen.
  • Jede Datei folgt denselben Regeln wie in der App: Sende nur Stimmen, die deine eigenen sind oder deren Sprecher dir schriftlich zugestimmt haben. Die Stimmbestätigung des Schlüssels gilt für jede Datei.
  • Seine Aufrufe zählen in den Limits der API: 120 pro Minute und 3.600 pro Stunde für das ganze Konto.
  • Der Assistent sieht, was die API zeigt: deine Projekte, Synchronisationen, Segmente und Credits. Wenn der Schlüssel öffentlich wird, widerrufe ihn unter Konto, API.

Weiterlesen