MaxVideoAI MCP

npx add-mcp 'https://api.maxvideoai.com/mcp'

MaxVideoAI conecta asistentes y herramientas de automatización compatibles con los modelos, créditos y la biblioteca multimedia privada de tu cuenta de MaxVideoAI. Úsalo para comparar modelos de video actuales, preparar un presupuesto, aprobar la generación y recuperar el resultado.

Elige tu integración

Entorno	Configuración	Qué debes saber
Conector Claude	Conector MCP remoto personalizado	Probado con Claude Desktop; Claude Code tiene una ruta de host separada y no verificada.
App MCP de ChatGPT	Modo desarrollador	Las acciones de escritura MCP completas requieren un espacio de trabajo Business, Enterprise o Edu elegible. Pro solo admite lectura/obtención. No se afirma que haya un listado público en el directorio.
Plugin Codex	Plugin MaxVideoAI 0.3.3 o MCP remoto	Probado con Codex CLI.
Habilidad OpenClaw	MCP directo o habilidad listada en ClawHub	Probado con limitaciones; la importación de referencias privadas y la representación de canales en línea no están verificadas.
Flujo de trabajo de video n8n	Manual, MCP Client autoalojado	Probado en 2.38.7 con aprobación explícita. No se afirma soporte de plantillas públicas ni de n8n Cloud.

Cursor, GitHub Copilot, Gemini CLI y Microsoft Copilot están en preparación. Sus páginas de configuración de MaxVideoAI no están publicadas.

Dirección del servidor MCP

https://api.maxvideoai.com/mcp

Usa Streamable HTTP con OAuth 2.1. Los alcances solicitados son openid,email,profile. No agregues un token, contraseña, parámetro de consulta o clave de API. Sigue la guía para tu cliente: abre la pantalla de inicio de sesión y consentimiento OAuth de MaxVideoAI en tu navegador.

Autoriza tu cuenta

1. Configura la conexión usando la guía anterior.
2. Inicia sesión en MaxVideoAI o crea una cuenta, y confirma tu correo electrónico si se solicita.
3. Revisa la autorización, luego regresa al cliente y verifica la cuenta conectada.
4. Revisa y aprueba el presupuesto exacto antes de cualquier generación de pago.

Conectarse es gratuito y la planificación no agrega ninguna suscripción de MaxVideoAI. Las generaciones de pago usan el mismo saldo de créditos de MaxVideoAI que el sitio web; tu proveedor de asistente puede tener sus propios requisitos de plan. Para desconectar, elimina la integración del cliente y revoca su autorización en MaxVideoAI.

La compatibilidad se registra por host. Claude Desktop y Codex CLI tienen puntos de control verificados; ChatGPT web y Claude Code no tienen un punto de control de extremo a extremo registrado. OpenClaw y el n8n MCP Client autoalojado conservan su estado de probados con limitaciones. Consulta las guías de integración para fechas y restricciones.

Qué debe hacer el asistente

El asistente sigue siendo responsable de la conversación creativa: brief, guion, plan de tomas, redacción de prompts e ideas de referencia. Debe usar MaxVideoAI cuando necesite hechos cambiantes o una acción de cuenta:

• llamar a list_models y get_model_details en lugar de depender de la memoria del modelo;
• preguntar solo por opciones que afecten materialmente la calidad, el presupuesto, la duración, el audio o las referencias;
• respetar un modelo compatible elegido por el usuario;
• cuando el usuario esté indeciso, presentar primero la mejor opción ejecutable y alternativas de menor costo creíbles;
• usar calculate_project_budget para cotizar propuestas completas de películas comparables con los mismos supuestos de reintento;
• usar prepare_generation solo cuando la solicitud final esté lista;
• esperar la aprobación explícita del presupuesto exacto devuelto antes de confirm_generation.

La calidad no es un único ajuste preestablecido. Para trabajos de múltiples tomas, el asistente puede comparar un plan priorizando la calidad con una o más alternativas de modelos mixtos, explicando el modelo seleccionado para cada toma. Los intentos creativos son escenarios facturables y deben mostrarse por separado en el presupuesto.

Herramientas

Herramienta	Propósito	¿Escribe o gasta?
get_account_status	Leer conexión, saldo de créditos, estado de prueba, límites y destinos de cuenta seguros.	No.
list_models	Encontrar modelos actuales de imagen y video ejecutables por modo y requisitos.	No.
get_model_details	Leer configuraciones exactas, roles de referencia, límites, evidencia y entradas de precios actuales para un modelo.	No.
recommend_models	Hacer coincidir el brief con una lista corta de opciones de modelos factuales y compensaciones.	No.
calculate_project_budget	Comparar de una a cuatro propuestas de proyectos completos a precios actuales.	No. Una estimación no es un presupuesto.
list_media	Listar los activos privados de imagen, video o audio listos del usuario conectado.	No.
create_reference_upload_link	Crear una transferencia de carga de navegador MaxVideoAI privada de corta duración.	Crea una transferencia, nunca un trabajo de proveedor.
import_reference_files	Importar hasta ocho archivos adjuntos del host autorizados por el usuario o resultados de archivos generados a la biblioteca privada.	Almacena activos privados; nunca inicia una generación.
prepare_generation	Validar modelo, configuraciones, referencias, propiedad y saldo; devolver un presupuesto exacto de corta duración.	Sin cargo y sin generación.
confirm_generation	Aprobar un presupuesto exacto y enviar su trabajo de forma idempotente.	Sí, solo después de la aprobación explícita.
get_generation_status	Leer un trabajo conocido, finalización, salida, fallo y estado de reembolso.	No.
list_recent_generations	Recuperar trabajos recientes en lugar de enviar duplicados accidentalmente.	No.
present_generation	Presentar una imagen propiedad completada o un video reproducible en línea en hosts compatibles.	No. Usa el enlace de resultado y la biblioteca como respaldo.
create_topup_link	Abrir una transferencia segura de recarga de créditos MaxVideoAI por el monto faltante.	El pago ocurre solo en MaxVideoAI.

Las banderas de publicación de producción deciden qué herramientas con capacidad de escritura se exponen. Un cliente no debe inferir disponibilidad solo de esta referencia; su respuesta en vivo de tools/list es autoritativa.

Referencias de imágenes, video y audio

El asistente puede ayudar a inventar, crear o seleccionar medios de referencia. MaxVideoAI acepta y almacena los medios, pero no requiere que el asistente renuncie a su rol creativo.

Usa list_media para un activo ya en la biblioteca MaxVideoAI conectada. Cuando ChatGPT u otro host compatible exponga archivos adjuntos autorizados por el usuario o un resultado de archivo generado, import_reference_files importa hasta ocho archivos y devuelve valores privados de assetId listos para la solicitud; no se necesita un nuevo listado de biblioteca.

Si el host no expone manejadores de archivos, llama a create_reference_upload_link con image, video o audio. Una superficie compatible de ChatGPT o Claude puede mostrar su importador de múltiples archivos en el chat. La página HTTPS del navegador devuelta sigue siendo el respaldo manual. Codex y Claude Code pueden usar un enlace por archivo local con el asistente empaquetado. Ninguna ruta envía un nombre de archivo local sin procesar al servidor MCP, publica una URL pública o requiere Computer Use.

Siempre llama a get_model_details para el modo seleccionado. Devuelve los tipos de medios aceptados, roles, orden, conteos, formatos, tamaños y límites de duración. No copies reglas de referencia de un modelo diferente. Las URLs de origen privadas y los valores estables de assetId permanecen dentro del límite de la cuenta.

Seedance 2.5 está disponible a través de su ruta ModelArk funcional para texto a video, imagen a video, referencia a video y extensión. El video a video directo que depende de BytePlus LAS no se expone hasta que exista acceso LAS; esa limitación no desactiva los modos Seedance 2.5 compatibles.

Presupuesto, precio exacto y aprobación

calculate_project_budget es gratuito y útil temprano. Estima una película a partir de propuestas nombradas, duraciones de tomas, elecciones de modelos y supuestos explícitos de intentos creativos. No reserva capacidad, debita créditos ni crea un trabajo.

Cuando el usuario elige una solicitud concreta, prepare_generation realiza la validación final y devuelve el precio exacto de la cuenta con una expiración. Muestra ese precio y espera una aprobación inequívoca. Solo entonces llama a confirm_generation una vez con el identificador del presupuesto.

Si los créditos son insuficientes:

1. llama a create_topup_link para ese presupuesto;
2. envía al usuario a la página de facturación de MaxVideoAI devuelta;
3. después de que el usuario diga que el pago está completo, llama a get_account_status nuevamente;
4. llama a prepare_generation nuevamente porque el presupuesto anterior ya no es válido;
5. muestra el precio exacto fresco y solicita aprobación nuevamente.

El plugin en sí, el asesoramiento de modelos y los presupuestos de proyectos no requieren una suscripción separada. Las generaciones de pago usan el saldo de créditos MaxVideoAI de pago por uso existente.

Trabajos, biblioteca, fallos y reintentos

Un trabajo aceptado aún no es un video completado. Consulta get_generation_status para un trabajo conocido o llama a list_recent_generations para recuperarlo. Una vez completado, present_generation puede representar la imagen o el video reproducible en línea en un host compatible con MCP Apps. Otros clientes mantienen el enlace de resultado devuelto y el destino de la biblioteca MaxVideoAI como respaldo universal. No envíes la misma generación de pago nuevamente solo porque la primera llamada expiró.

Las imágenes y videos exitosos se guardan en la misma biblioteca de cuenta MaxVideoAI privada utilizada por el sitio web. Devuelve solo el resultado oficial, espacio de trabajo o destino de biblioteca proporcionado por MaxVideoAI.

Para un fallo técnico definitivo, explica el fallo devuelto y el estado de reembolso. No reintentes automáticamente. Un reintento creativo es un nuevo intento de pago y necesita un nuevo presupuesto y una nueva aprobación explícita.

Crédito introductorio

Una cuenta verificada elegible puede recibir una generación introductoria de Seedance 2 Mini cuando la promoción está activa. Este es un derecho promocional único, no dinero de billetera reutilizable. Su disponibilidad es devuelta por get_account_status; nunca lo prometas antes de verificar la cuenta conectada. El audio puede permanecer habilitado sin cambiar el precio promocional cuando el preset en vivo lo indique.

Desconectar y revocar

1. Elimina MaxVideoAI del cliente.
2. Abre Conexiones de cuenta MaxVideoAI.
3. Revoca la concesión relevante.
4. Confirma que la próxima llamada protegida requiere una nueva aprobación del navegador.

Privacidad y seguridad

• El correo electrónico de la cuenta se omite de los resultados de las herramientas.
• Prompts, tokens, secretos, URLs de referencia completas, medios privados y detalles de pago se excluyen de las analíticas de adquisición.
• Las respuestas autenticadas usan Cache-Control: private, no-store.
• Los presupuestos expiran, el envío de pago es idempotente y los límites de cuenta del lado del servidor aún se aplican.
• El asistente no puede afirmar que el contenido generado está automáticamente autorizado para publicación o uso comercial.

Solución de problemas

El navegador regresa a 127.0.0.1 y no puede conectarse

El listener de devolución de llamada temporal del cliente de escritorio ya no se está ejecutando o usó un puerto diferente. Mantén el cliente abierto, reinicia la conexión desde ese cliente y luego aprueba la nueva solicitud. No reutilices una URL de autorización anterior.

Se solicita autenticación nuevamente

La concesión OAuth puede haber expirado o sido revocada. Reconecta y completa una nueva aprobación del navegador. Nunca pegues un token de portador en la dirección MCP.

HTTP 401 / JSON-RPC -32001

La solicitud no tiene una concesión de portador válida. Deja que el cliente siga el desafío WWW-Authenticate y su URL de descubrimiento resource_metadata.

INTERNAL_ERROR

Conserva el correlationId devuelto, detén los envíos repetidos y contacta al soporte de MaxVideoAI si el fallo persiste.

Falta un modo

Solicita get_model_details nuevamente. Un modelo puede admitir varios modos a través de diferentes rutas de proveedor; una ruta no disponible no debe interpretarse como que todo el modelo está deshabilitado.

Límites actuales

Esto no es una API REST de propósito general y no emite claves de API para clientes. No controla la línea de tiempo de Studio, edita video fuente arbitrario, gestiona endpoints de devolución de llamada del cliente, recopila detalles de pago dentro del chat, expone modelos ocultos ni aprueba automáticamente medios para publicación.

Resumen de documentación · Verificaciones de seguridad de contenido · Primeros pasos con MaxVideo AI