Generazione video con Claude Code e MCP: configurazione passo per passo

Sei nel terminale, a metà di una landing page, e ti servono tre clip prodotto da 5 secondi, un'immagine hero e una voce fuori campo da 20 secondi. La strada solita sono quattro schede del browser, tre login, una cartella download piena di file chiamati output(7).mp4 e nessuna idea precisa di quanto sia costato il pomeriggio. L'altra strada è una frase scritta in Claude Code, con i file che arrivano nel tuo progetto, ciascuno etichettato con il modello usato e il suo costo.

La seconda strada si basa sul Model Context Protocol. Claude Code parla MCP in modo nativo, quindi qualsiasi servizio di generazione che esponga un server MCP ospitato diventa un insieme di strumenti che l'agente può chiamare. Qui trovi la configurazione, le impostazioni dei permessi da cambiare fin dal primo giorno, come formulare le richieste perché l'agente scelga il modello e la durata giusti, e i conti su quanto costano lotti reali.

Cosa succede quando Claude Code chiama uno strumento video

Il trasporto

Un server MCP ospitato usa il trasporto Streamable HTTP. La specifica MCP (2025-06-18) definisce due trasporti standard, stdio e Streamable HTTP, e richiede che il server esponga un unico percorso di endpoint che accetti POST e GET, per esempio https://example.com/mcp. Il client invia ogni messaggio JSON-RPC come POST, e il server risponde con JSON semplice o con un flusso di eventi.

In pratica, un server ospitato è un URL più una credenziale, senza nulla da eseguire in locale, e funziona da Claude Code, Cursor o qualsiasi altro client MCP.

Scoperta e chiamate

Secondo la specifica MCP sugli strumenti, il client elenca ciò che un server offre con tools/list e invoca uno strumento con tools/call. Ogni strumento ha un nome, una descrizione e uno schema di input. Quando chiedi "una clip di 5 secondi di una tazza in ceramica che ruota su un tavolo di noce", Claude legge le descrizioni degli strumenti, compila gli argomenti e fa la chiamata. Anthropic descrive la regola di attivazione nella documentazione del connettore MCP: Claude chiama uno strumento MCP quando la richiesta corrisponde alla capacità descritta di quello strumento, che tu lo nomini o no, e non chiama strumenti per rispondere a domande di cultura generale.

Cosa torna indietro

Il risultato di uno strumento può contenere testo, un'immagine (dati base64 più tipo MIME), audio, un resource_link o una risorsa incorporata, e facoltativamente un oggetto structuredContent che segue uno schema di output. La specifica chiede ai server che restituiscono contenuto strutturato di includere gli stessi dati anche come JSON serializzato in un blocco di testo. Per la generazione, questa è la parte che conta. Un server ben fatto restituisce un link al file e un piccolo record strutturato del job (modello, durata, risoluzione, costo), e tiene il video fuori dalla conversazione.

Passo per passo: collegare un server MCP ospitato

La documentazione MCP di Claude Code riporta la forma generale per un server remoto: claude mcp add --transport http <name> <url>, con un --header "Authorization: Bearer your-token" facoltativo per i server che si autenticano con una chiave statica.

Crea una chiave. Una chiave per progetto o per agente, così puoi revocarne una senza rompere le altre.
Scegli un ambito. Local è il valore predefinito e vive in ~/.claude.json solo per il progetto corrente. Project scrive il server in un file .mcp.json pensato per essere condiviso tramite il repository. User lo rende disponibile in ogni progetto sulla tua macchina. Si imposta con -s o --scope.
Aggiungi il server. Per Aitachyon: claude mcp add --transport http aitachyon https://aitachyon.com/api/mcp --header "Authorization: Bearer ait_..."
Verifica. claude mcp list mostra tutti i server configurati e claude mcp get aitachyon ispeziona questo. Dentro una sessione, /mcp mostra lo stato della connessione e gli strumenti esposti.
Fai una prima chiamata economica. Chiedi un'immagine prima di qualsiasi video. Prova la chiave e i tuoi permessi per pochi centesimi.

