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 user

Ejecuta /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

HerramientaQué hace
upscale_videoInicia el escalado de una video_url pública a 1080p, 2k o 4k y cobra créditos. Requiere una idempotency_key.
get_taskDevuelve una tarea. Con wait_seconds (hasta 45) espera primero a que la tarea termine.
list_tasksLista tus tareas recientes, incluidas las iniciadas en el sitio web.
get_accountTu saldo de créditos y el precio por segundo de cada resolución.
create_uploadDevuelve 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.mp4 a 2K." (los clientes que pueden ejecutar comandos suben primero el archivo con create_upload)

Solución de problemas

ProblemaSolución
El cliente muestra 401 o te pide iniciar sesiónVuelve 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álidoEl enlace caduca a los 10 minutos. Vuelve a iniciar la conexión desde tu cliente.
Las herramientas devuelven paid_plan_requiredLa cuenta nunca ha comprado créditos. Compra cualquier paquete de créditos.
Las herramientas devuelven insufficient_creditsRecarga tu saldo en la página de precios.
upscale_video agota el tiempo de esperaLos vídeos remotos grandes tardan en descargarse. Pide al asistente que revise list_tasks; normalmente la tarea ya existe.