Conecta Cursor o VS Code a transcript1
En Cursor, añade la URL y tu clave de API a .cursor/mcp.json. En VS Code, usa .vscode/mcp.json. La guía de MCP incluye la instalación con un clic para ambos clientes.
Tu cliente debe admitir MCP remoto por streamable HTTP y enviar el header Authorization en los requests. Las configuraciones de Cursor y VS Code tienen estructuras distintas: copia la que corresponde a tu editor, no cambies solo el nombre del archivo.
Prueba primero get_account o list_transcriptions. Así compruebas la conexión sin crear una transcripción de pago. Si no aparecen las herramientas, revisa que el cliente haya cargado la configuración y activado el servidor. Si recibes un error de autorización, comprueba la clave en los ajustes del cliente.
{
"mcpServers": {
"transcript1": {
"url": "https://api.transcript1.com/mcp",
"headers": {
"Authorization": "Bearer t1_YOURKEY"
}
}
}
}Usa Claude Code, Claude o ChatGPT
En Claude Code, ejecuta claude mcp add con la URL del servidor y tu clave. En Claude y ChatGPT, añade un conector personalizado con esa misma URL e inicia sesión. Sigue los pasos para tu cliente.
Los conectores de Claude y ChatGPT usan OAuth. Su disponibilidad depende del plan y de los ajustes de tu espacio de trabajo. La conexión con clave de API para un editor es distinta: sigue la configuración de la aplicación que realmente vas a usar.
Cuando aparezcan las herramientas, dale al asistente un enlace público y una tarea concreta. Puedes pedir primero la transcripción de un Reel y después una lista de las instrucciones que se escuchan. transcript1 aporta las palabras del audio; el asistente no sabrá qué se ve en el video si no lo ha revisado por otro medio.
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"Pide el texto y continúa desde el mismo ID
El asistente llama a transcribe y lee la primera página cuando está lista. Si el trabajo sigue en curso, recibe un ID para consultar con get_transcription. Consulta los parámetros de las herramientas y la guía para agentes.
El texto lleva marcas de tiempo por defecto. Si hay más páginas, la respuesta incluye next_from_seconds: envíalo como from_seconds en la siguiente lectura. El asistente debe revisar los pasajes restantes antes de resumirlos y no presentar la primera página como la grabación completa.
Los enlaces completos permiten buscar una transcripción compatible de las últimas 24 horas. Los enlaces cortos no se pueden comparar al enviarlos. En cualquier caso, si ya conoces el ID, get_transcription evita crear otra transcripción. Sustituye el marcador del ejemplo por un enlace real a un video público de TikTok.
transcribe(url="[public TikTok video URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")Para archivos locales, comprueba qué puede hacer tu cliente
MCP lleva los requests y las respuestas, no los bytes de la grabación. create_upload reserva la subida y devuelve el plan de partes. El agente debe leer el archivo, enviar las partes por HTTP fuera de MCP y llamar a complete_upload. La guía de archivos explica esta separación.
Algunos asistentes pueden llamar a herramientas remotas, pero no leer archivos locales ni enviar datos binarios. En ese caso, sube la grabación en el panel y comparte con el asistente el ID cuando esté lista. Escribir una ruta en el chat no envía el archivo a transcript1.
Los webhooks solo están disponibles por REST. Para una conversación con un asistente, usa esperas acotadas y consultas con get_transcription. Si el cliente se desconecta, busca el trabajo en la lista reciente o retómalo por su ID: una llamada interrumpida no demuestra que no se haya creado.
La misma conexión sirve para trabajar con un video de Bluesky o revisar el guion hablado de un TikTok. Los videos deben ser públicos. Cualquier análisis visual necesita revisar las imágenes por separado.