I server che usano OAuth seguono un percorso leggermente diverso: aggiungi il server senza header, poi accedi con claude mcp login <name> oppure da /mcp dentro Claude Code. Sotto il cofano, la specifica di autorizzazione MCP si basa su OAuth 2.1 con PKCE, registrazione dinamica dei client (RFC 7591), metadati delle risorse protette (RFC 9728) e indicatori di risorsa RFC 8707. Entrambi i percorsi finiscono con un token bearer su ogni richiesta.

Tre trappole di configurazione

L'ambito project e le chiavi in chiaro non vanno d'accordo. Un file .mcp.json nasce per essere committato. Se ci metti un token bearer e fai push, la chiave resta nella cronologia di git. Tieni i server con chiave in ambito local o user.
Le variabili d'ambiente con nomi da segreto vengono lette come vuote. La documentazione di Claude Code segnala che le variabili il cui nome contiene TOKEN, SECRET, PASSWORD, KEY o AUTH risultano vuote quando compaiono nell'URL o negli header di un server remoto. Un header costruito da AITACHYON_API_KEY parte vuoto e il server rifiuta la chiamata. Passa la chiave direttamente nel comando add.
Le chiavi restano fuori dall'URL. La specifica di autorizzazione richiede i token di accesso nell'header Authorization a ogni richiesta e li vieta nella query string, dove finirebbero nei log di proxy e server.

Permessi: decidi cosa può spendere l'agente senza chiedere

Uno strumento di generazione spende denaro a ogni chiamata, quindi merita più attenzione di uno che legge file. La specifica MCP sugli strumenti dice che dovrebbe sempre esserci una persona in grado di negare le invocazioni, e che i client dovrebbero mostrare gli input prima di chiamare. Claude Code lo realizza con regole di permessi che puntano agli strumenti MCP tramite il prefisso mcp__.

mcp__aitachyon in una regola allow lascia girare l'intero server senza richieste di conferma.
mcp__aitachyon in una regola deny lo blocca per un progetto, utile nei repository dove nessuno deve generare media.
mcp__* come regola deny blocca tutti gli strumenti MCP in un colpo solo.

Due dettagli fanno risparmiare tempo di debug. Claude Code salta qualsiasi regola mcp__ scritta con le parentesi e la elenca nella finestra delle impostazioni non valide e in claude doctor. Per riferirti al valore di un parametro specifico di uno strumento MCP, passa una regola deny tramite --disallowedTools.

Una regola di decisione per le approvazioni

Prima settimana con un server nuovo: approva ogni chiamata a mano e leggi modello, durata e risoluzione che Claude ha compilato, perché sono loro a fissare il prezzo.
Dopo dieci chiamate di fila con argomenti sensati: consenti gli strumenti per le immagini e lascia quelli video su approvazione. Le immagini costano centesimi; un lotto di video costa dollari.
Esecuzioni senza supervisione: consenti tutto, ma solo con una chiave dedicata che abbia un proprio avviso di spesa e si possa revocare con un clic.

Chiedere media a parole tue

Claude sceglie valori predefiniti ragionevoli, e spesso sono più lunghi, più nitidi o più rumorosi di quanto serva all'inquadratura. Ogni richiesta video dovrebbe fissare quattro cose: il modello (o il compromesso che ti interessa), la durata, la risoluzione o il rapporto d'aspetto, e se ti serve l'audio.

Prima e dopo

Prima: "Fai un video della nostra tazza per la homepage."

Modello, durata, formato e audio sono lasciati all'agente, che potrebbe attivare un audio nativo che poi silenzierai comunque.

Dopo: "Genera una clip di 5 secondi in 16:9 con Kling v3, senza audio: una tazza in ceramica bianco opaco che ruota lentamente su un tavolo di noce, luce morbida da finestra da sinistra, profondità di campo ridotta. Salvala in public/media/hero-mug.mp4 e riporta il ref e il costo."

