ViewMax MCP

npx add-mcp 'https://viewmax.studio/api/mcp'

¿Buscas una visión general de lo que puede hacer el servidor? Comienza desde la página principal de ViewMax MCP: esta guía cubre la configuración y el ajuste en detalle.

Endpoint y autenticación

ViewMax expone un servidor MCP HTTP Streamable remoto:

https://viewmax.studio/api/mcp

Se admiten dos métodos de autenticación. El nombre del servidor es viewmax.

OAuth (claude.ai y Claude Desktop). Agrega un conector personalizado llamado ViewMax con la URL anterior, haz clic en Conectar e inicia sesión con tu cuenta de ViewMax. Los clientes descubren el flujo automáticamente a través de /.well-known/oauth-protected-resource; no se necesita clave API.

Clave API (Claude Code, Cursor, Codex, SDKs). Configura un cliente MCP que admita encabezados HTTP para enviar:

Authorization: Bearer sk-your-api-key

Una solicitud sin un token OAuth válido o clave API no está autorizada.

Herramientas

El servidor MCP de ViewMax genera video, imagen, música y audio. Las imágenes insignia en Pro/Ultra (GPT Image 2, Nano Banana 2, Grok Imagine) y ViewMax C1 en Ultra pueden usar el grupo compartido de uso justo diario: cost_credits es 0 cuando se usa una ranura. Otras generaciones consumen créditos. Un agente debe inspeccionar un modelo e informar al usuario sobre el costo antes de llamar a una herramienta generate_*.

Herramientas compartidas

Herramienta	Entrada	Resultado
get_task	task_id	status actual, media_type y, cuando esté disponible, output_urls (para video también video_urls)
wait_for_task	task_id, timeout_seconds opcional	Sondea y devuelve la tarea más reciente; 45 segundos por defecto, mínimo 1, máximo 50
get_credits	ninguna	remaining_credits para la cuenta autenticada

Video

Herramienta	Entrada	Resultado
list_video_models	ninguna	IDs de modelos de video, etiquetas, proveedores, modos, duraciones, resoluciones, etiquetas de crédito
get_video_model	model	Datos completos de capacidad y precios para un modelo de video
generate_video	model, prompt, mode opcional, image_urls, video_urls, duration, resolution, aspect_ratio, audio, source_video_duration_seconds	Crea una tarea; devuelve task_id, status, cost_credits, sugerencia de sondeo

Imagen

Herramienta	Entrada	Resultado
list_image_models	ninguna	IDs de modelos de imagen, modos, relaciones de aspecto, calidades, etiquetas de crédito
get_image_model	model	Datos completos de capacidad y precios para un modelo de imagen
generate_image	model, prompt, scene opcional, image_urls, aspect_ratio, quality	Crea una tarea; sondea get_task para output_urls

Música

Herramienta	Entrada	Resultado
list_music_models	ninguna	Modelos de música, controles y costo de crédito
generate_music	prompt, duration_seconds opcional, instrumental, style, lyrics	Se renderiza de forma síncrona; normalmente devuelve output_urls inmediatamente

Audio

Herramienta	Entrada	Resultado
list_voices	ninguna	Voces de texto a voz (id, name, gender, accent, language) y costo de crédito
generate_speech	text, voice_id, model_id opcional, speed, stability, similarity_boost	Se renderiza de forma síncrona; normalmente devuelve output_urls inmediatamente
generate_sound_effect	prompt, duration_seconds opcional, prompt_influence	Se renderiza de forma síncrona; normalmente devuelve output_urls inmediatamente

Se aplican las mismas reglas de validación de modelos y créditos que en la API v1.

Flujo de trabajo típico

1. Llama a la herramienta list_* correspondiente (por ejemplo, list_video_models o list_voices), luego a get_*_model para el modelo seleccionado.
2. Confirma que la generación consumirá los créditos mostrados.
3. Llama a la herramienta generate_* correspondiente.
4. Llama a wait_for_task, o llama a get_task cada 5 segundos hasta que el estado sea success, failed o canceled. La música y el audio suelen completarse de inmediato.
5. En caso de éxito, devuelve output_urls al usuario.

Errores y recuperación

Los fallos de herramientas usan resultados de error MCP con un mensaje de texto accionable. Los errores de créditos insuficientes incluyen la URL de precios de ViewMax. Para un modelo u opción no válidos, llama a get_video_model nuevamente y corrige la entrada en lugar de reintentar la herramienta facturable a ciegas.