
Higgsfield MCP per Claude Code: Setup in 60 Secondi (e 5 Insidie da Evitare)
Ultimo aggiornamento: 6 giugno 2026. Comando di installazione e flusso OAuth riverificati. Roster di modelli (GPT Image 2, Soul V2, Veo 3.1, Kling 3.0, Flux 2, Nano Banana Pro, Seedance 2.0) confermato come aggiornato. Crediti del piano gratuito (150/mese) ancora corretti.
Per usare Higgsfield MCP con Claude Code, esegui claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp nel terminale. Claude Code gestisce l'autenticazione via OAuth nel browser, senza chiavi API. Il server espone cinque strumenti (generate_image, generate_video, create_character, get_generation_status, list_characters) attraverso sette modelli. Il setup si completa in meno di 60 secondi su una connessione normale.
Higgsfield ha pubblicato il suo server MCP hosted il 30 aprile 2026, otto giorni fa mentre scrivo queste righe. Se hai Claude Code installato, puoi collegare Higgsfield MCP al tuo workflow con un solo comando — senza chiavi API, senza pacchetti npm. Alla fine di questo articolo avrai il server installato su tutti i client AI che usi davvero, saprai quale dei sette modelli scegliere in base al contesto, e avrai a disposizione la ricetta di prompting che usiamo per le hero image del blog.
Su techsy.io usiamo già le quattro skill agente Higgsfield — higgsfield-generate, higgsfield-product-photoshoot, higgsfield-soul-id e higgsfield-marketplace-cards — per le immagini di copertina e lifestyle. Affianchiamo il server MCP per generare immagini più ricche direttamente in chat. MCP è il modo in cui il context engineering si concretizza a livello di strumenti: invece di incollare URL e prompt in un'interfaccia separata, il modello sceglie il modello e i parametri nella stessa conversazione in cui stai scrivendo.
Risposta rapida
- Higgsfield MCP è un server hosted su
https://mcp.higgsfield.ai/mcpche espone sette modelli di immagini e video a qualsiasi client MCP.- Si installa in Claude Code con un solo comando; l'autenticazione è OAuth, niente chiavi API.
- Funziona con Claude Code, Claude Desktop, Cursor, Windsurf, Cline e OpenCode.
- Piano gratuito: 150 crediti/mese (aggiornato a maggio 2026); oltre quella soglia, 1 $ = 16 crediti.
Cosa Fa Concretamente Higgsfield MCP
Higgsfield MCP è un server Model Context Protocol (MCP) hosted su https://mcp.higgsfield.ai/mcp che permette a qualsiasi client MCP compatibile (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, OpenCode) di chiamare sette modelli di immagini e video tramite cinque strumenti, con autenticazione OAuth. Niente chiavi API, niente npm install, niente proxy.
Il server MCP di Higgsfield si posiziona tra il tuo client AI e un catalogo di oltre 30 modelli generativi. L'endpoint hosted espone i sette che utilizziamo più spesso: Soul V2 per la coerenza dei personaggi, Veo 3.1 e Kling 3.0 per il video, GPT Image 2 per il realismo fotografico, Flux 2 per l'illustrazione, Nano Banana Pro per le iterazioni veloci, e Seedance 2.0 per i clip brevi. Puoi chiamarli tutti come modelli diversi dentro Claude Code senza uscire dalla chat.
| Modello | Tipo | Ideale per | Crediti approssimativi/gen |
|---|---|---|---|
| GPT Image 2 | Immagine | Realismo fotografico, foto prodotto | ~8 |
| Nano Banana Pro | Immagine | Iterazioni rapide ed economiche | ~2 |
| Soul V2 | Immagine | Coerenza personaggio (con create_character) | ~10 |
| Seedance 2.0 | Video | Clip brevi con movimento | ~30 |
| Veo 3.1 | Video | Clip cinematografici 8-15s | ~60 |
| Kling 3.0 | Video | Movimento fluido, azione personaggio | ~50 |
| Flux 2 | Immagine | Stile illustrativo | ~6 |
Piano gratuito: 150 crediti/mese, aggiornato a maggio 2026 e soggetto a variazioni.
I cinque strumenti esposti dal server sono l'intera superficie disponibile:
generate_image: generazione di immagini singolegenerate_video: generazione video asincrona, restituisce un job IDcreate_character: addestra un Soul Character per la coerenzaget_generation_status: interroga un job asincronolist_characters: elenca i personaggi addestrati
Tutto qui. Cinque strumenti, niente chiavi API, niente scope da memorizzare. Rispetto all'assemblare mezza dozzina di API di fornitori diversi, si capisce perché la specifica MCP si stia diffondendo così rapidamente. Per l'elenco canonico dei modelli, la pagina MCP ufficiale di Higgsfield è la fonte autorevole.
Come Aggiungo Higgsfield MCP a Claude Code?
Per installare Higgsfield MCP in Claude Code, esegui claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp. Al primo utilizzo Claude Code apre il browser per OAuth; accedi al tuo account Higgsfield, torna al terminale e verifica con claude mcp list o il comando /mcp. Questo è l'intero processo di setup.
Qui sta l'errore di quasi tutti i tutorial esistenti. Prima del 30 aprile non esisteva alcun server hosted, e gli autori assumevano che bisognasse installare un pacchetto npm e incollare un HIGGSFIELD_API_KEY nella shell. Non è così. L'MCP hosted gira sull'infrastruttura di Higgsfield e si autentica via OAuth nel browser.
Ecco il comando di installazione. Incollalo nel terminale:
claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcpDue flag che vale la pena conoscere. --transport http indica a Claude Code che si tratta di un server hosted via HTTP, non di un processo stdio locale. --scope user scrive la configurazione in ~/.claude/mcp.json, rendendo il server disponibile in tutti i progetti. Se vuoi limitarlo a un solo repo (e vuoi che venga tracciato in git così il team lo riceve automaticamente), usa --scope project: scrive in .mcp.json nella root del repo.
Verifica che tutto funzioni:
claude mcp list
# Higgsfield http ✔ connectedLa prima volta che chiami uno strumento Higgsfield, Claude Code avvia un callback OAuth locale sulla porta 8080 e apre il browser. Accedi al tuo account Higgsfield, torna al terminale e il gioco è fatto. Dentro qualsiasi sessione Claude Code puoi eseguire /mcp per vedere il pannello. Higgsfield dovrebbe apparire con cinque strumenti elencati.
Sull'M3 Pro su cui sto scrivendo, l'installazione più il round-trip OAuth si è completata in 47 secondi. I tempi variano in base alla connessione, ma se sei oltre i due minuti, salta direttamente alla sezione delle insidie in fondo.
Un appunto: se preferisci avvolgere lo stesso MCP dietro una skill di Claude Code, il repo higgsfield-skill di robonuggets fa esattamente questo. Abbiamo trattato questo pattern nel nostro tutorial su Claude Code skills. Puoi anche automatizzare intorno ai server MCP con gli hook — per esempio, eseguire automaticamente una chiamata list_characters prima di qualsiasi generazione di hero per il blog. Per la sintassi di configurazione canonica, la documentazione MCP di Anthropic per Claude Code copre i tipi di transport, i flag di scope e i flussi di ri-autenticazione in modo completo.