Il secondo prompt fissa il prezzo prima della chiamata. Al momento della scrittura, Kling v3 su Aitachyon costa 0,16 $ al secondo senza audio e 0,32 $ al secondo con audio nativo, quindi questa clip costa 5 × 0,16 $ = 0,80 $. Aggiungere "con audio" porta il costo a 1,60 $ per un suono che partirà muto sulla maggior parte delle homepage.

Un modello di richiesta riutilizzabile

Incollalo nel CLAUDE.md del tuo progetto così che ogni richiesta porti gli stessi vincoli:

Asset: immagine, clip o voce fuori campo, e quanti
Modello: un modello indicato per nome, o "il più economico che supporta X"
Specifiche: durata in secondi, risoluzione, rapporto d'aspetto (9:16, 16:9, 1:1)
Audio: nessuno, nativo o una voce fuori campo separata
Contenuto: soggetto, azione, ambientazione, luce, camera
Output: percorso di destinazione e schema del nome file
Budget: "fermati e chiedi se il lotto supera X $"
Report: "elenca ogni file con ref, modello e costo, poi il totale"

Le ultime due righe sono quelle che tutti saltano, ed è proprio grazie a loro che i numeri restano nella cronologia del terminale accanto ai file.

Scegliere il modello per ogni inquadratura, con i compromessi dichiarati

Con un solo account dietro un solo server MCP, il modello diventa un argomento per singola inquadratura invece di un impegno per abbonamento. I prezzi qui sotto sono i prezzi per chiamata di Aitachyon al momento della scrittura; il listino completo è su aitachyon.com/models e in JSON su https://aitachyon.com/api/pricing.

Video

Hailuo 02, 0,085 $/s. L'opzione video più economica dell'elenco. Va bene per bozze, test di hook e tutto ciò dove conta più il volume della rifinitura.
Kling v3, 0,16 $/s senza audio, 0,32 $/s con audio nativo. L'audio raddoppia il prezzo, quindi decidi clip per clip. I compromessi rispetto a Seedance sono nel confronto Kling v3 contro Seedance 2.5.
Veo 3.1 Fast, da 0,19 $/s. Per riferimento, la pagina dei prezzi dell'API Gemini di Google indica Veo 3.1 Fast a 0,10 $ al secondo in 720p, 0,12 $ in 1080p e 0,30 $ in 4K, Veo 3.1 Standard a 0,40 $ al secondo e un livello Lite da 0,05 $. Se Veo è l'unico modello che chiamerai, andare direttamente da Google costa meno al secondo. Un aggregatore si guadagna il margine con gli altri modelli sulla stessa chiave e con il registro dei costi per job. Approfondimento nella guida all'API di Veo 3.1 Fast.
Wan 2.7, 0,19 $/s. Un secondo tentativo utile su un'inquadratura che un altro modello continua a sbagliare.
Seedance 2.5, 0,20 $/s in 480p, 0,44 $/s in 720p. La risoluzione più che raddoppia il prezzo, quindi fai le bozze in 480p e ripeti il render in 720p solo per quelle da tenere.

Immagini

Seedream 4.0 a 0,057 $ per immagine e FLUX.2 [pro] da 0,057 $ a 0,086 $: la fascia bassa, adatta a foto prodotto e sfondi.
Nano Banana, 0,13 $ per immagine. Nano Banana contro FLUX.2 Pro per le immagini di prodotto spiega quando vale la pena pagare di più.
gpt-image-2, da 0,10 $ a 0,40 $ per immagine. L'intervallo di prezzo più ampio, quindi fissa la dimensione nel prompt.

Voce

La voce fuori campo di ElevenLabs costa da 0,043 $ a 0,086 $ ogni 450 caratteri al momento della scrittura. I modelli sottostanti differiscono per limiti e copertura linguistica: ElevenLabs documenta eleven_v3 con 5.000 caratteri e più di 70 lingue, eleven_multilingual_v2 con 10.000 caratteri e 29 lingue, ed eleven_flash_v2_5 con 40.000 caratteri e 32 lingue. Per copioni della lunghezza di uno spot il limite di caratteri raramente pesa, mentre l'elenco delle lingue conta appena localizzi. I conti al minuto sono nel dettaglio dei costi della voce fuori campo con l'API ElevenLabs.

