Transcriptions YouTube via MCP avec l'API Claude

L'API Claude peut récupérer les transcriptions YouTube par elle-même si vous lui fournissez un serveur MCP dans la requête. Le connecteur MCP d'Anthropic permet à l'API Messages d'appeler un serveur distant, de découvrir ses outils et de les invoquer en cours de completion — sans boucle d'exécution d'outils de votre côté. J'ai vérifié le bloc ci-dessous avec le serveur MCP hébergé de youtube2text.org aujourd'hui.

La requête

Le connecteur MCP est une fonctionnalité bêta, donc elle nécessite l'en-tête anthropic-beta: mcp-client-2025-11-20, et elle prend deux parties qui doivent se référencer mutuellement : l'entrée mcp_servers déclare la connexion, et une entrée mcp_toolset dans tools accorde l'accès par nom. Omettez le toolset et l'API rejette la requête avec une erreur de validation.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 16000,
    "mcp_servers": [{
      "type": "url",
      "url": "https://youtube2text.org/mcp",
      "name": "youtube2text",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "youtube2text"}],
    "messages": [{
      "role": "user",
      "content": "Summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ in five bullets."
    }]
  }'

Deux clés sont en jeu et elles ne sont pas interchangeables. x-api-key dans l'en-tête est votre clé Anthropic. authorization_token dans mcp_servers est votre clé youtube2text — elle est transmise au serveur de transcription en tant que jeton bearer. Obtenez-en une via la connexion Google sur youtube2text.org/app/keys, ou utilisez la clé démo partagée depuis GET https://youtube2text.org/api/demo-key (5 vidéos/mois par IP).

Ce qui revient

Le tableau content de la réponse intercale l'activité de l'outil avec la réponse : un bloc mcp_tool_use montrant Claude invoquant transcribe_video avec l'URL qu'il a extraite de votre prompt, un bloc mcp_tool_result contenant {title, content, contentSize, videoId, pubDate, truncated}, puis un bloc text avec le résumé réel. Anthropic exécute l'intégralité du round-trip d'outil côté serveur — votre code fait une seule requête HTTP et lit le message final.

Comme le connecteur est en bêta, traitez-le en conséquence : l'en-tête est obligatoire, et la forme de la requête a déjà changé une fois (les anciens articles montrent mcp_servers sans l'entrée mcp_toolset — cette forme précède l'en-tête actuel). Épinglez la chaîne bêta et vérifiez la réponse pour les blocs mcp_tool_result avant de supposer que la transcription est arrivée.

Le chemin sans code

Vous ne construisez pas contre l'API ? Deux lignes : sur claude.ai allez à Paramètres → Connecteurs → Ajouter un connecteur personnalisé, collez https://youtube2text.org/mcp, complétez la connexion Google, cliquez sur Autoriser. Le serveur parle OAuth 2.1 avec enregistrement dynamique de client et PKCE, donc claude.ai gère la poignée de main complète — les détails et comment l'utiliser dans transcriptions YouTube gratuites dans Claude.

Les utilisateurs de Claude Code obtiennent le même outil avec :

claude mcp add --transport http youtube2text https://youtube2text.org/mcp

puis /mcp dans une session pour se connecter.

Quand utiliser quoi

Utilisez le bloc mcp_servers quand vous construisez un produit sur l'API Messages et que vous voulez l'accès aux transcriptions dans une boucle d'agent existante. Utilisez directement le point de terminaison REST quand vous avez juste besoin du texte — faire passer une transcription par Claude pour l'extraire est une fonction identité coûteuse. Et si votre pile est côté OpenAI, l'API Responses prend le même serveur MCP avec un bloc presque identique.

L'utilisation est mesurée par rapport à votre plan youtube2text : la version gratuite couvre 5 vidéos par mois, basic est $5.99/50, pro $9.99/500, unlimited $19.99. Clés sur youtube2text.org/app/keys.