YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools
How the Model Context Protocol works, how to connect the GetYouTubeTranscript MCP server to Claude Desktop, Claude Code, Cursor, Windsurf, or ChatGPT, and how to troubleshoot the connection.
00:08:00 · SEP 13, 2026
Réponse rapide
Ce qu'est réellement MCP
Le Model Context Protocol standardise la façon dont un client IA découvre et appelle des outils externes. Sous le capot, c'est du JSON-RPC 2.0 - le client demande au serveur quels outils existent et leurs schémas d'entrée, puis les invoque par nom avec des arguments structurés et récupère un résultat structuré, le tout dans le même tour de conversation.
Les serveurs MCP fonctionnent via l'un de ces deux transports : stdio, où le client lance le serveur comme sous-processus local (typique pour les outils nécessitant un accès au système de fichiers local), ou Streamable HTTP, où le serveur est distant et accessible via HTTPS par un nombre quelconque de clients simultanément - c'est ce que ce serveur utilise. (Un ancien transport HTTP+SSE existe dans certaines documentations mais est déprécié au profit de Streamable HTTP.) Concrètement, cela signifie que vous n'exécutez jamais rien en local pour utiliser ce serveur - il suffit de pointer votre client vers l'URL.
Outils disponibles
| Outil | Ce qu'il fait | Coût |
|---|---|---|
get_youtube_transcript | Transcription complète plus titre, auteur, et métadonnées de miniature | 1 crédit |
search_youtube | Recherche sur YouTube des vidéos ou chaînes, avec pagination | 1 crédit |
get_channel_latest_videos | Métadonnées d'une chaîne plus ses publications les plus récentes | Gratuit |
search_channel_videos | Recherche une requête au sein d'une chaîne, avec pagination | 1 crédit |
list_channel_videos | Liste toutes les vidéos publiées par une chaîne, avec pagination | 1 crédit |
list_playlist_videos | Récupère toutes les vidéos d'une playlist, avec pagination | 1 crédit |
Les outils paginés (search, list-channel, list-playlist) acceptent tous un jeton continuation issu d'une réponse précédente pour récupérer la page suivante, plutôt qu'une paire offset/limit.
Obtenir une clé API
Inscrivez-vous depuis le tableau de bord et créez une clé API - 100 crédits sont inclus gratuitement, sans carte requise. Cette clé est le jeton porteur avec lequel le serveur MCP s'authentifie pour la plupart des clients.
Ajouter le serveur à Claude Desktop ou Claude Code
Ajoutez ceci à la configuration de votre client MCP (par ex. claude_desktop_config.json, ou via claude mcp add pour Claude Code) :
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}Remplacez sk_live_... par votre propre clé API. Redémarrez complètement le client et les 6 outils ci-dessus apparaissent automatiquement - la plupart des clients ne lisent cette configuration qu'au démarrage, pas lors d'un rechargement à chaud.
Autres clients : Cursor, Windsurf, et agents personnalisés
Tout client prenant en charge un serveur MCP distant via Streamable HTTP avec des en-têtes personnalisés utilise le même type de configuration - seuls le fichier et les noms de champs environnants diffèrent (par ex. le .cursor/mcp.json de Cursor, le panneau de paramètres MCP de Windsurf). Si un client ne prend en charge que les serveurs basés sur OAuth plutôt qu'un en-tête porteur statique, utilisez plutôt le flux OAuth décrit ensuite.
Connecteurs ChatGPT et clients OAuth uniquement
Pour les clients qui authentifient les serveurs MCP via OAuth plutôt qu'une clé API collée (par exemple, les connecteurs personnalisés de ChatGPT), ce serveur prend aussi en charge OAuth 2.1 avec Dynamic Client Registration - pointez le client vers la même URL de serveur et il découvrira les métadonnées OAuth et vous guidera à travers un flux d'autorisation au lieu de demander un jeton porteur directement.
Lui demander d'utiliser un outil
Une fois connecté, des prompts naturels suffisent - le modèle décide quel outil appeler :
- "Récupère la transcription de youtube.com/watch?v=dQw4w9WgXcQ et résume-la en 3 points."
- "Recherche sur YouTube 'Next.js server actions' et liste les 5 premiers résultats."
- "Liste toutes les vidéos publiées par @mkbhd et trouve celles qui mentionnent 'batterie'."
Dépannage
Vous construisez un agent personnalisé plutôt que d'utiliser un client de chat ? Le même serveur fonctionne avec n'importe quel client compatible MCP via Streamable HTTP. La référence complète des points d'accès REST, les crédits, et les limites de débit se trouvent dans la documentation API.
FAQ sur le serveur MCP
Qu'est-ce qu'un serveur MCP, et pourquoi l'utiliser pour des transcriptions YouTube ?
MCP (Model Context Protocol) permet à un assistant IA comme Claude d'appeler des outils externes directement pendant une conversation. Au lieu de coller une transcription dans le chat, vous demandez à Claude de la récupérer - il appelle l'outil, récupère la transcription, et peut la résumer, la traduire, ou la rechercher dans le même tour.
MCP est-il la même chose qu'un simple wrapper d'API REST ?
Non. MCP standardise la découverte et l'invocation d'outils sur tout client conforme - le même serveur fonctionne avec Claude Desktop, Claude Code, Cursor, Windsurf, ou un agent personnalisé sans écrire de code de liaison spécifique au client. Une API REST exige toujours que vous (ou le modèle) connaissiez le format exact du point d'accès ; les outils MCP sont auto-descriptifs, donc le client les liste ainsi que leurs schémas d'entrée automatiquement.
Quel transport ce serveur MCP utilise-t-il ?
Streamable HTTP - le transport actuel pour les serveurs MCP distants et multi-clients (l'ancien transport HTTP+SSE est déprécié). Sous le capot, les messages MCP sont du JSON-RPC 2.0, et la couche transport se contente d'acheminer ces messages vers et depuis le serveur ; vous n'avez pas besoin de connaître JSON-RPC pour l'utiliser, seulement la configuration ci-dessous.
Ai-je besoin d'une clé API pour utiliser le serveur MCP ?
Oui pour la plupart des outils. Les requêtes sont authentifiées avec un jeton porteur - la même clé API que celle utilisée pour l'API REST. Inscrivez-vous pour obtenir 100 crédits gratuits depuis le tableau de bord, sans carte requise. Ce serveur prend aussi en charge OAuth 2.1 (Dynamic Client Registration) pour des clients comme les connecteurs ChatGPT qui s'authentifient via un flux OAuth plutôt qu'un en-tête statique.
Cela consomme-t-il des crédits de la même manière que l'API REST ?
Oui - chaque appel d'outil facturé réussi coûte 1 crédit, la même comptabilité que l'API REST. get_channel_latest_videos est gratuit et ne facture jamais de crédit. Les appels échoués ne sont jamais facturés.
Les outils n'apparaissent pas après avoir ajouté la configuration - que dois-je vérifier ?
Redémarrez complètement le client (pas seulement un rechargement de la fenêtre) - la plupart des clients ne lisent la configuration du serveur MCP qu'au démarrage. Vérifiez ensuite que le jeton porteur est valide (une clé expirée ou malformée renvoie 401, pas un symptôme d'outils manquants) et que l'URL ne contient aucune coquille - un chemin erroné renvoie 404 avant même que l'authentification soit vérifiée.
Est-il prudent de mettre ma clé API dans un fichier de configuration ?
Traitez un fichier de configuration MCP comme n'importe quel autre fichier d'identifiants - ne le commitez pas dans un dépôt public, et privilégiez le support des secrets/variables d'environnement de votre client plutôt qu'une clé codée en dur, s'il en propose un. La connexion elle-même passe par HTTPS, donc le jeton n'est pas exposé en transit.
À lire aussi