Transcript Dock MCP-Server

Der MCP-Server gibt einem KI-Agenten dieselbe API wie Ihr Schlüssel: Er findet Videos, transkribiert sie und liest die Ergebnisse mitten in einem Gespräch. Abgerechnet werden Ihre Credits. Sie müssen nichts installieren. Richten Sie den Client einfach auf den Remote-Server https://www.transcriptdock.com/mcp.

Verbinden#

Claude (claude.ai, Desktop, Mobil-App)#

• Öffnen Sie Customize, Connectors und wählen Sie Add custom connector.
• Geben Sie den Namen Transcript Dock ein und fügen Sie https://www.transcriptdock.com/mcp als Server-URL ein. Lassen Sie die erweiterten Einstellungen leer.
• Wählen Sie Add und danach Connect. Melden Sie sich bei Transcript Dock an und wählen Sie Allow access.

Ein API-Schlüssel ist nicht nötig. Der Connector meldet sich mit Ihrem Konto an und kann Aufträge lesen und senden sowie Transkripte lesen, aber nie auf Schlüssel, Abrechnung oder Kontoeinstellungen zugreifen. In den Tarifen Team und Enterprise fügt ein Owner den Connector einmal unter Organization settings, Connectors hinzu, und jedes Mitglied verbindet ihn danach.

Claude Code#

Fügen Sie den Server hinzu und führen Sie anschließend in Claude Code /mcp aus. Wählen Sie dort Authenticate, um sich anzumelden.

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

Für CI und Skripte senden Sie stattdessen einen API-Schlüssel, statt sich anzumelden:

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
  --header "Authorization: Bearer td_live_YOUR_KEY"

Cursor und andere Clients#

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

Windsurf verwendet serverUrl statt url, und VS Code führt Server unter servers mit "type": "http" auf. Die Seiten der Clients unten enthalten die genauen Dateien.

• Claude CodeEin Befehl im Terminal.
• Claude-Appclaude.ai, Desktop und Mobil: einen benutzerdefinierten Connector hinzufügen.
• CursorIn mcp.json eintragen.
• WindsurfIn mcp_config.json eintragen.
• OpenClawAutonome Agenten über stdio.

Lokaler Server#

Für reine stdio-Clients wie OpenClaw starten Sie denselben Server lokal mit Node.js 22.15 oder neuer. Beide Variablen sind erforderlich.

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

Tools#

get_video_transcript#

Das Tool, das ein Agent verwenden sollte, wenn er gefragt wird, was ein Video sagt.

urlstringPflichtfeld

URL eines YouTube- oder TikTok-Videos.

mode"captions_only" | "auto" | "transcribe"Wahlfrei

Standard captions_only (1 Credit). auto greift auf die KI-Transkription zurück, wenn das Video keine Untertitel hat. transcribe nutzt sie immer (2 Credits pro begonnener Minute, bezahlte Tarife).

format"text" | "srt" | "vtt" | "segments"Wahlfrei

text (Standard) ist für einen Agenten am kompaktesten. segments liefert zeitgestempeltes JSON.

timeout_secondsintegerWahlfrei

Standard 120. Bei Zeitüberschreitung werden stattdessen der Auftragsstatus und die ID zurückgegeben.

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Willkommen zu diesem Beispiel
Dies ist die zweite Zeile
…

Dasselbe Video im selben Modus wird kostenlos aus dem gespeicherten Ergebnis Ihres Arbeitsbereichs beantwortet.

transcribe, wait_for_job, get_transcript#

Die Dreischritt-Variante für Agenten, die die Kontrolle wollen: transcribe nimmt url, mode, optional language und max_credits sowie einen idempotency_key (eine beliebige, gleichbleibende Zeichenkette mit 8 bis 128 Zeichen, damit ein wiederholter Aufruf nie doppelt sendet) und gibt den Auftrag zurück. wait_for_job nimmt job_id und optional timeout_seconds. get_transcript nimmt die result_id des Auftrags als transcript_id und ein format.

Videos finden#

Die Such- und Listentools liefern Videos mit url, Titel, Dauer und Aufrufzahl, die Sie direkt an get_video_transcript übergeben können. channel akzeptiert einen @-Handle, eine Kanal-ID oder eine Kanal-URL, playlist eine ID oder URL und user einen TikTok-@-Benutzernamen oder eine Profil-URL. YouTube-Tools blättern mit limit (Standard 20) und cursor. TikTok liefert höchstens 10 Videos und keine weiteren Seiten. include_details ergänzt Likes, Kommentare, Hashtags und Untertitelsprachen je Video.

Fehler#

Ein fehlgeschlagener Aufruf liefert isError: true mit dem API-Fehlercode, der Meldung und der Request-ID zurück, damit der Agent den Fehler erklären oder den Kurs ändern kann. Die Codes stehen in der API-Referenz.

Problemlösung#

• Unauthorized: Entfernen Sie in Claude den Connector und fügen Sie ihn erneut hinzu, um sich neu anzumelden. Mit einem Schlüssel gehört er in die Serverkonfiguration (Header oder Umgebungsvariable), nicht in Ihre Shell. Prüfen Sie, ob er nicht widerrufen wurde.
• MCP-Server nicht erreichbar: Verwenden Sie die genaue URL https://www.transcriptdock.com/mcp, einschließlich www.
• Tool nicht gefunden: Starten Sie den Client nach einer Änderung seiner Konfiguration neu.
• Lokaler Server startet nicht: Installieren Sie Node.js 22.15 oder neuer und setzen Sie sowohl TRANSCRIPTDOCK_API_KEY als auch TRANSCRIPTDOCK_BASE_URL.
• NO_CAPTIONS: Das Video hat keine Untertitel. Fordern Sie in einem bezahlten Tarif mode: "auto" an.