Un endpoint HTTP y un servidor MCP resuelven tareas relacionadas pero distintas. El endpoint devuelve datos; el servidor MCP expone herramientas mediante un protocolo a clientes compatibles.
Empieza por el contrato HTTP
Pyntic ofrece GET /api/transcribe?url=URL_DEL_VIDEO y un parámetro lang opcional. La respuesta incluye texto y segmentos con inicio y duración en segundos. Comprueba estado HTTP y errores: no todos los vídeos públicos tienen subtítulos accesibles.
Conserva un modelo de datos estable
Guarda juntos URL, idioma conocido, texto y tiempos. No confundas segundos y milisegundos. Al importar otro servicio, normaliza las unidades antes de crear SRT, VTT o enlaces temporales.
Expón una herramienta acotada
Para integrar MCP, envuelve el endpoint en una herramienta con esquema de URL, respuesta y errores claros. Autentica clientes, limita tamaño y frecuencia y trata los subtítulos como datos externos, no como instrucciones.
Configura el cliente explícitamente
Claude Desktop, Cursor y otros clientes requieren el transporte y la configuración compatibles con su versión. Pyntic ofrece un endpoint MCP Streamable HTTP sin estado en /api/mcp. El operador debe configurar MCP_ACCESS_TOKEN y el cliente usar su cabecera Bearer. Comprueba que el cliente admita ese transporte.