MCP-server voor transcripties

De MCP-server geeft een AI-agent dezelfde API als je sleutel: hij kan video's zoeken, ze transcriberen en de resultaten lezen midden in een gesprek. Hij rekent je credits af. Je hoeft niets te installeren: wijs je client naar de externe server, https://www.transcriptdock.com/mcp.

Verbinden#

Claude (claude.ai, Desktop, mobiel)#

• Open Customize, Connectors en kies Add custom connector.
• Geef de connector de naam Transcript Dock en plak https://www.transcriptdock.com/mcp als server-URL. Laat de geavanceerde instellingen leeg.
• Kies Add, en daarna Connect. Log in bij Transcript Dock en kies Allow access.

Je hebt geen API-sleutel nodig: de connector logt in met je account en kan taken lezen en indienen en transcripties lezen, maar niet je sleutels, facturatie of accountinstellingen. Bij Team- en Enterprise-abonnementen voegt een Owner de connector één keer toe onder Organization settings, Connectors, en verbindt elk lid zich daarna.

Claude Code#

Voeg de server toe en voer daarna /mcp uit in Claude Code. Kies Authenticate om in te loggen.

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

Voor CI en scripts stuur je een API-sleutel in plaats van in te loggen:

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

Cursor en andere clients#

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

Windsurf gebruikt serverUrl in plaats van url, en VS Code zet servers onder servers met "type": "http". De pagina's per client hieronder bevatten de exacte bestanden.

• Claude CodeEén terminalcommando.
• Claude-appclaude.ai, Desktop en mobiel: voeg een aangepaste connector toe.
• CursorVoeg toe aan mcp.json.
• WindsurfVoeg toe aan mcp_config.json.
• OpenClawAutonome agents via stdio.

Lokale server#

Voor clients die alleen stdio ondersteunen, zoals OpenClaw, draai je dezelfde server lokaal met Node.js 22.15 of nieuwer. Beide variabelen zijn verplicht.

{
  "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#

De tool die een agent gebruikt als er wordt gevraagd wat een video zegt.

urlstringVerplicht

URL van een YouTube- of TikTok-video.

mode"captions_only" | "auto" | "transcribe"Optioneel

Standaard captions_only (1 credit). auto schakelt over op AI-transcriptie als de video geen ondertitels heeft; transcribe gebruikt altijd AI-transcriptie (2 credits per begonnen minuut, betaalde abonnementen).

format"text" | "srt" | "vtt" | "segments"Optioneel

text (standaard) is het compactst voor een agent; segments geeft getimede JSON terug.

timeout_secondsintegerOptioneel

Standaard 120. Bij een time-out krijg je in plaats daarvan de status en het id van de taak terug.

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

Welkom bij deze video
Vandaag bekijken we hoe het werkt
…

Dezelfde video met dezelfde modus wordt beantwoord uit het opgeslagen resultaat van je werkruimte, gratis.

transcribe, wait_for_job, get_transcript#

De versie in drie stappen, voor agents die zelf de regie willen: transcribe neemt url, mode, optioneel language en max_credits, plus een idempotency_key (een vaste tekst van 8 tot 128 tekens, zodat een opnieuw verzonden aanroep nooit twee keer indient) en geeft de taak terug. wait_for_job neemt job_id en optioneel timeout_seconds. get_transcript neemt de result_id van de taak als transcript_id en een format.

Video's zoeken#

De zoek- en lijsttools geven video's terug met url, titel, duur en aantal weergaven, klaar om door te geven aan get_video_transcript. channel accepteert een @handle, kanaal-id of kanaal-URL; playlist een id of URL; user een TikTok-@user of profiel-URL. YouTube-tools werken met pagina's via limit (standaard 20) en cursor. TikTok geeft maximaal 10 video's terug en geen verdere pagina's; include_details voegt per video likes, reacties, hashtags en ondertiteltalen toe.

Fouten#

Een mislukte aanroep geeft isError: true terug, met de foutcode van de API, het bericht en het request-id, zodat de agent het kan uitleggen of iets anders kan proberen. De codes staan in de API-referentie.

Problemen oplossen#

• Unauthorized: verwijder in Claude de connector en voeg hem opnieuw toe om opnieuw in te loggen. Met een sleutel hoort die in de serverconfiguratie (header of env), niet in je shell; controleer of hij niet is ingetrokken.
• Couldn't reach the MCP server: gebruik de exacte URL https://www.transcriptdock.com/mcp, inclusief www.
• Tool not found: start de client opnieuw nadat je de configuratie hebt aangepast.
• Local server will not start: installeer Node.js 22.15 of nieuwer en stel zowel TRANSCRIPTDOCK_API_KEY als TRANSCRIPTDOCK_BASE_URL in.
• NO_CAPTIONS: de video heeft geen ondertitels. Vraag op een betaald abonnement om mode: "auto".