generate_image dentro una sessione Claude Code.
Come Aggiungo Higgsfield MCP a Claude Desktop?
Claude Desktop usa un file di configurazione JSON (claude_desktop_config.json) invece della CLI claude mcp add. Il percorso varia a seconda del sistema operativo. Modifica il file, aggiungi il blocco higgsfield e riavvia completamente Claude Desktop. OAuth viene eseguita al primo richiamo di uno strumento, non al caricamento della configurazione.
| Sistema operativo | Percorso |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
Aggiungi questo blocco:
{
"mcpServers": {
"higgsfield": {
"transport": {
"type": "http",
"url": "https://mcp.higgsfield.ai/mcp"
}
}
}
}Se Claude Desktop mostra il server nell'elenco ma gli strumenti non sono visibili, non hai chiuso completamente l'applicazione. Cmd-Q su macOS, non il pulsante rosso della finestra. Chiudere la finestra lascia il processo in esecuzione con la vecchia configurazione in memoria.
Setup di Higgsfield MCP su Cursor
Per usare higgsfield mcp cursor, modifica ~/.cursor/mcp.json e aggiungi il server higgsfield con transport HTTP che punta a https://mcp.higgsfield.ai/mcp. Riavvia Cursor; il server appare sotto Impostazioni → MCP Servers e si autentica via OAuth alla prima richiesta di generazione. Lo stesso JSON funziona anche come .cursor/mcp.json nella root del progetto.
Cursor rileva automaticamente il transport HTTP dal campo url, quindi non hai bisogno di dichiararlo esplicitamente. Ecco la configurazione:
{
"mcpServers": {
"higgsfield": {
"url": "https://mcp.higgsfield.ai/mcp"
}
}
}Salva il file, riavvia Cursor e apri Impostazioni → MCP Servers. Dovresti vedere "higgsfield" con un punto verde. La prima volta che chiedi a Cursor "Genera un'immagine hero di una volpe all'ora d'oro usando Higgsfield", il browser si apre per OAuth e la generazione parte non appena hai effettuato l'accesso.
Abbinalo a una regola Cursor che usa sempre Higgsfield per le immagini hero. Aggiungi una regola in .cursor/rules/blog-images.mdc che associa le richieste "blog hero" o "OG image" a generate_image con il tuo aspect ratio predefinito. Consiglio pratico: se fai commit di .cursor/mcp.json nella root del repo invece di usare il file di scope utente, tutto il team riceve il server al prossimo pull. Niente setup per ogni sviluppatore, niente thread su Slack su perché lo strumento non appare.

