Retour au blogIntégrations

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

Ajoutez l'URL du serveur et votre clé API comme jeton porteur (bearer token) dans la configuration de votre client MCP (JSON exact ci-dessous), redémarrez le client, et demandez-lui de récupérer une transcription par URL - aucun copier-coller nécessaire.

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

OutilCe qu'il faitCoût
get_youtube_transcriptTranscription complète plus titre, auteur, et métadonnées de miniature1 crédit
search_youtubeRecherche sur YouTube des vidéos ou chaînes, avec pagination1 crédit
get_channel_latest_videosMétadonnées d'une chaîne plus ses publications les plus récentesGratuit
search_channel_videosRecherche une requête au sein d'une chaîne, avec pagination1 crédit
list_channel_videosListe toutes les vidéos publiées par une chaîne, avec pagination1 crédit
list_playlist_videosRécupère toutes les vidéos d'une playlist, avec pagination1 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.

01

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.

02

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.

03

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.

04

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.

05

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

Un 401 du serveur MCP signifie que le jeton porteur est manquant, expiré, ou malformé - vérifiez qu'il correspond à une clé active sur votre tableau de bord. Si les outils n'apparaissent pas du tout après l'ajout de la configuration, le client a presque toujours besoin d'un redémarrage complet, pas d'un simple rechargement.

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

Q01

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.

Q02

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.

Q03

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.

Q04

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.

Q05

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.

Q06

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.

Q07

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