Come collegare Higgsfield a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Higgsfield, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Higgsfield + ChatGPT

Fai creare alla tua AI immagini e video su Higgsfield con la tua API key: ritratti SOUL, immagini di prodotto con Marketing Studio e Ads Studio, video con Seedance, Kling 3.0 e Cinema Studio e oltre 80 altri modelli, con stima del prezzo prima di ogni generazione, controllo dello stato e annullamento.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

HIGGSFIELD_API_KEY_ID, HIGGSFIELD_API_KEY_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti servono un account Higgsfield Console con credito API e una API key. Ogni generazione viene addebitata su quel saldo.

1. Accedi a https://console.higgsfield.ai e ricarica il saldo API (pay as you go). Senza credito le generazioni vengono rifiutate con 403.
2. Nella Console apri API keys e crea una chiave. È composta da due parti: una key ID e un secret. Il secret viene mostrato una sola volta, quindi copialo subito.
3. Incolla la key ID in HIGGSFIELD_API_KEY_ID e il secret in HIGGSFIELD_API_KEY_SECRET, ciascuno da solo, senza due punti e senza la parola Key. Il connettore li unisce nell'header Authorization: Key <id>:<secret> e lo invia solo ad api.higgsfield.ai.
4. Installa il connettore. L'installazione verifica la chiave elencando gli stili SOUL, e non costa nulla; puoi ripetere lo stesso controllo quando vuoi con higgsfield_list_soul_styles.

Cosa crea: immagini con SOUL V2 (ritratti fotorealistici, moda ed editoriale, anche in uno stile SOUL o con uno dei tuoi personaggi Soul ID addestrati), Marketing Studio (immagini di campagna e di prodotto, modifiche con fino a 16 immagini di riferimento o annunci da un preset) e Ads Studio (un brief e foto di prodotto facoltative diventano da 1 a 8 concept pubblicitari). Video con Seedance 2.5 (da testo, da un'immagine o da media di riferimento), Kling 3.0 (livello Standard, Pro o 4K, con audio nativo) e Cinema Studio 4.0. Qualsiasi altro degli oltre 80 modelli, come Wan, MiniMax, Hailuo, Grok Imagine, Recraft o Ideogram, gira con higgsfield_generate tramite il suo endpoint ID indicato nella pagina del modello su docs.higgsfield.ai.

Cosa legge, gratis: stato e risultato di una richiesta, stime di prezzo, gli stili SOUL, i preset di Marketing Studio e i tuoi personaggi Soul ID con il loro stato di addestramento.

Ogni generazione consuma crediti, quindi l'AI stima prima e chiede: prima di higgsfield_soul_image, higgsfield_marketing_studio_image, higgsfield_ads_studio, higgsfield_seedance_text_to_video, higgsfield_seedance_image_to_video, higgsfield_seedance_reference_to_video, higgsfield_kling_text_to_video, higgsfield_kling_image_to_video, higgsfield_cinema_studio_video o higgsfield_generate, l'AI esegue higgsfield_estimate_cost con lo stesso modello e lo stesso input, ti dice quale modello userà e quanto costa, e aspetta il tuo sì. Non avvia mai più generazioni in ciclo senza chiedere. Il video costa molto più delle immagini e sale con durata, risoluzione e livello; quattro immagini in un solo lotto costano circa quattro volte una. Le richieste fallite e quelle respinte dalla moderazione (nsfw) non vengono addebitate. Anche prima di higgsfield_cancel_request l'AI chiede conferma.

Disattivato all'installazione: niente. Ogni strumento a pagamento passa dalla stima del prezzo e dalla tua conferma, e l'annullamento funziona solo sulle richieste non ancora avviate.

Dalla richiesta al risultato: una generazione risponde subito con un request_id e lo stato queued. L'AI controlla higgsfield_get_request_status ogni 5-10 secondi; le immagini richiedono secondi, i video di solito minuti. Ricevi link alle immagini, al video o all'audio, non file. I link restano disponibili per almeno sette giorni, quindi scarica ciò che vuoi tenere. Una richiesta si può annullare solo finché è in coda, e i crediti vengono rimborsati; una volta in lavorazione, viene addebitata quando termina. Dopo un timeout, un nuovo tentativo con lo stesso idempotency_key restituisce la richiesta originale invece di una seconda, addebitata.

Gli input sono link: immagini, video e audio di riferimento entrano come URL HTTPS pubblici. Il connettore non può caricare file dal tuo computer.

Limiti: il limite principale è la concorrenza, cioè il numero di richieste in coda o in esecuzione nello stesso momento (spesso 4). Un 400 che dice che è stato raggiunto il numero massimo di richieste simultanee significa aspettare che una finisca. I limiti del tuo account sono indicati nella Console.

Errori comuni: 401 Invalid credentials significa che key ID o secret sono sbagliati, invertiti o revocati: crea una nuova chiave nella Console. 403 significa credito insufficiente. 404 significa che l'id della richiesta non esiste o appartiene a un altro account, oppure che il modello non è disponibile per il tuo account. 422 significa che un campo di input manca, è scritto male o è fuori intervallo, e l'errore lo indica. 423 o 503 significa che il modello è temporaneamente bloccato o disattivato: riprova più tardi o scegli un altro modello.

Il connettore non carica file, non riceve webhook, non addestra personaggi Soul ID, non usa la Agent API e non vede i progetti e la cronologia della web app di Higgsfield.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Higgsfield.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Crea con SOUL un ritratto fotorealistico di una donna in completo di lino su una terrazza al tramonto. Dimmi il prezzo prima di partire."
• "Ecco la foto della nostra nuova scarpa da corsa: https://example.com/scarpa.jpg. Trasformala in 4 concept pubblicitari per una campagna Instagram."
• "Fai un breve video con Kling 3.0 Pro di un barista che versa latte art al rallentatore. Quanto costa?"
• "Anima questa foto prodotto in un breve video con Seedance: https://example.com/bottiglia.jpg. Mostrami prima la stima."
• "Il mio ultimo video è pronto? Mandami il link così lo scarico."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse