Servidor MCP para generar vídeos con IA

¿Qué es el servidor MCP de vídeo de VidFlux?

El Model Context Protocol (MCP) es el estándar abierto que usan los asistentes de IA para llamar a herramientas externas. VidFlux MCP es un endpoint alojado que da a tu asistente herramientas de vídeo: iniciar una generación de texto a vídeo, imagen a vídeo o control de movimiento, consultar el progreso y obtener el MP4 terminado. El asistente escribe el prompt, elige el modelo, la duración y el formato, espera al render y te entrega el archivo sin salir del chat ni del editor.

Detrás del endpoint funciona el mismo sistema que el generador de vídeo de vidflux.ai, así que las versiones de los modelos, los precios y los reembolsos son idénticos, y cada tarea aparece también en el historial de tu cuenta.

Modelos de vídeo con IA compatibles

Indica el ID del modelo en el argumento model. Los créditos corresponden a la configuración predeterminada; los vídeos más largos, con más resolución o con audio cuestan más. dry_run devuelve el precio exacto para cualquier configuración.

Modelos de imagen para fotogramas clave y miniaturas

Crea o edita fotogramas iniciales, fotos de producto y miniaturas, y luego anímalos con cualquiera de los modelos de imagen a vídeo anteriores.

Inicio rápido: conéctate en 3 pasos

1. Inicia sesión en VidFlux y crea una clave en Ajustes → API & MCP. Las cuentas nuevas reciben créditos de prueba gratis.
2. Añade el servidor a tu cliente de IA con una de las configuraciones de abajo.
3. Pide un vídeo, por ejemplo: «Haz con Seedance 2 un vídeo de 5 segundos en 9:16 de latte art vertiéndose a cámara lenta y guárdalo en ./assets».

Configuración de los clientes MCP

Sustituye vf_your_api_key por tu clave. En los clientes que leen variables de entorno, guarda la clave en VIDFLUX_API_KEY en lugar de en el archivo de configuración.

Claude Code

claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \
  --header "Authorization: Bearer vf_your_api_key"

# verify
claude mcp list

Claude Desktop

Claude Desktop se conecta a servidores remotos con clave API mediante mcp-remote (requiere Node.js). Edita claude_desktop_config.json y reinicia Claude:

{
  "mcpServers": {
    "vidflux": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vidflux.ai/api/mcp",
        "--header", "Authorization: Bearer vf_your_api_key"
      ]
    }
  }
}

Cursor

Añádelo a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "vidflux": {
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

OpenAI Codex CLI

export VIDFLUX_API_KEY=vf_your_api_key
codex mcp add vidflux --url https://vidflux.ai/api/mcp \
  --bearer-token-env-var VIDFLUX_API_KEY

VS Code (GitHub Copilot agent mode)

Añádelo a .vscode/mcp.json:

{
  "servers": {
    "vidflux": {
      "type": "http",
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Windsurf

Añádelo a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vidflux": {
      "serverUrl": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Cline, Roo Code y otros clientes

Cualquier cliente compatible con servidores Streamable HTTP y cabeceras personalizadas funciona con la misma URL y cabecera. Los clientes que solo admiten stdio pueden usar el comando mcp-remote de la configuración de Claude Desktop.

Herramientas MCP

La generación de vídeo es asíncrona. Un flujo típico del agente es este:

list_models            → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
                duration: 5, dry_run: true}
                       → {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
                       → {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."}   (every 15 s)
                       → {"status": "completed", "video_url": "https://...mp4"}

Precios: créditos de pago por uso

• Conectar el servidor y llamar a list_models, get_task o get_credits es gratis.
• Cada vídeo cuesta los mismos créditos que en vidflux.ai (consulta las tablas). Los paquetes empiezan en 500 créditos por 4,98 US$, los paquetes grandes salen más baratos por crédito y los créditos comprados no caducan.
• dry_run: true valida los argumentos y devuelve el precio exacto y si tu saldo alcanza, sin generar nada.
• Las tareas fallidas o rechazadas se reembolsan automáticamente.

Ver paquetes de créditos y planes

Qué puedes hacer con él

VidFlux MCP frente a las API de cada proveedor y los MCP autoalojados

Solución de problemas

El servidor aparece conectado pero no salen las herramientas de vídeo

Reinicia el cliente o recarga los servidores MCP y comprueba que el modo Agent está activo (Cursor, VS Code). En Claude Code, /mcp muestra la lista de herramientas.

401 Unauthorized o «Missing or invalid API key»

La cabecera debe ser exactamente Authorization: Bearer vf_…. Comprueba que la clave no se ha revocado y que no se copiaron comillas o espacios de más.

402 INSUFFICIENT_CREDITS

Tu saldo es menor que el precio devuelto por dry_run. Recarga créditos o elige un vídeo más corto, menos resolución o un modelo más barato.

Un vídeo se queda mucho tiempo en processing

La mayoría de los vídeos tardan de 1 a 5 minutos; los vídeos largos de Seedance 2.5 o en 4K con Gemini Omni pueden tardar más. Sigue consultando get_task. Si la tarea falla, se devuelve el error y se reembolsan los créditos.

spawn npx ENOENT en Claude Desktop

mcp-remote necesita Node.js 18 o superior. Instala Node.js o pon la ruta completa de npx en el campo command.

Se rechazan las imágenes de referencia

image_urls debe contener enlaces HTTPS públicos a archivos JPG, PNG o WebP. Las rutas locales y los enlaces que requieren inicio de sesión no se pueden leer.

Preguntas frecuentes