Volver al blogIntegraciones

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

Respuesta rápida

Añade la URL del servidor y tu clave de API como bearer token en la configuración de tu cliente MCP (el JSON exacto abajo), reinicia el cliente y pídele que obtenga una transcripción por URL: no hace falta copiar y pegar.

Qué es MCP en realidad

El Model Context Protocol estandariza cómo un cliente de IA descubre y llama a herramientas externas. Por debajo, es JSON-RPC 2.0: el cliente le pregunta al servidor qué herramientas existen y cuáles son sus esquemas de entrada, luego las invoca por nombre con argumentos estructurados y recibe un resultado estructurado, todo dentro del mismo turno de la conversación.

Los servidores MCP funcionan sobre uno de dos transportes: stdio, donde el cliente lanza el servidor como un subproceso local (típico para herramientas que necesitan acceso al sistema de archivos local), o HTTP en streaming, donde el servidor es remoto y accesible por HTTPS por cualquier número de clientes a la vez, que es lo que usa este servidor. (En parte de la documentación existe un transporte HTTP+SSE más antiguo, pero está en desuso a favor del HTTP en streaming). En la práctica, esto significa que nunca ejecutas nada localmente para usar este servidor: solo apunta tu cliente a la URL.

Herramientas disponibles

HerramientaQué haceCosto
get_youtube_transcriptTranscripción completa más título, autor y metadatos de la miniatura1 crédito
search_youtubeBusca videos o canales en YouTube, con paginación1 crédito
get_channel_latest_videosLos metadatos de un canal más sus subidas más recientesGratis
search_channel_videosBusca una consulta dentro de un canal, con paginación1 crédito
list_channel_videosLista todos los videos que ha subido un canal, con paginación1 crédito
list_playlist_videosObtén todos los videos de una lista de reproducción, con paginación1 crédito

Las herramientas paginadas (search, list-channel, list-playlist) aceptan un token continuation de una respuesta anterior para obtener la siguiente página, en lugar de un par de offset/límite.

01

Obtén una clave de API

Regístrate desde el panel y crea una clave de API: se incluyen 100 créditos gratis, sin tarjeta requerida. Esta clave es el bearer token con el que se autentica el servidor MCP en la mayoría de los clientes.

02

Añade el servidor a Claude Desktop o Claude Code

Añade esto a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json, o mediante claude mcp add para Claude Code):

