Servidor MCP para escalar vídeos
Conecta el servidor MCP de VideoUpscaler a Claude Code, Cursor o VS Code y escala vídeos a 1080p, 2K o 4K pidiéndoselo a tu asistente de IA.
VideoUpscaler ofrece un servidor MCP remoto para escalar vídeos, basado en el Model Context Protocol. Conéctalo a tu asistente de IA y pídele cosas como "escala este vídeo a 4K": el asistente llama a la misma API que se describe en esta documentación y usa tus créditos.
URL del servidor: https://videoupscaler.co/api/mcp (Streamable HTTP)
Para cuentas de pago (el saldo, para todas)
Al igual que la API, el servidor MCP está disponible para las cuentas que han comprado créditos o se han suscrito. Los clientes se conectan iniciando sesión en tu cuenta de VideoUpscaler o con una clave de API. Cualquier cuenta puede iniciar sesión y consultar su saldo con get_account; las demás herramientas requieren una cuenta de pago.
Conectar un cliente
La mayoría de los clientes se conectan iniciando sesión: añades la URL del servidor, se abre una ventana del navegador, inicias sesión en VideoUpscaler y haces clic en Permitir. Los clientes que no pueden iniciar sesión usan una clave de API: créala en Configuración → Claves de API y guárdala en una variable de entorno como VIDEOUPSCALER_API_KEY. No pegues la clave en un archivo de configuración que subas al repositorio.
En claude.ai o en la app de escritorio de Claude, abre Settings → Connectors, haz clic en Add custom connector e introduce https://videoupscaler.co/api/mcp. Haz clic en Connect, inicia sesión y permite el acceso.
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope userEjecuta /mcp en Claude Code, selecciona videoupscaler y elige Authenticate para iniciar sesión en el navegador. --scope user hace que el servidor esté disponible en todos tus proyectos.
Para usar una clave de API, añade --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" al comando.
Cursor se conecta con una clave de API. Añade a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):
{
"mcpServers": {
"videoupscaler": {
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
}
}
}
}Añade a .vscode/mcp.json. VS Code te pide iniciar sesión la primera vez que se inicia el servidor:
{
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp"
}
}
}Funciona cualquier cliente compatible con servidores MCP remotos por Streamable HTTP. Introduce la URL https://videoupscaler.co/api/mcp: los clientes compatibles con la autorización de MCP te piden iniciar sesión automáticamente. Los demás envían la cabecera Authorization: Bearer <tu clave de API>.
Herramientas
| Herramienta | Qué hace |
|---|---|
upscale_video | Inicia el escalado de una video_url pública a 1080p, 2k o 4k y cobra créditos. Requiere una idempotency_key. |
get_task | Devuelve una tarea. Con wait_seconds (hasta 45) espera primero a que la tarea termine. |
list_tasks | Lista tus tareas recientes, incluidas las iniciadas en el sitio web. |
get_account | Tu saldo de créditos y el precio por segundo de cada resolución. |
create_upload | Devuelve una URL firmada para subir un archivo local (hasta 100MB) que no tiene URL pública. |
Las herramientas se comportan exactamente igual que los endpoints de la API correspondientes: consulta Crear un escalado, Tareas, Créditos y precios y Subir un archivo. Las tareas iniciadas mediante MCP cuestan los mismos créditos.
Cada llamada a upscale_video necesita una idempotency_key. Si una llamada agota el tiempo de espera, el asistente debe revisar list_tasks y reintentar con la misma clave, para que el vídeo nunca se cobre dos veces.
Ejemplos de peticiones
- "¿Cuántos créditos de VideoUpscaler me quedan?"
- "Escala https://example.com/clip.mp4 a 4K y dame el enlace cuando termine."
- "Escala
./intro.mp4a 2K." (los clientes que pueden ejecutar comandos suben primero el archivo concreate_upload)
Solución de problemas
| Problema | Solución |
|---|---|
El cliente muestra 401 o te pide iniciar sesión | Vuelve a iniciar sesión desde el cliente. Si usas una clave de API, revisa la cabecera Authorization y que la clave siga existiendo en Configuración. |
| La página de inicio de sesión dice que el enlace de autorización no es válido | El enlace caduca a los 10 minutos. Vuelve a iniciar la conexión desde tu cliente. |
Las herramientas devuelven paid_plan_required | La cuenta nunca ha comprado créditos. Compra cualquier paquete de créditos. |
Las herramientas devuelven insufficient_credits | Recarga tu saldo en la página de precios. |
upscale_video agota el tiempo de espera | Los vídeos remotos grandes tardan en descargarse. Pide al asistente que revise list_tasks; normalmente la tarea ya existe. |
Errores y límites
Formato de los errores, códigos de estado, límites de uso y recomendaciones de reintento para la API de VideoUpscaler.
Integraciones de flujos de trabajo (n8n, Zapier y Make)
Automatiza el escalado de vídeo con IA en n8n, Zapier, Make, Dify y Coze usando la API de VideoUpscaler, webhooks, plantillas y el nodo comunitario.