Ir a la referencia MCP

Documentación MCP

Tus transcripciones en tu asistente de IA.

Conectar clienteExplorar herramientas
En esta página

Taption MCP

Conecta Taption a un cliente MCP para transcribir y traducir audio y vídeo, leer transcripciones y traducciones completadas y consultar trabajos recientes desde la conversación.

Model Context Protocol (MCP) permite al asistente usar las herramientas de Taption en tu nombre. Esta conexión personalizada permite leer transcripciones y crear nuevos trabajos de transcripción y traducción.

Streamable HTTPOAuth 2.1

URL del servidor

https://api.taption.com/mcp-custom

Usa esta URL completa al añadir Taption como servidor MCP remoto.

Transporte
Streamable HTTP
Autenticación
OAuth 2.1

Requisitos

  • Una cuenta de Taption, sin suscripción de pago obligatoria. Si usas correo y contraseña, verifica tu correo antes de conectar.
  • Minutos disponibles para crear transcripciones y traducciones. Se aplican los límites de tu cuenta y plan.
  • Un cliente compatible con Streamable HTTP remoto y OAuth. El plan del cliente y las políticas de tu organización pueden limitar el acceso.

Fuentes multimedia compatibles

Usa una URL directa de audio o vídeo, un archivo público de Google Drive o un vídeo de YouTube. El servidor personalizado también acepta publicaciones públicas de Facebook, Instagram, TikTok, X, Threads, Vimeo, Dailymotion, Bilibili (bilibili.tv), y vídeos o clips de Twitch.

ChatGPT también puede proporcionar archivos de audio o vídeo subidos si su integración de archivos está disponible. Otros clientes pueden usar una URL descargable.

Taption debe poder acceder al enlace. No se admiten emisiones en directo; usa la grabación finalizada.

Configura tu cliente

Elige tu aplicación para ver la guía completa de configuración paso a paso.

Autenticación

Taption usa OAuth 2.1 con PKCE. Inicia sesión y aprueba la conexión. El cliente gestiona la autorización y renueva automáticamente el token de acceso, válido durante una hora.

MCP usa tokens OAuth. Las claves REST API de Taption no sirven para autenticar esta conexión.

Usa /mcp-custom durante toda la configuración. Un token emitido para /mcp no funciona en /mcp-custom.

Para revocar el acceso, abre Cuenta → Aplicaciones conectadas en Taption y desconecta el cliente. Para restaurarlo, vuelve a conectar y autorizar.

Permisos de conexión

transcripts:read
Leer estado y contenido de transcripciones y listar las recientes.
transcripts:write
Crear trabajos de transcripción y traducción con los minutos de tu cuenta.

Flujos de trabajo compatibles

Indica el medio y el resultado deseado. El asistente usa las herramientas de Taption para seguir estos pasos.

  1. Elegir medio y resultado

    Proporciona un enlace o archivo compatible, el idioma hablado y el objetivo: texto simple, etiquetas de hablantes o subtítulos. El asistente pregunta lo que falta antes de empezar.

  2. Transcribir y consultar el progreso

    transcribe devuelve un ID inmediatamente. get_transcript espera un momento si el trabajo está por terminar; si sigue en proceso, vuelve a preguntar en aproximadamente un minuto. Si tienes activadas las notificaciones por correo en Taption, también recibirás un correo al terminar.

  3. Leer, resumir y exportar

    Lee el texto terminado o pide un resumen al asistente. Usa los enlaces SRT y del editor cuando estén disponibles. El editor de Taption ofrece más formatos de exportación.

Prueba estas peticiones

Transcribe esta grabación en inglés con etiquetas para dos hablantes: [your media URL].
Crea subtítulos para este vídeo en japonés: [your media URL]. Usa 16 caracteres por línea.
Transcribe esta entrevista en inglés como subtítulos y tradúcela al japonés y al español: [your media URL].
Traduce mi transcripción “Weekly sync” al chino tradicional.
Busca mis transcripciones recientes de Taption y resume la entrevista terminada. Incluye los enlaces de subtítulos y del editor si están disponibles.

Sustituye [your media URL] por tu enlace. El asistente genera el resumen a partir del texto. Personalizar la longitud de los subtítulos depende del plan de Taption.

transcribe

Crea un trabajotranscripts:write

Inicia una transcripción en segundo plano con media_url o file. El idioma y el objetivo deben venir del usuario. Si faltan, se solicitan sin iniciar el trabajo. Añade translate_to para traducir la transcripción automáticamente al terminar.

Parámetros

media_urlstringUna fuente multimedia

Enlace multimedia compatible, máximo 2.048 caracteres. Usa este campo o file.

fileobjectUna fuente multimedia

Archivo proporcionado por el cliente con download_url y file_id. mime_type y file_name son opcionales. Taption debe poder descargar la URL.

languagestringNecesario al empezar

Idioma hablado, por ejemplo en-US, zh-TW, ja-JP o es-ES. Pregunta al usuario; no lo deduzcas del archivo o del chat.

Ver códigos de idioma
purposestringNecesario al empezar

transcript: texto puntuado; speakers: etiquetas de hablantes; captions: segmentos de subtítulos. Pedir solo transcribir no elige un objetivo.

transcriptspeakerscaptions
speaker_countinteger

