Servidor MCP de YouTube

Una sola URL remota le da a Claude, ChatGPT, Cursor y cualquier otro cliente compatible con MCP acceso real a YouTube - transcripciones, búsqueda, canales y listas de reproducción - directamente en la conversación.

  • ✓100 créditos gratis para empezar, sin tarjeta de crédito
  • ✓Una sola clave de API funciona tanto para el servidor MCP como para la API REST
  • ✓Consultar las subidas más recientes de un canal siempre es gratis
  • ✓Funciona con Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline y Codex

¿Qué es MCP?

El Model Context Protocol permite que un asistente de IA llame a herramientas en medio de una conversación en lugar de que tú copies y pegues los datos a mano. Este servidor está alojado: apunta un cliente a una URL y descubre las herramientas disponibles automáticamente. No hay nada que instalar ni ejecutar localmente.

Conéctalo en un minuto

HTTP en streaming. Cada cliente de abajo apunta a la misma URL:

https://getyoutubetranscript.com/api/mcp

Claude (Web y Escritorio)

Configuración -> Conectores -> Agregar conector personalizado, luego pega la URL de abajo. Claude te pide iniciar sesión y conectar - no hay clave que copiar.

https://getyoutubetranscript.com/api/mcp

ChatGPT

Configuración -> Conectores -> Avanzado -> Modo desarrollador, agrega un conector con la URL de abajo, luego conecta e inicia sesión.

https://getyoutubetranscript.com/api/mcp

Claude Code

Un solo comando, usando una clave de API de tu panel:

claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
  --header "Authorization: Bearer sk_live_..."

Cursor

Agrega esto a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (solo este proyecto):

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

VS Code (Copilot)

Agrega esto a .vscode/mcp.json. VS Code te pedirá la clave una vez mediante el input de abajo y la guardará de forma segura en lugar de escribirla en el archivo:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gyt-api-key",
      "description": "GetYouTubeTranscript API key",
      "password": true
    }
  ],
  "servers": {
    "getyoutubetranscript": {
      "type": "http",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gyt-api-key}"
      }
    }
  }
}

Codex CLI

Agrega esto a ~/.codex/config.toml, luego exporta la variable de entorno que referencia:

[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"
export GYT_API_KEY="sk_live_..."

Windsurf y Cline

Mismo formato JSON de mcpServers que Cursor, en el archivo de configuración de MCP propio de Windsurf o Cline.

Herramientas disponibles

HerramientaQué haceCosto
get_youtube_transcriptTranscripción completa más título, autor y miniatura1 crédito
search_youtubeBusca videos o canales, con paginación1 crédito
get_channel_latest_videosLos metadatos y las subidas recientes de un canalGratis
search_channel_videosBusca dentro de un canal1 crédito
list_channel_videosTodos los videos que ha subido un canal1 crédito
list_playlist_videosTodos los videos de una lista de reproducción1 crédito
get_creditsSaldo de créditos restante de la claveGratis

Mismas herramientas, mismos costos en créditos, que la API REST - consulta la documentación de la API para ver los endpoints equivalentes.

Así se ve en la conversación

> ¿Qué dijo el último video de 3Blue1Brown sobre redes neuronales?

Voy a revisar su canal para encontrar la subida más reciente y luego obtener su transcripción.

get_channel_latest_videos(channel: "@3blue1brown")

get_youtube_transcript(video_url: "...")

Su último video explica la retropropagación como preguntarse repetidamente "¿cómo cambia el costo final si muevo un poco este número?" - cubriendo la regla de la cadena, los vectores de gradiente y por qué las redes más profundas necesitan una inicialización más cuidadosa...

Precios

100 créditos gratis para empezar. Luego $5/mes por 1000 créditos ($4.50/mes con facturación anual). Un crédito equivale a una llamada de herramienta exitosa - las llamadas fallidas o limitadas por tasa nunca se cobran. El desglose completo, incluyendo los límites de tasa por plan, está en la documentación de la API.

Nota

¿Estás construyendo tu propio cliente, o alimentando esto a un generador de código? El contrato completo de los endpoints REST está publicado en /openapi.json (OpenAPI 3.0) - los mismos endpoints que estas herramientas MCP usan por debajo. Versión legible para humanos: documentación de la API.

Preguntas frecuentes sobre el servidor MCP

¿Con qué clientes MCP funciona esto?

Con cualquier cliente que hable MCP por HTTP en streaming: Claude (web, escritorio, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline y Codex CLI están cubiertos arriba. Si un cliente soporta un servidor MCP remoto por HTTP, funcionará aquí también.

¿Necesito instalar o ejecutar algo?

No. El servidor está alojado en getyoutubetranscript.com - un cliente solo necesita la URL (y, para clientes sin OAuth, una clave de API). No hay proceso local, ni yt-dlp, ni proxy que gestionar.

¿En qué se diferencia esto de un servidor MCP de código abierto que ejecuto yo mismo?

Un servidor autoalojado se ejecuta en tu máquina o en tu propio servidor y normalmente requiere que gestiones el acceso a YouTube (cookies, proxies, límites de tasa) tú mismo. Este está alojado: el registro es autoservicio, las solicitudes pasan por nuestra infraestructura, y se te cobra en créditos en lugar de gestionar infraestructura de scraping.

Recibí un error 401 - ¿qué hago?

Para clientes con OAuth (Claude, ChatGPT), reconecta el conector desde su página de configuración - la conexión probablemente expiró o fue revocada. Para clientes con clave de API (Cursor, VS Code, Claude Code, Codex), verifica que la clave esté pegada correctamente sin espacios extra y que no haya sido revocada desde el panel.

Mi asistente respondió de memoria en lugar de llamar a una herramienta

A veces los modelos asumen que ya conocen el contenido de un video. Pídeselo explícitamente: "usa la herramienta MCP de YouTube para obtener primero la transcripción" - normalmente eso basta para forzar la llamada a la herramienta.

¿Qué pasa si un video no tiene subtítulos en el idioma que pedí?

get_youtube_transcript devuelve un error TRANSCRIPT_NOT_FOUND en lugar de una suposición en el idioma equivocado. Intenta sin el parámetro de idioma (usa inglés por defecto) o verifica primero que el video realmente tenga subtítulos en ese idioma en YouTube.

¿Esto consume mi cuota de la YouTube Data API?

No. No actúa como intermediario de captions.download con tu propia clave, así que no hay un límite diario de 10 000 unidades que gestionar - solo el límite de tasa de solicitudes de tu plan.

¿Puedo usar la misma clave de API para MCP y la API REST?

Sí - una clave, un saldo de créditos, compartido entre ambos. Conectarte mediante OAuth (conectores de Claude/ChatGPT) en lugar de una clave también consume el mismo saldo de la cuenta; generamos una clave dedicada detrás de escena que aparece en la lista de claves de tu panel, para que puedas ver o revocar esa conexión como cualquier otra clave.