ViewMax MCP

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

Procurando uma visão geral do que o servidor pode fazer? Comece pela página principal do ViewMax MCP — este guia cobre configuração e detalhes em profundidade.

Endpoint e autenticação

O ViewMax expõe um servidor MCP HTTP Streamable remoto:

https://viewmax.studio/api/mcp

Dois métodos de autenticação são suportados. O nome do servidor é viewmax.

OAuth (claude.ai e Claude Desktop). Adicione um conector personalizado chamado ViewMax com a URL acima, clique em Conectar e faça login com sua conta ViewMax. Os clientes descobrem o fluxo automaticamente por meio de /.well-known/oauth-protected-resource; nenhuma chave de API é necessária.

Chave de API (Claude Code, Cursor, Codex, SDKs). Configure um cliente MCP que suporte cabeçalhos HTTP para enviar:

Authorization: Bearer sk-your-api-key

Uma solicitação sem um token OAuth válido ou chave de API é não autorizada.

Ferramentas

O servidor MCP ViewMax gera vídeo, imagem, música e áudio. Imagens principais nos planos Pro/Ultra (GPT Image 2, Nano Banana 2, Grok Imagine) e ViewMax C1 no Ultra podem usar o pool compartilhado diário de uso justo — cost_credits é 0 quando um slot é usado. Outras gerações consomem créditos. Um agente deve inspecionar um modelo e informar ao usuário sobre o custo antes de chamar uma ferramenta generate_*.

Ferramentas compartilhadas

Ferramenta	Entrada	Resultado
get_task	task_id	status atual, media_type e, quando disponível, output_urls (para vídeo também video_urls)
wait_for_task	task_id, opcional timeout_seconds	Consulta e retorna a tarefa mais recente; padrão 45 segundos, mínimo 1, máximo 50
get_credits	nenhum	remaining_credits para a conta autenticada

Vídeo

Ferramenta	Entrada	Resultado
list_video_models	nenhum	IDs de modelos de vídeo, rótulos, fornecedores, modos, durações, resoluções, rótulos de crédito
get_video_model	model	Dados completos de capacidade e preços para um modelo de vídeo
generate_video	model, prompt, opcional mode, image_urls, video_urls, duration, resolution, aspect_ratio, audio, source_video_duration_seconds	Cria uma tarefa; retorna task_id, status, cost_credits, dica de consulta

Imagem

Ferramenta	Entrada	Resultado
list_image_models	nenhum	IDs de modelos de imagem, modos, proporções, qualidades, rótulos de crédito
get_image_model	model	Dados completos de capacidade e preços para um modelo de imagem
generate_image	model, prompt, opcional scene, image_urls, aspect_ratio, quality	Cria uma tarefa; consulte get_task para output_urls

Música

Ferramenta	Entrada	Resultado
list_music_models	nenhum	Modelos de música, controles e custo em créditos
generate_music	prompt, opcional duration_seconds, instrumental, style, lyrics	Renderiza de forma síncrona; geralmente retorna output_urls imediatamente

Áudio

Ferramenta	Entrada	Resultado
list_voices	nenhum	Vozes de texto para fala (id, name, gender, accent, language) e custo em créditos
generate_speech	text, voice_id, opcional model_id, speed, stability, similarity_boost	Renderiza de forma síncrona; geralmente retorna output_urls imediatamente
generate_sound_effect	prompt, opcional duration_seconds, prompt_influence	Renderiza de forma síncrona; geralmente retorna output_urls imediatamente

As mesmas regras de validação de modelo e créditos da API v1 se aplicam.

Fluxo de trabalho típico

1. Chame a ferramenta list_* correspondente (por exemplo, list_video_models ou list_voices) e depois get_*_model para o modelo selecionado.
2. Confirme que a geração consumirá os créditos exibidos.
3. Chame a ferramenta generate_* correspondente.
4. Chame wait_for_task ou chame get_task a cada 5 segundos até que o status seja success, failed ou canceled. Música e áudio geralmente são concluídos imediatamente.
5. Em caso de sucesso, retorne output_urls ao usuário.

Erros e recuperação

Falhas de ferramentas usam resultados de erro MCP com uma mensagem de texto acionável. Erros de créditos insuficientes incluem a URL de preços do ViewMax. Para um modelo ou opção inválida, chame get_video_model novamente e corrija a entrada em vez de tentar novamente a ferramenta cobrável às cegas.