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.
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
| Werkzeug | Was es tut |
|---|---|
get_account | Der Tarif und die Credits jetzt. |
list_languages | Die Sprachpaare, die jetzt offen sind. |
list_projects | Deine Projekte, die neuesten zuerst. |
get_project | Ein Projekt, mit dem Zustand seiner Datei und seinen Synchronisationen. |
create_project | Erstellt 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_urls | Adressen für weitere Teile, oder neue für Teile, die fehlgeschlagen sind. |
complete_upload | Beendet den Upload; danach wird die Datei geprüft. |
start_dub | Startet eine Synchronisation. Verbraucht Credits. |
get_job | Zustand und Fortschritt eines Jobs. |
get_dub | Eine Synchronisation mit dem letzten Job, der darauf lief. |
get_segments | Die Segmente der Synchronisation: Zeiten, Texte und Hinweise. Kann nur die mit Hinweisen oder Änderungen zeigen. |
edit_segment | Speichert einen neuen Text für ein Segment. |
quote_regeneration | Was es kostet, einige Segmente neu zu erzeugen. |
regenerate_segments | Erzeugt Segmente mit ihren gespeicherten Texten neu. Verbraucht Credits. |
finish_dub | Schließt die Bearbeitung ab und öffnet die Downloads. |
get_download_links | Links zu den Dateien der Synchronisation, 5 Minuten gültig. |
get_subtitles | Die Untertitel als Text, in SRT oder WebVTT. |
delete_project | Lö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.