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)
Solo cuentas de pago
Al igual que la API, el servidor MCP está disponible para las cuentas que han comprado créditos o se han suscrito. Necesitas una clave de API.
Conectar un cliente
Crea una clave de API 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.
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
--header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
--scope user--scope user hace que el servidor esté disponible en todos tus proyectos y mantiene la clave fuera del .mcp.json del proyecto. Ejecuta /mcp en Claude Code para comprobar la conexión.
Añade esto a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un solo proyecto):
{
"mcpServers": {
"videoupscaler": {
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
}
}
}
}Añade esto a .vscode/mcp.json. VS Code te pide la clave la primera vez y la guarda de forma segura:
{
"inputs": [
{
"type": "promptString",
"id": "videoupscaler-key",
"description": "VideoUpscaler API key",
"password": true
}
],
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${input:videoupscaler-key}"
}
}
}
}Funciona cualquier cliente que admita servidores MCP remotos mediante Streamable HTTP. Configura:
- URL:
https://videoupscaler.co/api/mcp - Cabecera:
Authorization: Bearer <your API key>
El inicio de sesión con OAuth (para Claude desktop y los conectores de claude.ai) llegará pronto.
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 | Falta la clave de API o es incorrecta. Revisa la cabecera Authorization y que la clave siga existiendo en Configuración. |
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. |