Server MCP per generare video con l’IA

Cos’è il server MCP video di VidFlux?

Il Model Context Protocol (MCP) è lo standard aperto con cui gli assistenti IA richiamano strumenti esterni. VidFlux MCP è un endpoint ospitato che dà al tuo assistente strumenti video: avviare una generazione da testo a video, da immagine a video o con controllo del movimento, seguirne l’avanzamento e ottenere l’MP4 finito. L’assistente scrive il prompt, sceglie modello, durata e formato, attende il rendering e ti consegna il file senza che tu lasci la chat o l’editor.

Dietro l’endpoint gira la stessa pipeline del generatore video di vidflux.ai: versioni dei modelli, prezzi e rimborsi sono identici e ogni lavoro compare anche nella cronologia del tuo account.

Modelli video IA supportati

Indica l’ID del modello nell’argomento model. I crediti si riferiscono alle impostazioni predefinite; video più lunghi, con risoluzione più alta o con audio costano di più. dry_run restituisce il prezzo esatto per qualsiasi impostazione.

Modelli immagine per fotogrammi chiave e copertine

Crea o modifica fotogrammi iniziali, foto prodotto e copertine, poi animali con uno qualsiasi dei modelli da immagine a video qui sopra.

Avvio rapido: collegati in 3 passaggi

1. Accedi a VidFlux e crea una chiave in Impostazioni → API & MCP. I nuovi account ricevono crediti di prova gratuiti.
2. Aggiungi il server al tuo client IA con una delle configurazioni qui sotto.
3. Chiedi un video, per esempio: «Crea con Seedance 2 un video di 5 secondi in 9:16 di latte art versato al rallentatore e salvalo in ./assets».

Configurazione dei client MCP

Sostituisci vf_your_api_key con la tua chiave. Nei client che leggono le variabili d’ambiente, conserva la chiave in VIDFLUX_API_KEY invece che nel file di configurazione.

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

Claude Desktop si collega ai server remoti con chiave API tramite mcp-remote (serve Node.js). Modifica claude_desktop_config.json e riavvia Claude:

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

Cursor

Aggiungi a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json (un progetto):

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

Aggiungi a .vscode/mcp.json:

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

Windsurf

Aggiungi a ~/.codeium/windsurf/mcp_config.json:

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

Cline, Roo Code e altri client

Qualsiasi client che supporta server Streamable HTTP con intestazioni personalizzate funziona con lo stesso URL e la stessa intestazione. I client che supportano solo stdio possono usare il comando mcp-remote della configurazione di Claude Desktop.

Strumenti MCP

La generazione video è asincrona. Un flusso tipico dell’agente è questo:

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

Prezzi: crediti a consumo

• Collegare il server e chiamare list_models, get_task o get_credits è gratuito.
• Ogni video costa gli stessi crediti che su vidflux.ai (vedi le tabelle). I pacchetti partono da 500 crediti a 4,98 $, i pacchetti più grandi costano meno per credito e i crediti acquistati non scadono.
• dry_run: true convalida gli argomenti e restituisce il prezzo esatto e se il saldo basta, senza generare nulla.
• I lavori non riusciti o rifiutati vengono rimborsati automaticamente.

Vedi pacchetti di crediti e piani

Cosa puoi realizzare

VidFlux MCP vs API dei singoli fornitori vs server MCP self-hosted

Risoluzione dei problemi

Il server risulta collegato ma gli strumenti video non compaiono

Riavvia il client o ricarica i server MCP e verifica che la modalità Agent sia attiva (Cursor, VS Code). In Claude Code, /mcp mostra l’elenco degli strumenti.

401 Unauthorized o «Missing or invalid API key»

L’intestazione deve essere esattamente Authorization: Bearer vf_…. Controlla che la chiave non sia stata revocata e che non siano stati copiati virgolette o spazi in più.

402 INSUFFICIENT_CREDITS

Il saldo è inferiore al prezzo restituito da dry_run. Ricarica i crediti o scegli un video più corto, una risoluzione più bassa o un modello più economico.

Un video resta a lungo in processing

La maggior parte dei video è pronta in 1-5 minuti; i video lunghi di Seedance 2.5 o in 4K con Gemini Omni richiedono di più. Continua a interrogare get_task. Se il lavoro fallisce, viene restituito l’errore e i crediti vengono rimborsati.

spawn npx ENOENT in Claude Desktop

mcp-remote richiede Node.js 18 o successivo. Installa Node.js o indica il percorso completo di npx nel campo command.

Le immagini di riferimento vengono rifiutate

image_urls deve contenere link HTTPS pubblici a file JPG, PNG o WebP. Percorsi locali e link protetti da login non possono essere letti.

Domande frequenti