I conti di tre lotti reali

I prezzi al secondo e per immagine rendono un lotto prevedibile, a patto di moltiplicare prima di premere invio. Tutte le cifre usano i prezzi di Aitachyon al momento della scrittura.

Lotto 1: 20 clip hook per testare le creatività

Venti aperture da 5 secondi, ognuna con una prima battuta diversa presa da un elenco come queste formule di hook.

Hailuo 02: 20 × 5 s × 0,085 $ = 8,50 $
Kling v3, senza audio: 20 × 5 s × 0,16 $ = 16,00 $
Seedance 2.5 in 720p: 20 × 5 s × 0,44 $ = 44,00 $

La sequenza sensata: bozza di tutte e venti sul modello più economico, tieni le tre che funzionano meglio e rifai il render solo di quelle sul modello che consegneresti. Tre vincitrici su Seedance in 720p aggiungono 3 × 2,20 $ = 6,60 $, per un totale di 15,10 $ contro 44,00 $ per renderizzare tutto al livello più alto.

Lotto 2: 50 foto prodotto

Seedream 4.0: 50 × 0,057 $ = 2,85 $
FLUX.2 [pro]: 50 × 0,057 $ a 0,086 $ = da 2,85 $ a 4,30 $
Nano Banana: 50 × 0,13 $ = 6,50 $

Lotto 3: una settimana di short

Sette short, ognuno composto da tre clip Kling v3 da 5 secondi (senza audio), tre keyframe Seedream e una voce fuori campo da 900 caratteri.

Clip: 15 s × 0,16 $ = 2,40 $ per short
Keyframe: 3 × 0,057 $ = 0,171 $ per short
Voce fuori campo: 2 × 450 caratteri a un massimo di 0,086 $ = fino a 0,172 $ per short
Per short: circa 2,74 $. Per la settimana: circa 19,20 $

Gli stessi conti per ogni modello sono in prezzi delle API di generazione video con IA nel 2026.

Render lunghi, limiti di output e recupero dei file

Dimensione dell'output

Claude Code ha un budget rigido per ciò che uno strumento può restituire. Secondo la documentazione MCP di Claude Code, avvisa quando l'output di uno strumento MCP supera i 10.000 token e lo limita a 25.000 token per impostazione predefinita, regolabile con la variabile d'ambiente MAX_MCP_OUTPUT_TOKENS (per esempio 50000). Un server che restituisse video base64 grezzo toccherebbe quel tetto già alla prima clip. Un link e un breve record strutturato tengono ogni risultato piccolo e lasciano la finestra di contesto al tuo lavoro vero.

Timeout

Il video richiede più tempo di una tipica chiamata a strumento. La stessa documentazione permette di impostare un timeout per strumento a livello di server in .mcp.json, in millisecondi con un minimo di 1000, e osserva che le connessioni HTTP e SSE cadono per inattività dopo 5 minuti per impostazione predefinita. Se un lotto lungo si interrompe a metà, controlla questi valori prima di dare la colpa al modello. Chiedi i render a piccoli gruppi e fai riferire l'agente dopo ogni gruppo, così una connessione caduta fa perdere solo lo stato del gruppo in corso.

Ref stabili come passaggio di consegne

Su Aitachyon ogni file generato riceve un ref stabile (img_, scn_, vo_ e così via) che il codice può recuperare con GET /api/generations/{ref}. Questo traccia un confine netto tra l'agente e la tua build:

In Claude Code, genera l'asset e chiedi il ref nel report.
Registra il ref in un file manifest nel repository, accanto al prompt che lo ha prodotto e al suo costo.
Uno script di build o un passaggio di CI recupera ogni ref tramite la semplice API HTTP con la stessa chiave bearer.
Quando rigeneri un'inquadratura, cambi un solo ref nel manifest e la pipeline lo recepisce.