Hablantes estimados para speakers: 2–10. Por defecto: 2.

max_charactersinteger

1–200 caracteres por línea para captions en planes de pago elegibles. Por defecto: 16 para zh/ja/ko/yue y 65 para el resto.

translate_tostring[]

Opcional. 1–5 idiomas a los que traducir al terminar la transcripción, como en, ja o zh-TW. Cada uno usa además minutos iguales a la duración del archivo.

extensionstring

Extensión del archivo subido si no se puede inferir. Innecesaria para enlaces. Acepta audio y formatos de vídeo compatibles; no 3gp.

namestring

Nombre de la transcripción, máximo 200 caracteres. Por defecto usa el nombre del archivo.

Ejemplo de argumentos

{
  "media_url": "https://example.com/interview.mp4",
  "language": "en-US",
  "purpose": "speakers",
  "speaker_count": 2,
  "translate_to": [
    "ja"
  ],
  "name": "Interview"
}

Valores ilustrativos: sustituye la URL o el ID por los tuyos.

Devuelve ID y estado. Cada creación correcta inicia un trabajo nuevo y consume minutos, además de minutos iguales a la duración del archivo por cada idioma de translate_to. Usa el mismo ID para comprobar el progreso en lugar de enviar otra solicitud.

get_transcript

Solo lecturatranscripts:read

Consulta el progreso o lee el resultado como texto con marcas de tiempo, SRT o VTT. Indica language para leer una traducción. La primera página incluye download_url y editing_url cuando están disponibles, y las traducciones de la transcripción con su estado.

Parámetros

idstringObligatorio

ID de transcribe o list_transcripts. De 1–128 letras, números, guiones o guiones bajos.

languagestring

Traducción que leer, por su código de idioma, como ja. Si se omite, se lee la transcripción original.

formatstring

Formato de salida. Por defecto: text.

textsrtvtt
offsetinteger

Posición de frase desde 0. Por defecto: 0. Usa next_offset para continuar.

limitinteger

1–500 frases por página. Por defecto: 200.

Ejemplo de argumentos

{
  "id": "TRANSCRIPT_ID",
  "format": "text",
  "offset": 0,
  "limit": 200
}

Valores ilustrativos: sustituye la URL o el ID por los tuyos.

Usa next_offset como offset para continuar. Máximo 30.000 caracteres por página; MCP solo permite leer las primeras 2.000 frases. El texto completo está en Taption. Sin voz, devuelve total_phrases: 0.

translate_transcript

Crea un trabajotranscripts:write

Traduce una transcripción completada a un máximo de cinco idiomas. Si mencionas una transcripción por su nombre, el asistente la busca con list_transcripts y te pide elegir si no hay una coincidencia clara. Los idiomas de destino deben venir del usuario.

Parámetros

idstringObligatorio

ID de transcribe o list_transcripts. De 1–128 letras, números, guiones o guiones bajos.

target_languagesstring[]Obligatorio

1–5 códigos de idioma de traducción, como en, ja, es o zh-TW. Una transcripción no se puede traducir a su propio idioma.

overwriteboolean

true reemplaza una traducción existente, incluidos los cambios hechos en Taption. Solo después de que el usuario acepte.

Ejemplo de argumentos

{
  "id": "TRANSCRIPT_ID",
  "target_languages": [
    "ja",
    "es"
  ]
}

Valores ilustrativos: sustituye la URL o el ID por los tuyos.

Devuelve los idiomas en cola y los minutos que usa cada uno, iguales a la duración del archivo. Una traducción existente puede contener tus cambios y solo se reemplaza con overwrite, después de que aceptes. Lee el resultado con get_transcript y language.

list_transcripts

Solo lecturatranscripts:read

Lista transcripciones por modificación más reciente, con ID, nombre, estado, idioma, traducciones y fecha. Indica query para buscar una transcripción por su nombre. Usa el ID con get_transcript para leer el contenido.

Parámetros

limitinteger

1–50 transcripciones. Por defecto: 10.

querystring

Parte del nombre de una transcripción para buscar entre tus 100 más recientes, sin distinguir mayúsculas.

Ejemplo de argumentos

{
  "query": "weekly sync",
  "limit": 10
}

Valores ilustrativos: sustituye la URL o el ID por los tuyos.

Devuelve un array transcripts vacío si no hay grabaciones. Limita la cantidad de resultados, sin paginación.

Solución de problemas

Error de conexión o permisos

Reconecta con OAuth y concede los permisos. Verifica que la URL termine en /mcp-custom.

No se puede descargar el medio

Verifica que sea público, compatible y no esté en directo. En Google Drive, habilita el acceso por enlace.

Minutos insuficientes o demasiados trabajos

Comprueba tus minutos en Taption. Ante límites de frecuencia o concurrencia, espera a que terminen los trabajos y respeta el plazo indicado.

En proceso o transcripción fallida

Durante el proceso, consulta el mismo ID aproximadamente cada minuto. Si el estado es error, lee el mensaje y corrige la causa antes de crear otro trabajo.

Más formatos de exportación

Abre la transcripción en Taption para exportar TXT, PDF, SRT, VTT, Final Cut Pro XML, JSON o vídeo con subtítulos incrustados. No hay una herramienta MCP de exportación independiente.

Leer la documentación REST API