Servidor MCP para gerar vídeos com IA

O que é o servidor MCP de vídeo da VidFlux?

O Model Context Protocol (MCP) é o padrão aberto que os assistentes de IA usam para chamar ferramentas externas. O VidFlux MCP é um endpoint hospedado que dá ao seu assistente ferramentas de vídeo: iniciar uma geração de texto para vídeo, imagem para vídeo ou controle de movimento, acompanhar o progresso e receber o MP4 pronto. O assistente escreve o prompt, escolhe o modelo, a duração e o formato, espera a renderização e entrega o arquivo sem você sair do chat ou do editor.

Por trás do endpoint roda o mesmo sistema do gerador de vídeos do vidflux.ai, então as versões dos modelos, os preços e os reembolsos são idênticos, e cada tarefa também aparece no histórico da sua conta.

Modelos de vídeo com IA compatíveis

Informe o ID do modelo no argumento model. Os créditos são para a configuração padrão; vídeos mais longos, com mais resolução ou com áudio custam mais. O dry_run devolve o preço exato para qualquer configuração.

Modelos de imagem para quadros-chave e capas

Crie ou edite quadros iniciais, fotos de produto e capas, e depois anime tudo com qualquer um dos modelos de imagem para vídeo acima.

Comece rápido: conecte em 3 passos

1. Entre na VidFlux e crie uma chave em Configurações → API & MCP. Contas novas ganham créditos de teste grátis.
2. Adicione o servidor ao seu cliente de IA com uma das configurações abaixo.
3. Peça um vídeo, por exemplo: “Faça com o Seedance 2 um vídeo de 5 segundos em 9:16 de latte art sendo servido em câmera lenta e salve em ./assets”.

Configuração dos clientes MCP

Troque vf_your_api_key pela sua chave. Nos clientes que leem variáveis de ambiente, guarde a chave em VIDFLUX_API_KEY em vez de colocá-la no arquivo de configuração.

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

O Claude Desktop se conecta a servidores remotos com chave de API usando o mcp-remote (precisa de Node.js). Edite o claude_desktop_config.json e reinicie o Claude:

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

Cursor

Adicione em ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

{
  "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)

Adicione em .vscode/mcp.json:

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

Windsurf

Adicione em ~/.codeium/windsurf/mcp_config.json:

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

Cline, Roo Code e outros clientes

Qualquer cliente compatível com servidores Streamable HTTP e cabeçalhos personalizados funciona com a mesma URL e o mesmo cabeçalho. Clientes que só aceitam stdio podem usar o comando mcp-remote da configuração do Claude Desktop.

Ferramentas MCP

A geração de vídeo é assíncrona. Um fluxo típico do agente é assim:

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"}

Preços: créditos pré-pagos por uso

• Conectar o servidor e chamar list_models, get_task ou get_credits é grátis.
• Cada vídeo custa os mesmos créditos que no vidflux.ai (veja as tabelas). Os pacotes começam em 500 créditos por US$ 4,98, pacotes maiores saem mais baratos por crédito e os créditos comprados não expiram.
• Com dry_run: true, os argumentos são validados e você recebe o preço exato e se o saldo é suficiente, sem gerar nada.
• Tarefas com falha ou recusadas são reembolsadas automaticamente.

Ver pacotes de créditos e planos

O que dá para fazer

VidFlux MCP x APIs de cada fornecedor x MCP auto-hospedado

Solução de problemas

O servidor aparece conectado, mas as ferramentas de vídeo não aparecem

Reinicie o cliente ou recarregue os servidores MCP e confira se o modo Agent está ativo (Cursor, VS Code). No Claude Code, /mcp mostra a lista de ferramentas.

401 Unauthorized ou “Missing or invalid API key”

O cabeçalho precisa ser exatamente Authorization: Bearer vf_…. Confira se a chave não foi revogada e se não vieram aspas ou espaços a mais na cópia.

402 INSUFFICIENT_CREDITS

Seu saldo é menor que o preço devolvido pelo dry_run. Compre créditos ou escolha um vídeo mais curto, com menos resolução ou um modelo mais barato.

O vídeo fica muito tempo em processing

A maioria dos vídeos fica pronta em 1 a 5 minutos; vídeos longos do Seedance 2.5 ou em 4K no Gemini Omni levam mais. Continue consultando get_task. Se a tarefa falhar, o erro é devolvido e os créditos são reembolsados.

spawn npx ENOENT no Claude Desktop

O mcp-remote precisa do Node.js 18 ou superior. Instale o Node.js ou coloque o caminho completo do npx no campo command.

As imagens de referência são recusadas

image_urls precisa ter links HTTPS públicos para arquivos JPG, PNG ou WebP. Caminhos locais e links que exigem login não podem ser lidos.

Perguntas frequentes