Come Installo Higgsfield MCP su Windsurf o Cline?
Entrambi i client usano la struttura mcp.json in stile VS Code, quindi lo stesso JSON funziona in entrambi. Windsurf legge ~/.codeium/windsurf/mcp_config.json; Cline (l'estensione VS Code) usa l'interfaccia delle Impostazioni o .vscode/mcp.json nel workspace.
{
"mcpServers": {
"higgsfield": {
"type": "http",
"url": "https://mcp.higgsfield.ai/mcp"
}
}
}Un consiglio per Cline da tenere a mente: abilita "Auto-approve safe tools" solo per list_characters e get_generation_status. Non abilitarlo per generate_video. Ogni chiamata brucia 30-60 crediti, e un agente autonomo in loop può consumare l'intero piano gratuito in cinque minuti. Strumenti di lettura: sì. Strumenti di generazione: no.
Curioso di come si confrontano i due client nel quotidiano? Il nostro confronto Windsurf vs Cursor copre i pro e i contro. Per Higgsfield in particolare, l'esperienza è identica una volta registrato il server. Entrambi i client parlano lo stesso protocollo wire MCP.
Higgsfield MCP Funziona con OpenCode?
Sì. OpenCode (l'alternativa open-source a Claude Code di sst/opencode) usa lo stesso protocollo wire MCP. La configurazione vive in .opencode/mcp.json nella root del repo, oppure in ~/.config/opencode/mcp.json per lo scope utente. Un nome di campo è diverso da Claude Code, quindi non copiare e incollare il blocco mcpServers alla cieca.
{
"servers": {
"higgsfield": {
"transport": "http",
"url": "https://mcp.higgsfield.ai/mcp"
}
}
}Nota che il campo si chiama servers, non mcpServers. Una trappola facile. Se gli strumenti non appaiono in OpenCode dopo aver aggiunto la configurazione, è quasi sempre questo il motivo. Esegui opencode mcp list per verificare; è lo specchio di claude mcp list. Il flusso OAuth è identico: apre il browser, callback, fatto.
Qual È il Modo Migliore per Fare Prompting con Higgsfield via MCP?
La ricetta di prompting più affidabile che abbiamo trovato è MCSLA: Model, Composition, Subject, Lighting, Aesthetic. Viene dalla skill di prompt cinematografico MCSLA e trasforma un vago "fammi un'immagine hero" in un brief che i modelli di Higgsfield riescono davvero a eseguire. Cinque campi, cinque righe, ogni volta.
- Model: scegli prima lo strumento giusto. GPT Image 2 per il realismo, Soul V2 per i personaggi ricorrenti, Flux 2 per lo stile illustrativo.
- Composition: inquadra la scena ("composizione hero grandangolare, soggetto a sinistra, spazio negativo a destra").
- Subject: indica cosa c'è nell'inquadratura, con attributi specifici ("una tazza in ceramica nera, condensa che scivola, su legno di quercia consumato").
- Lighting: direzionale e qualitativa ("luce calda di contorno dall'alto a sinistra, fill morbido, ombre blu profonde").
- Aesthetic: il look finale ("editoriale di magazine, grana da pellicola 35mm, color grading per SaaS marketing").
Il workflow di concatenazione con immagini di riferimento è dove l'MCP si guadagna il posto. Genera la v1, poi chiedi a Claude qualcosa tipo "adesso rifai con un contrasto più forte e una palette più fredda." La cronologia della chat mantiene l'URL dell'immagine, così la chiamata successiva a generate_image la passa automaticamente come riferimento. Iteri all'interno della conversazione invece di fare avanti e indietro con una UI separata.
Per la coerenza dei personaggi con higgsfield mcp, il workflow Soul Character è la strada giusta:
- Esegui
create_charactercon 3-5 immagini di riferimento. - Aspetta tre-cinque minuti per l'addestramento; verifica lo stato con
get_generation_status. - Usa il character ID restituito nelle successive chiamate a
generate_image. - Risultato: lo stesso volto in tutta una serie di post, senza derive.
Usiamo esattamente questo pattern su techsy.io. La skill higgsfield-product-photoshoot più la skill higgsfield-soul-id producono le illustrazioni dei membri del team e le marketplace card di tutto il sito. Il server MCP ci permette di iterare dentro una conversazione Claude Code invece di passare a una UI separata quando vogliamo una variante al volo. Quando serve lavoro ricorrente con lo stesso personaggio — stessa persona, dieci post — higgsfield-soul-id è la skill di riferimento. Per le marketplace card stagionali, higgsfield-marketplace-cards è più veloce.
Un'ultima mossa: memorizza lo stile del tuo blog come regola CLAUDE.md in modo che ogni prompt rimanga on-brand senza dover riscrivere le stesse cinque righe ogni volta. E se vuoi una libreria di partenza, i 19 style pack di AKCodez raccoglie preset estetici comuni come skill Claude Code pronte all'uso.
Come Si Generano le Hero Image del Blog con Higgsfield MCP?
Per generare le hero image del blog con higgsfield mcp, chiedi al tuo client AI di chiamare generate_image con un aspect ratio 1200×630, un brief MCSLA e il modello GPT Image 2. Salva l'URL restituito, ottimizza in WebP e carica nel CMS. End-to-end ci vogliono circa 90 secondi con l'MCP collegato: dal prompt alla WebP caricata su Sanity, per una singola hero, senza aprire nessun altro tab.
Ecco il workflow effettivo su questo blog. Scriviamo il prompt hero dentro la skill .claude/skills/blog-hero-image del post (una per post, versionata). Dentro Claude Code, mentre lavoriamo al post: "Genera una hero con diagramma di processo per questo post usando GPT Image 2, 1200×630, sfondo navy, tre box etichettati." Questo invoca generate_image, Higgsfield restituisce un URL hosted, il nostro script scripts/generate_image.py lo ridimensiona a WebP a qualità 85, e scripts/upload_hero_image.py lo carica su Sanity.
Una tipica chiamata allo strumento dentro una sessione Claude Code si presenta così:
Tool call: generate_image
model: "gpt-image-2"
prompt: "Process diagram, three labeled boxes left-to-right..."
aspect_ratio: "landscape_16_9"
quality: "high"Consiglio pratico: non chiedere 1200x630 direttamente. La maggior parte dei modelli preferisce termini di rapporto come landscape_16_9 e rifiuterà le specifiche esatte in pixel. Genera al rapporto più vicino, poi ritaglia il 5% finale per arrivare alle dimensioni esatte. Risparmierai un credito per ogni tentativo fallito.
Se vuoi avvolgere queste chiamate in uno script (generare dieci hero da un CSV di prompt, per esempio), un'implementazione Python leggera su GitHub replica le stesse chiamate fuori dalla conversazione. La usiamo per i backfill in batch.
Per riutilizzare lo stesso asset su più canali, la nostra automazione Cover Image Prompter nella community, che trasforma il contenuto del blog in brief per le hero image, gestisce la fase di scrittura del brief. Abbinala al Social Banner Generator e una singola hero generata via MCP diventa quattro varianti social senza ri-promptare.

generate_image via MCP.
Higgsfield MCP Può Generare Video Brevi per i Riassunti del Blog?
Tecnicamente sì. Onestamente, con qualche avvertenza. Il meccanismo è generate_video con Veo 3.1 o Seedance 2.0, 8-15 secondi, asincrono. La chiamata restituisce un job ID e sondaggi con get_generation_status fino a quando l'URL non è disponibile. Stiamo sperimentando questo per clip di riepilogo dei post, ma non lo stiamo ancora pubblicando su ogni articolo.
Due avvertenze oneste. Prima: la generazione video non è veloce. Veo 3.1 impiega 45-90 secondi per un clip da 8 secondi; Seedance 2.0 è più vicino ai 30 secondi. Pianifica una pausa caffè per ogni render. E se stai interrogando in un loop stretto, stai pagando solo per risposte processing vuote. Imposta un intervallo di polling di 5 secondi, non 1.
Seconda: il nostro CMS Sanity non ha ancora un tipo videoBlock nel body. È quello che arriverà nella nostra pipeline, non quello che è già disponibile. Per ora incorporiamo gli MP4 generati via MCP come tag HTML5 <video> dentro un blocco personalizzato. Non faremo finta che sia una soluzione con un clic oggi.
Il caso d'uso a cui stiamo lavorando: un'animazione di 12 secondi come riepilogo del post, con prompt "process diagram in motion" e lo stesso brief MCSLA della hero statica. Stessa palette di colori, stessa composizione, solo animata. Per il contesto più ampio sull'uso dell'IA nei workflow di produzione video, il nostro approfondimento copre il lato editoriale.
Se hai bisogno di accedere a modelli che l'MCP hosted non espone ancora (Sora 2, per esempio), il fork della community che aggiunge accesso a Sora 2 / Veo 3 vale un'occhiata. È un wrapper MCP self-hosted, quindi porti le tue chiavi API per i modelli che non sono nel catalogo Higgsfield.
Troubleshooting: 5 Insidie che Ti Costano 30 Minuti
I cinque problemi più comuni di Higgsfield MCP sono: token OAuth scaduto (ri-autentica dal pannello /mcp), server bloccato su "pending" (Claude Code riprova cinque volte con backoff esponenziale), flag di scope errato (--scope user vs --scope project), modello non trovato (errore di battitura nel nome), e video bloccato sul polling asincrono (chiama get_generation_status manualmente o riavvia). Ogni correzione richiede meno di due minuti una volta che sai cosa cercare.
Token OAuth Scaduto
Sintomo: gli strumenti appaiono in /mcp ma ogni chiamata restituisce "unauthorized." Soluzione: in Claude Code, esegui /mcp, seleziona Higgsfield, scegli "Re-authenticate." Il browser si riapre, effettui di nuovo l'accesso e sei a posto. I token hanno durata limitata (di solito qualche settimana) e non c'è nessun avviso preventivo.
Il Server Rimane su "Pending" per Sempre
Sintomo: claude mcp list mostra ⏳ accanto a higgsfield invece di ✔. Soluzione: Claude Code riprova HTTP/SSE con backoff esponenziale (1s → 2s → 4s → 8s → 16s) e si arrende dopo cinque tentativi. Esegui claude mcp restart higgsfield. Se rimane in pending, controlla https://status.higgsfield.ai. L'MCP hosted è occasionalmente degradato durante i rollout dei modelli.
Scope Errato (--scope user vs --scope project)
Sintomo: il server funziona in un repo ma non in un altro. Soluzione: --scope user scrive in ~/.claude/mcp.json (globale, tutti i progetti). --scope project scrive in .mcp.json nella directory corrente (tracciato in git, condiviso con il team). Se sei oltre i due minuti nell'installazione, è quasi sempre il flag di scope. Scegline uno e cancella l'altro.
Modello Non Trovato
Sintomo: Error: model "veo-3" not found. Soluzione: il nome del modello è veo-3.1, non veo-3. Esegui list_characters per vedere gli identificatori esatti del modello nei metadati della risposta, oppure consulta la tabella nel primo H2. I nomi di Higgsfield sono case-sensitive e contengono il numero di versione, quindi Soul e soul-v2 non sono la stessa stringa.
Video Bloccato sul Polling Asincrono
Sintomo: generate_video restituisce un job ID ma get_generation_status continua a restituire processing oltre i tre minuti. Soluzione: i job di Veo e Kling possono richiedere 90+ secondi, ma oltre i tre minuti il job è fallito silenziosamente o è bloccato in coda. Esegui claude mcp restart higgsfield e rilancia. Gli account del piano gratuito hanno priorità di coda più bassa, quindi gli utenti paganti incontrano questo problema meno spesso.
Se continui ad avere timeout MCP in CI, la Higgsfield CLI funziona headless ed è più adatta agli script. L'MCP richiede un round-trip OAuth interattivo; la CLI usa token API long-lived, che è quello che vuoi per le pipeline non conversazionali.
FAQ
Cos'è Higgsfield MCP?
Higgsfield MCP è un server Model Context Protocol hosted su https://mcp.higgsfield.ai/mcp che espone sette modelli di generazione di immagini e video (tra cui GPT Image 2, Soul V2, Veo 3.1, Kling 3.0 e Flux 2) a qualsiasi client AI compatibile con MCP. L'autenticazione avviene via OAuth con il tuo account Higgsfield; non servono chiavi API per il server hosted.
Higgsfield MCP È Gratuito?
Sì, c'è un piano gratuito da 150 crediti al mese, aggiornato a maggio 2026. Oltre quella soglia, i crediti prepagati costano circa 1 $ per 16 crediti, e le singole generazioni richiedono 2-60 crediti a seconda del modello e della durata. Un'immagine statica costa circa 2-10 crediti; un clip Veo da 8 secondi circa 60. I piani pagati di Higgsfield cambiano, quindi controlla la loro pagina di fatturazione per le fasce di prezzo aggiornate.
Come Installo Higgsfield MCP in Claude Code?
Esegui claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp nel terminale. Claude Code apre il browser per OAuth al primo utilizzo; accedi al tuo account Higgsfield, torna al terminale e verifica con claude mcp list o il comando /mcp dentro qualsiasi sessione Claude Code. L'intero flusso richiede ampiamente meno di un minuto su una connessione normale.
Higgsfield MCP Funziona con Codex o ChatGPT Desktop?
Con Codex CLI di OpenAI sì: parla il protocollo wire MCP standard, quindi la stessa configurazione mcp.json funziona lì. Con ChatGPT desktop no, a maggio 2026. OpenAI non ha ancora pubblicato il supporto MCP nell'app consumer ChatGPT. Se hai specificamente bisogno di Sora 2 o di altri modelli OpenAI che l'MCP Higgsfield hosted non espone, il fork unificato della community può colmare il divario.
Higgsfield MCP vs CLI: Quale Usare?
Usa l'MCP per la generazione conversazionale e in-chat dove il modello sceglie i parametri dal contesto. Questo si adatta alla maggior parte dei workflow di scrittura del blog e di iterazione del design. Usa la CLI per pipeline headless e scriptate, job CI o backfill in batch dove vuoi token di autenticazione long-lived invece di un flusso OAuth interattivo. Puoi anche avvolgere l'MCP come skill Claude per i pattern ripetuti.
Quali Modelli Supporta Higgsfield MCP?
Il server hosted espone attualmente sette modelli principali: GPT Image 2 e Nano Banana Pro per il lavoro sulle immagini in generale, Soul V2 per la coerenza dei personaggi, Flux 2 per l'output stilizzato, più Seedance 2.0, Veo 3.1 e Kling 3.0 per il video. Il catalogo completo di Higgsfield include oltre 30 modelli, e il roster dell'MCP hosted si espande nel tempo man mano che nuovi modelli arrivano sulla piattaforma.
Posso Eseguire Higgsfield MCP Headless in CI?
Non direttamente. L'MCP hosted richiede un round-trip OAuth interattivo alla prima autenticazione, che non funziona in un ambiente CI. Per CI usa la Higgsfield CLI (@higgsfield/cli), che utilizza token API long-lived che puoi memorizzare come segreto CI. L'MCP è per le sessioni interattive; la CLI è per le pipeline di automazione e i job di generazione batch.
Come Ottengo Coerenza dei Personaggi Tra le Generazioni?
Usa create_character con 3-5 immagini di riferimento del soggetto. Lo strumento restituisce un character ID dopo circa 3-5 minuti di addestramento. Usa quel ID nelle successive chiamate a generate_image con il modello Soul V2 e lo stesso volto apparirà in ogni generazione. Questo è il pattern principale per serie di blog, mascotte di prodotto e qualsiasi progetto che necessita di continuità visiva.
Higgsfield MCP Costa di Più che Chiamare Sora o Veo Direttamente?
Più o meno comparabile nella maggior parte dei casi. Higgsfield acquista capacità API all'ingrosso e la rivende come crediti, quindi i costi per generazione sono vicini a quelli dei provider sottostanti. Il vantaggio è la fatturazione consolidata, OAuth invece di una dozzina di chiavi API, e una UX conversazionale tramite MCP. Per script una tantum potresti risparmiare qualcosa andando diretto; per il lavoro creativo continuativo, Higgsfield è il percorso più semplice.
Higgsfield MCP È Gratuito da Usare con Claude Code?
Sì, il piano gratuito offre 150 crediti al mese senza costi, il che copre circa 15 immagini fisse con GPT Image 2 o due clip video con Veo 3.1. Claude Code stesso non addebita costi aggiuntivi per le chiamate agli strumenti MCP. Oltre la quota gratuita, i crediti prepagati costano circa 1 $ per 16 crediti. Per i team che generano hero image in volume, il piano pagato vale l'investimento; per i singoli sviluppatori, il piano gratuito copre un utilizzo leggero o moderato.
Cosa Si Può Generare con Higgsfield MCP in Claude Code?
Il server espone la generazione di immagini (scatti singoli, servizi fotografici per prodotti, illustrazioni stilizzate), la generazione di video (clip cinematografici fino a 15 secondi con Veo 3.1 o Kling 3.0) e l'addestramento di personaggi per la coerenza visiva. In pratica, i team lo usano per hero image del blog, OG card, mockup di prodotti e brevi animazioni di riepilogo, tutto direttamente dal workflow di Claude Code senza dover aprire uno strumento creativo separato.
Se le funzionalità AI sono nella tua roadmap, è la nostra specialità: il team di integrazione AI di Techsy porta i sistemi LLM dal prototipo alla produzione.
Conclusione
Questo è il tour completo: un'installazione con una riga per Claude Code, snippet JSON per ogni altro client MCP principale, la ricetta di prompting MCSLA, il workflow Soul Character per la coerenza e le cinque insidie che ti faranno perdere un pomeriggio se non le conosci. Se stai ancora scegliendo il client AI, il nostro confronto Claude Code vs Cursor vs Copilot copre il panorama generale.
Se preferisci che siamo noi a integrare Higgsfield MCP nella pipeline di contenuti del tuo team insieme a Sanity o al tuo CMS, richiedi una consulenza gratuita.