MaxVideoAI MCP

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

MaxVideoAI conecta assistentes e ferramentas de automação compatíveis aos modelos, créditos e à biblioteca de mídia privada da sua conta MaxVideoAI. Use-o para comparar modelos de vídeo atuais, preparar um orçamento, aprovar a geração e recuperar o resultado.

Escolha sua integração

Ambiente	Configuração	O que saber
Conector Claude	Conector MCP remoto personalizado	Claude Desktop testado; Claude Code tem um caminho de host separado e não verificado.
App MCP ChatGPT	Modo desenvolvedor	Ações completas de escrita MCP exigem um workspace Business, Enterprise ou Edu elegível. Pro suporta apenas leitura/busca. Nenhuma listagem pública de diretório é reivindicada.
Plugin Codex	Plugin MaxVideoAI 0.3.3 ou MCP remoto	Codex CLI testado.
Skill OpenClaw	MCP direto ou skill listada no ClawHub	Testado com limites; importação de referência privada e renderização de canal inline não verificadas.
Workflow de vídeo n8n	Cliente MCP manual e auto-hospedado	Testado na versão 2.38.7 com aprovação explícita. Nenhuma listagem pública de template ou suporte a n8n Cloud é reivindicado.

Cursor, GitHub Copilot, Gemini CLI e Microsoft Copilot estão em preparação. Suas páginas de configuração MaxVideoAI não foram publicadas.

Endereço do servidor MCP

https://api.maxvideoai.com/mcp

Use Streamable HTTP com OAuth 2.1. Os escopos solicitados são openid,email,profile. Não anexe token, senha, parâmetro de consulta ou chave de API. Siga o guia do seu cliente: ele abre a tela de login e consentimento OAuth da MaxVideoAI no seu navegador.

Autorize sua conta

1. Configure a conexão usando o guia acima.
2. Entre na MaxVideoAI ou crie uma conta e confirme seu e-mail se solicitado.
3. Revise a autorização, depois retorne ao cliente e verifique a conta conectada.
4. Revise e aprove o orçamento exato antes de qualquer geração paga.

Conectar é gratuito e o planejamento não adiciona assinatura MaxVideoAI. Gerações pagas usam o mesmo saldo de créditos MaxVideoAI do site; seu provedor de assistente pode ter seus próprios requisitos de plano. Remova a integração do cliente e revogue sua autorização na MaxVideoAI para desconectar.

A compatibilidade é registrada por host. Claude Desktop e Codex CLI têm checkpoints verificados; ChatGPT web e Claude Code não têm checkpoint de ponta a ponta registrado. OpenClaw e o cliente MCP n8n auto-hospedado mantêm seu status de testado com limites. Consulte os guias de integração para datas e restrições.

O que o assistente deve fazer

O assistente permanece responsável pela conversa criativa: briefing, roteiro, plano de cenas, escrita de prompts e ideias de referência. Ele deve usar MaxVideoAI quando precisar de fatos atualizados ou uma ação na conta:

• chamar list_models e get_model_details em vez de depender da memória do modelo;
• pedir apenas escolhas que afetem materialmente qualidade, orçamento, duração, áudio ou referências;
• respeitar um modelo compatível escolhido pelo usuário;
• quando o usuário estiver indeciso, apresentar primeiro a melhor opção executável e alternativas de menor custo confiáveis;
• usar calculate_project_budget para precificar propostas completas de filme comparáveis com as mesmas premissas de nova tentativa;
• usar prepare_generation somente quando a solicitação final estiver pronta;
• aguardar aprovação explícita do orçamento exato retornado antes de confirm_generation.

Qualidade não é um único preset. Para trabalhos com múltiplas cenas, o assistente pode comparar um plano focado em qualidade com uma ou mais alternativas de modelos mistos, explicando o modelo selecionado para cada cena. Tentativas criativas são cenários cobráveis e devem ser mostradas separadamente no orçamento.

Ferramentas

Ferramenta	Finalidade	Escreve ou gasta?
get_account_status	Ler conexão, saldo de créditos, estado de teste, limites e destinos seguros da conta.	Não.
list_models	Encontrar modelos atuais executáveis de imagem e vídeo por modo e requisitos.	Não.
get_model_details	Ler configurações exatas, papéis de referência, limites, evidências e entradas de preço atuais para um modelo.	Não.
recommend_models	Corresponder o briefing a uma lista curta de opções factuais de modelos e trade-offs.	Não.
calculate_project_budget	Comparar de uma a quatro propostas completas de projeto a preços atuais.	Não. Uma estimativa não é um orçamento.
list_media	Listar ativos privados prontos de imagem, vídeo ou áudio do usuário conectado.	Não.
create_reference_upload_link	Criar um handoff privado de upload de navegador MaxVideoAI de curta duração.	Cria um handoff, nunca um job do provedor.
import_reference_files	Importar até oito anexos autorizados pelo usuário do host ou resultados de arquivos gerados para a biblioteca privada.	Armazena ativos privados; nunca inicia uma geração.
prepare_generation	Validar modelo, configurações, referências, propriedade e saldo; retornar um orçamento exato de curta duração.	Sem cobrança e sem geração.
confirm_generation	Aprovar um orçamento exato e enviar seu job de forma idempotente.	Sim, somente após aprovação explícita.
get_generation_status	Ler um job conhecido, conclusão, saída, falha e estado de reembolso.	Não.
list_recent_generations	Recuperar jobs recentes em vez de enviar duplicatas acidentalmente.	Não.
present_generation	Apresentar uma imagem concluída de propriedade do usuário ou vídeo reproduzível inline em hosts compatíveis.	Não. Usa o link do resultado e a biblioteca como fallback.
create_topup_link	Abrir um handoff seguro de recarga de créditos MaxVideoAI para o valor faltante.	O pagamento ocorre somente na MaxVideoAI.

As flags de publicação de produção decidem quais ferramentas com capacidade de escrita são expostas. Um cliente não deve inferir disponibilidade apenas desta referência; sua resposta ao vivo de tools/list é a autoridade.

Referências de imagens, vídeo e áudio

O assistente pode ajudar a inventar, criar ou selecionar mídia de referência. A MaxVideoAI aceita e armazena a mídia, mas não exige que o assistente abra mão de seu papel criativo.

Use list_media para um ativo já na biblioteca MaxVideoAI conectada. Quando o ChatGPT ou outro host compatível expõe anexos autorizados pelo usuário ou um resultado de arquivo gerado, import_reference_files importa até oito arquivos e retorna valores privados de assetId prontos para a solicitação; nenhuma nova listagem de biblioteca é necessária.

Se o host não expuser identificadores de arquivo, chame create_reference_upload_link com image, video ou audio. Uma superfície compatível do ChatGPT ou Claude pode exibir seu importador de múltiplos arquivos no chat. A página HTTPS retornada no navegador permanece como fallback manual. Codex e Claude Code podem usar um link por arquivo local com o helper empacotado. Nenhum caminho envia um nome de arquivo local bruto ao servidor MCP, publica uma URL pública ou exige Computer Use.

Sempre chame get_model_details para o modo selecionado. Ele retorna os tipos de mídia aceitos, papéis, ordem, contagens, formatos, tamanhos e limites de duração. Não copie regras de referência de um modelo diferente. URLs de origem privadas e valores estáveis de assetId permanecem dentro do limite da conta.

Seedance 2.5 está disponível por meio de sua rota ModelArk funcional para texto-para-vídeo, imagem-para-vídeo, referência-para-vídeo e extensão. Vídeo-para-vídeo direto que depende do BytePlus LAS não é exposto até que o acesso LAS exista; essa limitação não desativa os modos Seedance 2.5 suportados.

Orçamento, preço exato e aprovação

calculate_project_budget é gratuito e útil no início. Ele estima um filme a partir de propostas nomeadas, durações de cenas, escolhas de modelo e premissas explícitas de tentativas criativas. Não reserva capacidade, debita créditos nem cria um job.

Quando o usuário escolhe uma solicitação concreta, prepare_generation realiza a validação final e retorna o preço exato da conta com uma expiração. Exiba esse preço e aguarde uma aprovação inequívoca. Somente então chame confirm_generation uma vez com o identificador do orçamento.

Se os créditos forem insuficientes:

1. chame create_topup_link para esse orçamento;
2. envie o usuário para a página de cobrança MaxVideoAI retornada;
3. após o usuário confirmar que o pagamento foi concluído, chame get_account_status novamente;
4. chame prepare_generation novamente porque o orçamento anterior não é mais válido;
5. mostre o preço exato atualizado e solicite aprovação novamente.

O plugin em si, o aconselhamento de modelos e os orçamentos de projeto não exigem assinatura separada. Gerações pagas usam o saldo de créditos MaxVideoAI pré-pago existente.

Jobs, biblioteca, falhas e novas tentativas

Um job aceito ainda não é um vídeo concluído. Consulte get_generation_status para um job conhecido ou chame list_recent_generations para recuperá-lo. Quando concluído, present_generation pode renderizar a imagem ou o vídeo reproduzível inline em um host compatível com MCP Apps. Outros clientes mantêm o link do resultado retornado e o destino da biblioteca MaxVideoAI como fallback universal. Não envie a mesma geração paga novamente apenas porque a primeira chamada expirou.

Imagens e vídeos bem-sucedidos são salvos na mesma biblioteca privada da conta MaxVideoAI usada pelo site. Retorne apenas o resultado oficial, workspace ou destino de biblioteca fornecido pela MaxVideoAI.

Para uma falha técnica definitiva, explique a falha retornada e o estado de reembolso. Não tente novamente automaticamente. Uma nova tentativa criativa é um novo esforço pago e precisa de um novo orçamento e uma nova aprovação explícita.

Crédito introdutório

Uma conta verificada elegível pode receber uma geração introdutória de Seedance 2 Mini quando a promoção estiver ativa. Este é um benefício promocional único, não um dinheiro de carteira reutilizável. Sua disponibilidade é retornada por get_account_status; nunca prometa antes de verificar a conta conectada. O áudio pode permanecer habilitado sem alterar o preço promocional quando o preset ao vivo assim indicar.

Desconectar e revogar

1. Remova MaxVideoAI do cliente.
2. Abra Conexões da conta MaxVideoAI.
3. Revogue a concessão relevante.
4. Confirme que a próxima chamada protegida exige uma nova aprovação no navegador.

Privacidade e segurança

• O e-mail da conta é omitido dos resultados das ferramentas.
• Prompts, tokens, segredos, URLs completas de referência, mídia privada e detalhes de pagamento são excluídos das análises de aquisição.
• Respostas autenticadas usam Cache-Control: private, no-store.
• Orçamentos expiram, o envio pago é idempotente e os limites de conta no servidor ainda se aplicam.
• O assistente não pode afirmar que o conteúdo gerado está automaticamente liberado para publicação ou uso comercial.

Solução de problemas

O navegador retorna a 127.0.0.1 e não consegue conectar

O listener temporário de callback do cliente desktop não está mais em execução ou usou uma porta diferente. Mantenha o cliente aberto, reinicie a conexão a partir desse cliente e aprove a nova solicitação. Não reutilize uma URL de autorização antiga.

A autenticação é solicitada novamente

A concessão OAuth pode ter expirado ou sido revogada. Reconecte e conclua uma nova aprovação no navegador. Nunca cole um bearer token no endereço MCP.

HTTP 401 / JSON-RPC -32001

A solicitação não tem uma concessão bearer válida. Deixe o cliente seguir o desafio WWW-Authenticate e sua URL de descoberta resource_metadata.

INTERNAL_ERROR

Mantenha o correlationId retornado, pare envios repetidos e entre em contato com o suporte MaxVideoAI se a falha persistir.

Um modo está ausente

Solicite get_model_details novamente. Um modelo pode suportar vários modos por meio de diferentes rotas de provedor; uma rota indisponível não deve ser interpretada como o modelo inteiro desabilitado.

Limites atuais

Esta não é uma API REST de propósito geral e não emite chaves de API para clientes. Ela não controla a linha do tempo do Studio, edita vídeo-fonte arbitrário, gerencia endpoints de callback do cliente, coleta detalhes de pagamento dentro do chat, expõe modelos ocultos ou aprova automaticamente mídia para publicação.

Visão geral da documentação · Verificações de segurança de conteúdo · Começando com MaxVideo AI