L’agente AI Claude Code con Higgsfield MCP: crea immagini e video

Higgsfield si collega a Claude Code con un solo comando claude mcp add e l’indirizzo https://mcp.higgsfield.ai/mcp. Dopodiché gli assegni un compito in linguaggio naturale e l’agente si collega autonomamente a Higgsfield, genera un’immagine o un video e te lo restituisce direttamente nella finestra. Paghi in due modi: con i crediti Higgsfield per le generazioni e con i limiti di Claude Code per mantenere il server nel contesto. Perciò la mia regola è semplice: se non usi MCP, disattivalo.

Prima il processo era lungo: andare sul sito di Higgsfield, capire l’interfaccia, scrivere un prompt, generare, scaricare e caricare il risultato nel progetto. Ora Higgsfield ha rilasciato il proprio MCP, quindi non devi più andare su Higgsfield né capire come funzionano quelle interfacce.

È difficile immaginare che qualcuno vada su Higgsfield per generare qualcosa, ora che puoi generare tutto tramite il tuo Claude Code.

Con questa configurazione ho realizzato un’intera presentazione, compresi tutti i video. Ho descritto l’intero compito e l’ho affidato all’agente.

C’è un rischio: l’agente potrebbe mettersi a sfornare 100 immagini, e pagheresti per ciascuna. Perciò includi in ogni compito una condizione sul costo e sul numero di tentativi.

Vediamo tutto in ordine: come collegare il server, assegnargli il primo compito, cosa paghi e quando disattivare il server.

Passaggio 1. Aggiungi il server Higgsfield con il comando claude mcp add#

Apri un terminale nella cartella del progetto in cui genererai immagini e video, quindi esegui:

claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

L’indirizzo si trova nella pagina ufficiale higgsfield.ai/mcp; copialo con il pulsante Copy connector URL.

Senza il flag --scope, il server viene aggiunto solo al progetto corrente. Con --scope project sarà disponibile a tutto il team per quel progetto; con --scope user sarà disponibile in tutti i tuoi progetti.

Aggiungi Higgsfield dove lo usi. In un progetto in cui scrivi codice o testi, occuperà spazio nel contesto senza fare nulla.

Ho parlato di altri server per Claude Code in un articolo separato.

Passaggio 2. Accedi al tuo account Higgsfield tramite /mcp#

Avvia Claude Code e inserisci /mcp. Seleziona higgsfield dall’elenco; si aprirà un browser. Accedi al tuo account Higgsfield.

Le generazioni verranno addebitate su questo account. Finché non accedi, il server restituisce un errore 401: Claude Code può vederlo, ma non può usarlo.

Passaggio 3. Verifica che il server sia connesso#

Esegui questo comando nel terminale:

claude mcp list

Il server higgsfield dovrebbe mostrare lo stato ✔ Connected.

Se lo stato è diverso, controlla i dettagli: indirizzo, ambito e stato del server.

claude mcp get higgsfield

Se non basta, rimuovi il server e aggiungilo di nuovo:

claude mcp remove higgsfield
claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

Dopodiché accedi di nuovo tramite /mcp. Claude Code cancella anche l’accesso salvato quando rimuove il server, quindi senza accedere di nuovo riceverai lo stesso errore 401.

Come assegnargli il primo compito per creare un’immagine e un video#

Assegnagli un primo compito senza generare nulla. Chiedi all’agente di mostrarti cosa può fare il server prima di spendere:

Mostrami quali strumenti e modelli ha il server Higgsfield e quanti crediti costa la generazione con ciascun modello. Non generare nulla.

Poi assegnagli il compito vero e proprio. Aggiungi alla fine di ogni compito una condizione: prima della generazione a pagamento, mostra il costo e concorda il numero di tentativi.

Un prompt /goal con un limite ai tentativi funziona secondo lo stesso principio: l’agente ha in anticipo un numero limitato di tentativi.

Compito per un’immagine da usare nella sezione hero di un sito web:

Prepara un’immagine in Higgsfield per la sezione hero del sito web del mio prodotto. Prodotto: [link]. Suggerisci un oggetto, un’angolazione, un colore e un’ambientazione che aiutino a spiegare il prodotto. Lascia spazio nell’inquadratura per il titolo e il pulsante della pagina. Formato orizzontale. Salva il file finito nella cartella images del progetto.
Prima della generazione a pagamento, mostrami il costo, concorda il numero di tentativi e aspetta il mio “yes”.

Compito per un video realizzato a partire da questa immagine:

Crea un breve video in Higgsfield a partire dall’immagine images/hero.png: la videocamera si avvicina lentamente al prodotto e lo sfondo si muove leggermente. Suggerisci un modello e chiedimi quanto deve durare il video. Crea 1 versione.
Prima della generazione a pagamento, mostrami il costo, concorda il numero di tentativi e aspetta il mio “yes”.

Poi l’agente si collega autonomamente a Higgsfield, scrive un prompt, genera e recupera un’immagine o un video, quindi te lo consegna nella finestra di Claude Code. Digli anche in linguaggio naturale cosa vuoi cambiare.

Quali modelli sono disponibili e quanto si paga per le generazioni#

Higgsfield per me funziona bene perché include tutti gli strumenti di IA nell’abbonamento, anche se si paga con i crediti.

Chiedi all’agente l’elenco dei modelli con il primo compito della sezione precedente: otterrai i modelli e i relativi prezzi in crediti aggiornati a oggi.

Le generazioni tramite MCP vengono addebitate in crediti sul tuo account Higgsfield. Il server stesso consuma i limiti di Claude Code, quindi hai due contatori di utilizzo. In un articolo separato ho mostrato dove vanno i token di Claude Code:

Quanto utilizzo consuma il server MCP e quando disattivarlo#

Ogni server MCP consuma limiti: le descrizioni dei suoi strumenti vengono aggiunte al contesto del modello.

La ricerca degli strumenti è abilitata per impostazione predefinita in Claude Code. All’inizio di una sessione vengono caricati i nomi degli strumenti e le istruzioni del server; le descrizioni complete vengono caricate quando servono. Se Claude Code si collega al tuo ANTHROPIC_BASE_URL, la ricerca è disabilitata e le descrizioni vengono caricate per intero. In entrambi i casi, il server occupa spazio nel contesto di ogni sessione.

Se hai installato moltissimi strumenti MCP, consumano i tuoi limiti senza portarti alcun beneficio. Ecco quindi una regola importante: se non usi MCP, disattivalo per evitare di sovraccaricare la finestra di contesto.

Puoi disattivare e riattivare il server così:

• Temporaneamente. Usa l’interruttore accanto a higgsfield in /mcp. Claude Code smette di collegarsi al server, l’impostazione viene salvata e la selezione viene ricordata per questo progetto.
• Completamente. Esegui claude mcp remove higgsfield. L’accesso salvato all’account viene cancellato insieme al server.
• Riattivarlo. Usa lo stesso interruttore in /mcp, oppure esegui di nuovo claude mcp add e accedi tramite /mcp.

Tieni attivo il server mentre lavori con immagini e video. Se scrivi codice o testi e non hai nulla da generare, disattivalo.

A proposito, ho realizzato una guida completa su come configurare il tuo primo agente con Hermes: dai un’occhiata:

Spiego cosa sono gli MCP, come evitare di installarne uno malevolo e quanto costano. Dopo averla guardata, capirai di quali connessioni ha davvero bisogno un agente.

Quale approccio scegliere: MCP, il programma Higgsfield o un server non ufficiale#

Ci sono tre modi per collegare Higgsfield a un agente:

Inizia con il server MCP: basta un comando per installarlo e un interruttore per disattivarlo. Se generi ogni giorno e non vuoi che un server occupi spazio nel contesto, valuta il programma Higgsfield con le skill.

Prossimo passo: nell’account Higgsfield collegato, verifica strumenti, modelli e costi in crediti come indicato sopra, senza generare nulla. Scegli un risultato previsto e un budget di tentativi prima di generare. Per un flusso separato con l’API Ailoot, consulta la guida alle richieste di immagini o la guida a compiti video e risultati; descrivono chiamate API Ailoot, non questo account MCP Higgsfield.