Il manifest fa anche da registro dei costi per inquadratura. La versione estesa di questa pipeline, con la scrittura dei copioni in aggiunta, è in automatizzare la produzione video con agenti IA.

Usarlo senza Claude Code

Lo stesso server ospitato può essere chiamato dal tuo backend. Il connettore MCP di Anthropic permette alla Messages API di raggiungere server MCP remoti senza un client MCP separato. È in beta con l'header mcp-client-2025-11-20, supporta liste di strumenti consentiti e bloccati, accetta token bearer OAuth e più server per richiesta, e non è idoneo alla conservazione zero dei dati. La lista degli strumenti consentiti è la parte utile: esponi gli strumenti per le immagini a una funzione rivolta ai clienti e tieni spenti quelli video finché non ne hai calcolato il costo.

Controllo della spesa quando un agente tiene la chiave

Un agente che può chiamare uno strumento a pagamento in un ciclo può anche spendere denaro in un ciclo. Un'istruzione letta male, "fai delle varianti" interpretato come cinquanta invece di cinque, è un guasto realistico. I controlli utili, in ordine di quanto presto intercettano il problema:

Budget nel prompt. "Fermati e chiedi se il lotto costerà più di 10 $" è una regola che l'agente può verificare con i prezzi al secondo.
Approvazione sugli strumenti video, come impostato nella sezione sui permessi.
Una chiave per agente o progetto. Aitachyon traccia la spesa per chiave API, lancia un avviso quando una chiave spende in modo insolitamente rapido e revoca una chiave con un clic.
Saldo prepagato. Quando finisce, le chiamate si fermano. È un tetto che un ciclo fuori controllo non può superare.
Rimborsi automatici in caso di errore. Un render fallito viene rimborsato al centesimo, quindi i tentativi ripetuti non ti addebitano due volte in silenzio.

Anthropic aggiunge la regola di base nella sua nota sui server MCP remoti: sono servizi di terze parti, quindi collegati solo a server di cui ti fidi e controlla le pratiche di sicurezza e i termini di ciascuno.

FAQ

Come aggiungo un server MCP a Claude Code?

Esegui claude mcp add --transport http <name> <url>, aggiungendo --header "Authorization: Bearer <key>" per i server con chiave. Usa -s per scegliere l'ambito local, project o user, poi conferma con claude mcp list o /mcp dentro una sessione. Per i server OAuth, aggiungi senza header e accedi con claude mcp login <name>.

Claude Code può generare video da solo?

Claude Code affida il rendering a uno strumento di un server MCP collegato, che esegue il modello video. Una volta collegato un server del genere, chiedi a parole tue e Claude compila gli argomenti dello strumento, fa la chiamata e ti restituisce il risultato.

Perché il mio server MCP rifiuta la chiave che ho messo in una variabile d'ambiente?

Claude Code legge come vuote le variabili d'ambiente il cui nome contiene TOKEN, SECRET, PASSWORD, KEY o AUTH quando compaiono nell'URL o negli header di un server remoto, quindi l'header parte vuoto. Passa la chiave direttamente nel comando claude mcp add e tieni il server in ambito local o user.

Quanto costa una clip video IA di 5 secondi?

Dipende dal modello e dalle impostazioni. Ai prezzi di Aitachyon al momento della scrittura, 5 secondi costano circa 0,43 $ su Hailuo 02, 0,80 $ su Kling v3 senza audio, 1,60 $ con audio nativo, e 1,00 $ o 2,20 $ su Seedance 2.5 in 480p o 720p.

Fonti

Se vuoi questa configurazione senza cinque account separati, Aitachyon riunisce i modelli video, immagine e voce visti sopra dietro una chiave, un server MCP ospitato e un saldo prepagato, con ogni job dettagliato per modello e costo. Il comando su una riga per Claude Code e l'API HTTP sono nella pagina per sviluppatori.