{
  "mcpServers": {
    "getyoutubetranscript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Reemplaza sk_live_... con tu propia clave de API. Reinicia el cliente por completo y las 6 herramientas de arriba aparecen automáticamente: la mayoría de los clientes solo leen esta configuración al iniciar, no con una recarga en caliente.

03

Otros clientes: Cursor, Windsurf y agentes personalizados

Cualquier cliente compatible con un servidor MCP remoto sobre HTTP en streaming con encabezados personalizados usa la misma forma de configuración; solo cambian el archivo y los nombres de campo (por ejemplo, el .cursor/mcp.json de Cursor, o el panel de configuración de MCP de Windsurf). Si un cliente solo admite servidores basados en OAuth en lugar de un encabezado bearer estático, usa el flujo de OAuth descrito a continuación.

04

Conectores de ChatGPT y clientes solo con OAuth

Para los clientes que autentican servidores MCP mediante OAuth en lugar de una clave de API pegada (por ejemplo, los conectores personalizados de ChatGPT), este servidor también admite OAuth 2.1 con registro dinámico de clientes: apunta el cliente a la misma URL del servidor y descubrirá los metadatos de OAuth y te guiará por un flujo de autorización en lugar de pedirte un bearer token directamente.

05

Pídele que use una herramienta

Una vez conectado, basta con instrucciones naturales: el modelo decide qué herramienta llamar:

  • "Consigue la transcripción de youtube.com/watch?v=dQw4w9WgXcQ y resúmela en 3 puntos."
  • "Busca en YouTube 'Next.js server actions' y lista los 5 mejores resultados."
  • "Lista todos los videos que ha subido @mkbhd y encuentra los que mencionen 'battery'."

Solución de problemas

Un 401 del servidor MCP significa que falta el bearer token, expiró o tiene un formato incorrecto: verifica que coincida con una clave activa en tu panel. Si las herramientas no aparecen en absoluto después de añadir la configuración, casi siempre el cliente necesita un reinicio completo, no una recarga.

¿Estás creando un agente personalizado en lugar de usar un cliente de chat? El mismo servidor funciona con cualquier cliente compatible con MCP sobre HTTP en streaming. La referencia completa de endpoints REST, créditos y límites de tasa está en la documentación de la API.

Preguntas frecuentes sobre el servidor MCP

Q01

¿Qué es un servidor MCP y por qué usaría uno para transcripciones de YouTube?

MCP (Model Context Protocol) permite que un asistente de IA como Claude llame directamente a herramientas externas durante una conversación. En lugar de pegar una transcripción en el chat, le pides a Claude que la obtenga: llama a la herramienta, recibe la transcripción de vuelta, y puede resumirla, traducirla o buscar en ella en el mismo turno.

Q02

¿MCP es lo mismo que un simple envoltorio de API REST?

No. MCP estandariza el descubrimiento e invocación de herramientas en cualquier cliente compatible: el mismo servidor funciona con Claude Desktop, Claude Code, Cursor, Windsurf o un agente personalizado sin escribir código de conexión específico para cada cliente. Una API REST todavía requiere que tú (o el modelo) conozcan la forma exacta del endpoint; las herramientas de MCP se describen a sí mismas, así que el cliente las lista junto con sus esquemas de entrada automáticamente.

Q03

¿Qué transporte usa este servidor MCP?

HTTP en streaming: el transporte actual para servidores MCP remotos y multicliente (el transporte HTTP+SSE más antiguo está en desuso). Por debajo, los mensajes de MCP son JSON-RPC 2.0, y la capa de transporte simplemente se encarga de llevar esos mensajes hacia y desde el servidor; no necesitas saber JSON-RPC para usarlo, solo la configuración de abajo.

Q04

¿Necesito una clave de API para usar el servidor MCP?

Sí, para la mayoría de las herramientas. Las solicitudes se autentican con un bearer token: la misma clave de API que usarías para la API REST. Regístrate para obtener 100 créditos gratis desde el panel, sin tarjeta requerida. Este servidor también admite OAuth 2.1 (registro dinámico de clientes) para clientes como los conectores de ChatGPT, que se autentican mediante un flujo de OAuth en lugar de un encabezado estático.

Q05

¿Esto cuesta créditos de la misma forma que la API REST?

Sí: cada llamada exitosa a una herramienta medida cuesta 1 crédito, la misma contabilidad que la API REST. get_channel_latest_videos es gratis y nunca cobra un crédito. Las llamadas fallidas nunca se cobran.

Q06

Las herramientas no aparecen después de añadir la configuración, ¿qué debo revisar?

Reinicia el cliente por completo (no solo recargues la ventana); la mayoría de los clientes solo leen la configuración del servidor MCP al iniciar. Luego verifica que el bearer token sea válido (una clave expirada o mal formada devuelve 401, no un síntoma de herramientas faltantes) y que la URL no tenga ningún error de tipeo: una ruta incorrecta devuelve 404 antes incluso de verificar la autenticación.

Q07

¿Es seguro poner mi clave de API en un archivo de configuración?

Trata un archivo de configuración de MCP como cualquier otro archivo de credenciales: no lo subas a un repositorio público, y prefiere el soporte de secretos/variables de entorno de tu cliente en lugar de una clave escrita directamente si tu cliente lo ofrece. La conexión en sí funciona sobre HTTPS, así que el token no queda expuesto en tránsito.

Relacionado