Conecta tu asistente por MCP

Tu asistente de IA puede pedir y leer transcripciones si lo conectas al servidor remoto de Model Context Protocol de transcript1. Puedes enviar enlaces de YouTube, X, TikTok, Instagram, Facebook y Bluesky, o subir archivos de audio y video. Consulta las demás grabaciones públicas admitidas y sus restricciones en Fuentes y opciones.

Usa publicaciones públicas; si tienen varios videos, solo se transcribe el primero. Además de YouTube y X, puedes obtener subtítulos en el idioma original de TikTok, Bluesky, Dailymotion y LinkedIn. Si no hay una pista que se pueda usar, el modo auto transcribe el audio con IA al mismo precio por minuto. Fuera de YouTube, los subtítulos solo incluyen marcas de tiempo por segmento (words: null), incluso en pistas automáticas.

El modo captions (solo subtítulos) nunca descarga audio ni usa STT. Si activas la identificación de hablantes o eliges source=stt, se transcribe directamente el audio. Revisa las opciones en Fuentes y opciones.

• Endpoint: https://api.transcript1.com/mcp (streamable HTTP).
• Cómo autenticarte: Claude y ChatGPT usan OAuth 2.1: inicias sesión en transcript1 y apruebas el acceso. Para Cursor, VS Code, Claude Code y agentes, envía una clave de API con Authorization: Bearer t1_.... Puedes crearla en “API keys”.

Las herramientas llaman a la API REST /v1 con tu credencial. Las reglas de validación, cobro y errores son las mismas. MCP comparte los minutos y los límites de requests de tu cuenta con las demás llamadas.

Qué puede hacer tu asistente

Formato, espera y páginas

• Por defecto, format es text: cada segmento ocupa una línea con su marca de tiempo. Si activaste la identificación de hablantes, también aparece la etiqueta, como en [00:01:02] Speaker 1: Good morning. Puedes elegir srt, vtt o json.
• wait_seconds admite de 0 a 55 y usa 50 por defecto. Si el texto no está listo al terminar la espera, la respuesta lo indica e incluye el id. Pásalo a get_transcription para seguir esperando.
• El texto largo se divide en páginas, siempre entre segmentos completos. max_chars define el tamaño: 60,000 por defecto, con un rango de 1,000 a 100,000. Usa el next_from_seconds de la respuesta como from_seconds en la siguiente consulta para continuar leyendo.
• La respuesta indica de dónde viene el texto en transcript_source: youtube_captions, x_captions, tiktok_captions, bluesky_captions, dailymotion_captions, linkedin_captions o speech_to_text. Si recibes caption_kind: null, el origen de la pista es desconocido; no significa que el creador la haya subido.

Consulta la transcripción antes de volver a enviarla

transcribe siempre activa reuse_recent. Si usas el enlace completo y repites el mismo video con las mismas opciones dentro de 24 horas, recuperas la transcripción anterior sin pagar de nuevo. La respuesta avisa cuando la reutiliza. Esto no funciona con enlaces cortos. Para revisar algo que ya enviaste, usa get_transcription o list_transcriptions en lugar de crear otra transcripción.

Cómo sube archivos el asistente

Los bytes del archivo no viajan por MCP. Al llamar a create_upload, el asistente recibe el id de la transcripción, la plantilla de URL para cada parte, un X-Upload-Token y la lista de partes. Después debe enviarlas por HTTP con PUT, fuera de MCP, y llamar a complete_upload. La respuesta también ofrece la página del panel para subir el archivo como alternativa. Consulta el protocolo en Cómo subir archivos.

Si necesitas webhooks

Para usar webhooks, llama a la API REST. Las herramientas MCP no tienen un parámetro para configurarlos.

Claude

En Claude, agrega transcript1 como conector personalizado para conectarte al servidor MCP remoto.

1. Ve a los ajustes de conectores de Claude y crea uno personalizado.
2. Ponle el nombre transcript1 e indica https://api.transcript1.com/mcp como URL del servidor.
3. Cuando se abra transcript1, inicia sesión y aprueba el acceso con los permisos transcriptions:read y transcriptions:write.

Ya puedes pedirle algo como “Transcribe https://www.youtube.com/watch?v=dQw4w9WgXcQ”. La disponibilidad de conectores personalizados depende de tu plan de Claude.

ChatGPT

Para conectar ChatGPT, también necesitas un conector personalizado.

1. Ve a los ajustes de conectores de ChatGPT y crea un conector personalizado para MCP.
2. Usa la URL de servidor https://api.transcript1.com/mcp.
3. Completa el inicio de sesión en transcript1 y aprueba la conexión.

La opción depende de tu plan de ChatGPT y de los ajustes del espacio de trabajo. Puede ser necesario activar el modo de desarrollador.

Conecta Cursor

Puedes agregar transcript1 a Cursor con un clic.

Si prefieres configurarlo a mano, añade esto a .cursor/mcp.json y coloca tu clave de API en el header Authorization:

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

VS Code

Puedes agregar transcript1 a VS Code con un clic.

Para hacerlo a mano, añade esta configuración a .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "transcript1": {
      "type": "http",
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

Conecta Claude Code

Sustituye t1_YOURKEY por tu clave de API y ejecuta el comando:

claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"

Usa otro cliente MCP

Si tu cliente admite servidores MCP remotos, conéctalo a https://api.transcript1.com/mcp con el header Authorization: Bearer t1_....

Conecta clientes que ejecutan un comando, como Claude Desktop

Si el cliente inicia el servidor MCP ejecutando un comando, usa npx -y @transcript1/mcp y configura TRANSCRIPT1_API_KEY con tu clave de API. Este paquete se conecta al servidor remoto de transcript1. Necesitas Node.js 18 o posterior.

En Claude Desktop, pega esta configuración en claude_desktop_config.json. Cambia t1_YOURKEY por una clave de “API keys”.

{
  "mcpServers": {
    "transcript1": {
      "command": "npx",
      "args": ["-y", "@transcript1/mcp"],
      "env": { "TRANSCRIPT1_API_KEY": "t1_YOURKEY" }
    }
  }
}

Agent Skill

El Agent Skill de transcript1 es un archivo breve llamado SKILL.md con las instrucciones que necesita el agente para usar el servicio. Si tu agente admite skills, puedes añadirlo desde https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md.

Si el agente descubre skills automáticamente, puede encontrarlo en el índice https://transcript1.com/.well-known/agent-skills/index.json.

Cómo responde una herramienta cuando falla

Si una herramienta falla, devuelve el mismo code que la API REST, una explicación y una acción que el asistente puede seguir. La respuesta tiene el formato <code>: <message>. <next step>. Por ejemplo, si no te alcanzan los minutos:

insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing

Consulta el significado de cada código en Errores. Si lo que falla es la transcripción, la respuesta usa el mismo formato con el código correspondiente, como media_private o no_captions.