Servidor MCP de transcripciones

El servidor MCP le da a un agente de IA la misma API que tu clave: puede encontrar videos, transcribirlos y leer los resultados en plena conversación. Se cobra de tus créditos. No hay nada que instalar: apunta el cliente al servidor remoto, https://www.transcriptdock.com/mcp.

Conectar#

Claude (claude.ai, escritorio, móvil)#

• Abre Personalizar, Conectores y elige Agregar conector personalizado.
• Ponle el nombre Transcript Dock y pega https://www.transcriptdock.com/mcp como URL del servidor. Deja vacía la configuración avanzada.
• Elige Agregar y luego Conectar. Inicia sesión en Transcript Dock y elige Permitir acceso.

No interviene ninguna clave de API: el conector inicia sesión con tu cuenta y puede leer y enviar trabajos y leer transcripciones, pero nunca claves, facturación ni la configuración de la cuenta. En los planes Team y Enterprise, un propietario lo agrega una sola vez en Configuración de la organización, Conectores, y cada miembro se conecta por su cuenta.

Claude Code#

Agrega el servidor, luego ejecuta /mcp en Claude Code y elige Authenticate para iniciar sesión.

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

Para CI y scripts, envía una clave de API en lugar de iniciar sesión:

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
  --header "Authorization: Bearer td_live_YOUR_KEY"

Cursor y otros clientes#

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

Windsurf usa serverUrl en lugar de url, y VS Code enumera los servidores bajo servers con "type": "http". Las páginas de cada cliente, más abajo, tienen los archivos exactos.

• Claude CodeUn solo comando de terminal.
• App de Claudeclaude.ai, escritorio y móvil: agrega un conector personalizado.
• CursorAgrégalo a mcp.json.
• WindsurfAgrégalo a mcp_config.json.
• OpenClawAgentes autónomos por stdio.

Servidor local#

Para clientes que solo admiten stdio, como OpenClaw, ejecuta el mismo servidor de forma local con Node.js 22.15 o superior. Las dos variables son obligatorias.

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

Herramientas#

get_video_transcript#

La herramienta que un agente debería usar cuando le preguntan qué dice un video.

urlstringObligatorio

URL de un video de YouTube o TikTok.

mode"captions_only" | "auto" | "transcribe"Opcional

Por defecto captions_only (1 crédito). auto recurre a la transcripción con IA cuando el video no tiene subtítulos; transcribe la usa siempre (2 créditos por minuto iniciado, planes de pago).

format"text" | "srt" | "vtt" | "segments"Opcional

text (por defecto) es el más compacto para un agente; segments devuelve JSON con tiempos.

timeout_secondsintegerOpcional

Por defecto 120. Si se agota el tiempo, se devuelven en su lugar el estado del trabajo y su id.

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Never gonna give you up
Never gonna let you down
…

El mismo video con el mismo modo se responde desde el resultado guardado en tu espacio de trabajo, gratis.

transcribe, wait_for_job, get_transcript#

La versión de tres pasos para agentes que quieren más control: transcribe recibe url, mode, language opcional y max_credits, además de una idempotency_key (cualquier cadena estable de 8 a 128 caracteres, para que una llamada reintentada nunca envíe dos veces) y devuelve el trabajo. wait_for_job recibe job_id y un timeout_seconds opcional. get_transcript recibe el result_id del trabajo como transcript_id y un format.

Encontrar videos#

Las herramientas de búsqueda y listado devuelven videos con url, título, duración y número de vistas, listos para pasarse a get_video_transcript. channel acepta un @handle, un id de canal o una URL de canal; playlist, un id o una URL; user, un @usuario de TikTok o la URL de un perfil. Las herramientas de YouTube paginan con limit (por defecto 20) y cursor. TikTok devuelve como máximo 10 videos y no tiene más páginas; include_details agrega por video los me gusta, comentarios, hashtags e idiomas de subtítulos.

Errores#

Una llamada fallida devuelve isError: true con el código de error de la API, el mensaje y el id de la solicitud, para que el agente pueda explicarlo o cambiar de rumbo. Los códigos son los de la referencia de la API.

Solución de problemas#

• No autorizado: en Claude, elimina el conector y vuelve a agregarlo para iniciar sesión desde cero. Con una clave, va en la configuración del servidor (encabezado o variable de entorno), no en tu shell; revisa que no se haya revocado.
• No se pudo conectar con el servidor MCP: usa la URL exacta https://www.transcriptdock.com/mcp, con www incluido.
• Herramienta no encontrada: reinicia el cliente después de editar su configuración.
• El servidor local no inicia: instala Node.js 22.15 o superior y define tanto TRANSCRIPTDOCK_API_KEY como TRANSCRIPTDOCK_BASE_URL.
• NO_CAPTIONS: el video no tiene subtítulos. En un plan de pago, pide mode: "auto".