Serveur MCP Transcript Dock

Le serveur MCP donne à un agent IA la même API que votre clé : il peut trouver des vidéos, les transcrire et lire les résultats au milieu d'une conversation. Il débite vos crédits. Rien à installer : indiquez au client le serveur distant, https://www.transcriptdock.com/mcp.

Connexion#

Claude (claude.ai, Desktop, mobile)#

• Ouvrez Personnaliser, Connecteurs et choisissez Ajouter un connecteur personnalisé.
• Nommez-le Transcript Dock et collez https://www.transcriptdock.com/mcp comme URL du serveur. Laissez les paramètres avancés vides.
• Choisissez Ajouter, puis Connecter. Connectez-vous à Transcript Dock et choisissez Autoriser l'accès.

Aucune clé API n'est nécessaire : le connecteur se connecte avec votre compte et peut lire et soumettre des tâches ainsi que lire des transcriptions, mais jamais les clés, la facturation ni les paramètres du compte. Sur les forfaits Team et Enterprise, un propriétaire l'ajoute une seule fois dans Paramètres de l'organisation, Connecteurs, puis chaque membre se connecte.

Claude Code#

Ajoutez le serveur, puis exécutez /mcp dans Claude Code et choisissez Authenticate pour vous connecter.

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

Pour l'intégration continue et les scripts, envoyez une clé API au lieu de vous connecter :

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

Cursor et autres clients#

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

Windsurf utilise serverUrl au lieu de url, et VS Code liste les serveurs sous servers avec "type": "http". Les pages des clients ci-dessous donnent les fichiers exacts.

• Claude CodeUne seule commande dans le terminal.
• Application Claudeclaude.ai, Desktop et mobile : ajoutez un connecteur personnalisé.
• CursorÀ ajouter dans mcp.json.
• WindsurfÀ ajouter dans mcp_config.json.
• OpenClawAgents autonomes via stdio.

Serveur local#

Pour les clients qui ne gèrent que stdio, comme OpenClaw, lancez le même serveur en local avec Node.js 22.15 ou plus récent. Les deux variables sont obligatoires.

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

Outils#

get_video_transcript#

L'outil que l'agent doit utiliser lorsqu'on lui demande ce que dit une vidéo.

urlstringRequis

URL d'une vidéo YouTube ou TikTok.

mode"captions_only" | "auto" | "transcribe"Facultatif

Par défaut captions_only (1 crédit). auto passe à la transcription par IA lorsque la vidéo n'a pas de sous-titres ; transcribe l'utilise toujours (2 crédits par minute commencée, forfaits payants).

format"text" | "srt" | "vtt" | "segments"Facultatif

text (par défaut) est le format le plus compact pour un agent ; segments renvoie du JSON horodaté.

timeout_secondsintegerFacultatif

Par défaut 120. En cas de dépassement de délai, l'état et l'identifiant de la tâche sont renvoyés à la place.

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

Welcome to this video.
Today we cover the basics.
…

La même vidéo, avec le même mode, reçoit une réponse gratuite depuis le résultat enregistré dans votre espace de travail.

transcribe, wait_for_job, get_transcript#

La version en trois étapes, pour les agents qui veulent contrôler chaque étape : transcribe prend url, mode, éventuellement language et max_credits, ainsi qu'une idempotency_key (une chaîne stable de 8 à 128 caractères, pour qu'un appel relancé ne soit jamais soumis deux fois). Il renvoie la tâche. wait_for_job prend job_id et, en option, timeout_seconds. get_transcript prend le result_id de la tâche comme transcript_id, ainsi qu'un format.

Trouver des vidéos#

Les outils de recherche et de liste renvoient des vidéos avec leur url, leur titre, leur durée et leur nombre de vues, prêtes à être transmises à get_video_transcript. channel accepte un @handle, un identifiant de chaîne ou une URL de chaîne ; playlist un identifiant ou une URL ; user un @user TikTok ou une URL de profil. Les outils YouTube paginent avec limit (par défaut 20) et cursor. TikTok renvoie 10 vidéos au maximum et aucune page suivante. include_details ajoute, pour chaque vidéo, le nombre de j'aime, de commentaires, de hashtags et de langues de sous-titres.

Erreurs#

Un appel échoué renvoie isError: true avec le code d'erreur de l'API, le message et l'identifiant de requête, afin que l'agent puisse l'expliquer ou changer de stratégie. Les codes sont ceux de la référence de l'API.

Dépannage#

• Unauthorized : dans Claude, supprimez le connecteur et ajoutez-le à nouveau pour vous reconnecter. Avec une clé, elle doit figurer dans la configuration du serveur (en-tête ou variable d'environnement), et non dans votre shell. Vérifiez qu'elle n'a pas été révoquée.
• Impossible de joindre le serveur MCP : utilisez l'URL exacte https://www.transcriptdock.com/mcp, avec www.
• Outil introuvable : redémarrez le client après avoir modifié sa configuration.
• Le serveur local ne démarre pas : installez Node.js 22.15 ou plus récent, puis définissez TRANSCRIPTDOCK_API_KEY et TRANSCRIPTDOCK_BASE_URL.
• NO_CAPTIONS : la vidéo n'a pas de sous-titres. Sur un forfait payant, demandez mode: "auto".