Gestisci una campagna pubblicitaria end-to-end da Claude Code con MCP
Non apri un editor. Dici a Claude Code cosa serve alla campagna, lui chiama gli strumenti NOLGIA e i creativi finiscono in un progetto che puoi aprire sul sito.
- 8 min di lettura
- Aggiornato
Tradotto automaticamente dall'inglese. Leggi l'originale
Puoi gestire una piccola campagna pubblicitaria da Claude Code collegandolo al server MCP di NOLGIA e chiedendo la campagna in parole semplici. Claude Code crea un progetto, apre l'immagine hero che hai approvato, genera ogni creatività da quell'hero con lo strumento da immagine a immagine, renderizza ogni creatività nelle dimensioni che indichi e archivia i risultati nel progetto. Esamini le immagini nella pagina del progetto o nella tua Libreria, e nulla nel flusso richiede di aprire un compositore.
Tutto ciò che segue è una sessione reale su un prodotto fittizio: cuffie nero opaco con un anello luminoso arancione. Le chiamate agli strumenti sono riportate come le ha fatte Claude Code, le immagini sono quelle restituite e i prezzi provengono dal catalogo live al caricamento di questa pagina. La configurazione della connessione è trattata in Genera da Claude Code o Cursor con MCP; questa guida inizia dopo quella fase.
Cosa può andare storto, e la correzione
| Errore | Perché è dannoso | Correggi |
|---|---|---|
| Chiedere tutte e sei le immagini in una sola riga | L'agente genera prima che il prodotto sia concordato, e paghi per sei immagini sbagliate | Approva prima l'hero, poi dirama |
| Descrivere di nuovo il prodotto per ogni creatività | Ogni descrizione devia e il prodotto cambia forma | Crea i materiali dall'hero approvato usando image to image, così il riferimento viene mantenuto |
| Saltare il progetto | Sei asset finiscono sparsi nella Libreria senza nulla che li leghi | Crea prima il progetto e passa il suo id a ogni generazione |
| Leggere il saldo del wallet come ricevuta | Su un account usato da altre persone, il saldo cambia per motivi esterni alla sessione, quindi un prezzo dedotto può essere molto più alto | Dai all'agente il limite e il costo per immagine in anticipo, e leggi il registro, non il saldo |
| Riprovare una chiamata scaduta | La prima chiamata di solito è finita sul server; un retry cieco genera una seconda immagine | Un retry della stessa richiesta riceve un 409 entro cinque minuti e non viene fatturato due volte; trova il risultato con lo strumento assets |
Prima di iniziare
- Claude Code collegato a NOLGIA con un Personal Access Token, come indicato nella guida MCP.
- Crediti nel tuo saldo di ricarica: un token spende solo i crediti di ricarica.
- Un'immagine hero approvata del prodotto nella tua Libreria. La nostra è un prodotto fittizio, creato con GPT Image 2.5 Flare.
- Un brief breve con il modello, le dimensioni e il limite massimo. Il nostro: tre creativi, 1:1 e 9:16, al massimo ottanta crediti, con la tariffa per immagine indicata.

Brief per Claude Code
Un solo messaggio contiene tutto il lavoro: il prodotto, l'asset id dell'hero, il modello, i tre creativi, le due dimensioni, la regola di archiviazione, il limite massimo con la tariffa per immagine e quante chiamate possono essere eseguite contemporaneamente. Abbiamo anche indicato quali strumenti usare e di non toccare l'elenco dei modelli, perché stavamo specificando noi il modello.
You are running a small ad campaign for me on NOLGIA through the nolgia MCP tools. Work only with those tools; do not run shell commands and do not call nolgia_list_models (I am telling you the model).
The product is fictional: matte black over-ear headphones with a thin glowing orange light ring on each ear cup. The approved hero image already exists in my library as asset 74391fde-9c67-44aa-a298-aa090f8d7949.
Do this, in order, and tell me each tool call you make and what came back (ids, sizes, credits):
1. Create a project named "Orange Ring campaign 2" with a one-line description.
2. Open the hero asset with nolgia_get_asset so you know what it looks like, and file it into the project.
3. Make three creatives from the hero with nolgia_image_to_image on the model gpt-image-2.5-flare, using the hero as the reference image so the product stays the same, each in two sizes, aspect ratio 1:1 and 9:16, so six images in total, every one filed into the project by passing the project id:
Creative A "Morning desk": the headphones on a worn oak desk in a shaft of morning window light, dust drifting in the beam, soft shadows, premium ad look.
Creative B "Night rain": the headphones in close-up with fine rain droplets on the matte shells and warm amber streetlight reflections, soft city bokeh behind, music-video look.
Creative C "Silhouette": a young dancer in a long dark coat seen from behind wearing the headphones, under one warm practical lamp in a dark rehearsal room with haze, the orange rings glowing, fashion-film look, no face visible.
4. Spend at most eighty credits in total; each image on this model bills eight credits. Run at most three image calls at once. If a call fails, report it and continue with the next; do not retry more than once.
5. Finish with a short table: creative, size, asset id, and the project id.Suggerimento:Indica il modello e il riferimento. nolgia_list_models restituisce l'intero catalogo, molto più di quanto serva in una sessione. Indica l'id del modello nel brief. L'hero viene usato come immagine di riferimento in ogni chiamata da immagine a immagine, ed è ciò che mantiene il prodotto coerente tra i creativi.
La sessione, parola per parola
Claude Code ha caricato i quattro strumenti necessari, ha creato il progetto, ha aperto l'hero e lo ha archiviato, poi ha generato le sei immagini in tre batch, mai più di tre chiamate contemporaneamente, e ha indicato la spesa corrente dopo ogni batch. Gli URL firmati sono abbreviati, i risultati JSON sono stampati come righe chiave e valore, e l'apertura condivisa da ogni prompt è stampata una sola volta; nient'altro viene modificato.
CALL ToolSearch
query: select:mcp__nolgia__nolgia_create_project,mcp__nolgia__nolgia_get_asset,mcp__nolgia__nolgia_add_project_assets,mcp__nolgia__nolgia_image_to_image
max_results: 4
CALL nolgia_create_project
name: Orange Ring campaign 2
description: Ad creatives for matte black over-ear headphones with glowing orange light rings, built from the approved hero image.
CALL nolgia_get_asset
asset_id: 74391fde-9c67-44aa-a298-aa090f8d7949
RESULT id: b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d, name: Orange Ring campaign 2, asset_count: 0
RESULT status: ready, kind: image, name: Premium product photograph of fictional, asset_id: 74391fde-..., mime_type: image/png, model: gpt-image-2.5-flare, url: (signed url)
CALL nolgia_add_project_assets
project_id: b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d
asset_ids: 74391fde-9c67-44aa-a298-aa090f8d7949
RESULT added: trueCALL nolgia_image_to_image
model: gpt-image-2.5-flare
aspect_ratio: 1:1
project_id: b73d2c7d-...
image_url: (signed url of the hero)
prompt: Keep the exact same headphones from the reference image: matte black over-ear headphones with a thin glowing orange light ring on each ear cup, identical shape and details. Scene: the headphones resting on a worn oak desk in a shaft of morning window light, fine dust drifting visibly in the light beam, soft shadows, cool-to-warm morning tones, shallow depth of field, premium advertising product photography, photoreal. No text, no letters, no logos, no brand names, no watermark.
CALL nolgia_image_to_image
(the same, with "vertical composition" added) aspect_ratio: 9:16
RESULT status: ready, kind: image, asset_id: fa93b7aa-cba8-427f-8920-38281358a39c
RESULT status: ready, kind: image, asset_id: 96429e72-73a9-4e00-b7c5-297cd426883a
TEXT: Sixteen credits spent so far. Next I'll run Creative B in both sizes and Creative C at 1:1, which is three calls at once.
CALL nolgia_image_to_image
model: gpt-image-2.5-flare, aspect_ratio: 1:1, project_id: b73d2c7d-..., image_url: (signed url of the hero)
prompt: Keep the exact same headphones from the reference image: (as above). Scene: night close-up of the headphones with fine rain droplets beaded on the matte shells, warm amber streetlight reflections gliding across the surfaces, the orange rings glowing, soft out-of-focus city bokeh behind, moody cinematic music-video look, photoreal. No text, no letters, no logos, no brand names, no watermark.
CALL nolgia_image_to_image
(the same, with "vertical composition" added) aspect_ratio: 9:16
CALL nolgia_image_to_image
model: gpt-image-2.5-flare, aspect_ratio: 1:1, project_id: b73d2c7d-..., image_url: (signed url of the hero)
prompt: Keep the exact same headphones from the reference image: (as above). Scene: a young dancer in a long dark coat seen from behind, wearing the headphones, standing in a dark rehearsal room filled with light haze, lit by a single warm practical lamp, the orange rings glowing clearly, face not visible, fashion-film look, cinematic, photoreal. No text, no letters, no logos, no brand names, no watermark.
RESULT status: ready, kind: image, asset_id: 067eb5f3-76fd-4bb7-a513-44936650ed79
RESULT status: ready, kind: image, asset_id: 24b9247e-ce62-41fc-869b-a954c814e599
RESULT status: ready, kind: image, asset_id: 38521354-d302-4b3f-9081-3fe3ad253c52
TEXT: Forty credits spent so far. One image left.
CALL nolgia_image_to_image
(Creative C again, with "vertical full-figure composition" added) aspect_ratio: 9:16
RESULT status: ready, kind: image, asset_id: e34a8f78-1872-4d3b-b6a4-dd9d4ab1e9d9L'esecuzione è stata pulita: sei immagini, quarantotto crediti, entro gli ottanta impostati, senza interruzioni, timeout o tentativi di ripetizione. Poiché il brief indicava la tariffa per immagine, ha contato la propria spesa invece di leggere il portafoglio.
All six images were made and filed into the project, for forty-eight credits in total (under your eighty limit). No calls failed and none were retried.
Tool calls, in order
1. nolgia_create_project with the name "Orange Ring campaign 2" and the description "Ad creatives for matte black over-ear headphones with glowing orange light rings, built from the approved hero image." It returned project b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d, with 0 assets.
2. nolgia_get_asset on 74391fde-9c67-44aa-a298-aa090f8d7949 returned a ready PNG image made with gpt-image-2.5-flare. I didn't see the picture itself, only its details and the prompt it was made from. The prompt describes the headphones on a worn oak desk by a window in late-afternoon daylight, with a long warm shadow and shallow depth of field. I used its signed link as the reference image in every call below.
3. nolgia_add_project_assets filed the hero into the project and returned added: true.
4. nolgia_image_to_image ran six times on gpt-image-2.5-flare, with the hero as the reference and the project id passed each time. Every prompt starts by telling the model to keep the exact same headphones, and every one includes "no text, no logos, no watermark":
- First batch (2 calls at once): Creative A at 1:1 and 9:16. Both came back ready, eight credits each, sixteen so far.
- Second batch (3 calls at once): Creative B at 1:1 and 9:16, and Creative C at 1:1. All came back ready, eight credits each, forty so far.
- Third batch (1 call): Creative C at 9:16. It came back ready for eight credits, forty-eight in total.
Results
Creative | Size | Asset id | Project id
A "Morning desk" | 1:1 | fa93b7aa-cba8-427f-8920-38281358a39c | b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d
A "Morning desk" | 9:16 | 96429e72-73a9-4e00-b7c5-297cd426883a | b73d2c7d-...
B "Night rain" | 1:1 | 067eb5f3-76fd-4bb7-a513-44936650ed79 | b73d2c7d-...
B "Night rain" | 9:16 | 24b9247e-ce62-41fc-869b-a954c814e599 | b73d2c7d-...
C "Silhouette" | 1:1 | 38521354-d302-4b3f-9081-3fe3ad253c52 | b73d2c7d-...
C "Silhouette" | 9:16 | e34a8f78-1872-4d3b-b6a4-dd9d4ab1e9d9 | b73d2c7d-...
The project now holds 7 assets: the hero plus the six new images. I haven't looked at any of the new images. Before you use them, check that the headphones match the hero and that no face shows in the Silhouette images.Non ha mai visto le immagini, solo i loro dettagli, motivo per cui le sue ultime righe ti chiedono di verificarle: apri il progetto e guarda ogni immagine a grandezza naturale. La riga "No text, no letters, no logos, no brand names, no watermark" in ogni prompt è stata aggiunta da Claude Code; il brief non la richiedeva. Se vuoi un'insegna o il tuo logo in una creatività, nominalo nel brief o allega l'immagine esatta del logo, e rigenera se il testo risulta illeggibile.
La campagna
Sei immagini, tutte derivate dall'hero, tutte su GPT Image 2.5 Flare, ciascuna fatturata al prezzo del modello. Il prodotto è lo stesso oggetto in ogni immagine perché l'hero è stato il riferimento in ogni chiamata.






Dove si trova sul sito
Apri Progetti e il progetto della campagna. L'hero e i sei creativi si trovano nei suoi media, e gli slot Cast, Location e Brand kit del progetto sono pronti se il prossimo round richiede un performer ricorrente, un luogo o la tua palette e logo. Da qui puoi scaricare il set o aprire qualsiasi immagine in Studio.

La stessa sessione può eseguire i preset della campagna sulla pagina Campagne con nolgia_run_preset: poster in quattro formati con le tue parole impostate come testo reale, pacchetti di annunci statici, cartelloni pubblicitari e film di lancio. Siamo rimasti sugli strumenti di immagine raw qui, così la trascrizione mostra ogni parametro.
Tre modi per eseguirlo
| Percorso | Come | Ideale quando |
|---|---|---|
| Più veloce | Un preset per formato con nolgia_run_preset da Claude Code, o sul sito da Campagne | Vuoi layout collaudati e testo reale sui poster |
| Senza intervento manuale | Dai istruzioni all'NOLGIA Agent nella sua chat; lavora sui formati e archivia i file | Non sei al terminale |
| Massimo controllo | Claude Code con gli strumenti di immagine raw, come in questa guida | Vuoi dirigere ogni creatività e mantenere il riferimento |
Cosa resta fuori dalla sessione
- Pubblicazione. NOLGIA non pubblica su piattaforme pubblicitarie né pianifica. Scarichi il set e lo carichi dove la campagna è attiva.
- Testo sull'immagine. Gli strumenti di immagine raw non impostano testo reale; i preset per poster sì.
- Creatività video. La stessa sessione può chiamare nolgia_text_to_video e nolgia_image_to_video; questa guida si è concentrata sulle immagini statiche.
- Un prezzo nel risultato. Un risultato di immagine restituisce l'asset, non i crediti che è costato. Il registro sulla tua pagina di fatturazione mostra l'addebito per immagine.
- ChatGPT. Segnato come Prossimamente sulla pagina MCP; questa guida è solo per Claude Code.
Quanto costa
La lettura è gratuita: elencare i modelli, creare un progetto, aprire un asset e archiviare gli asset non costa nulla. Ogni immagine viene fatturata al tasso del suo modello. Tariffe live per il modello in questa guida e i preset che la pagina Campagne esegue:
- Static ad formats
8 credits per ad, 32 for four versions, 21 each at 2K
Richiede under 2 min
- Social and poster pack
Priced on the review card before it runs
Richiede 3 to 8 minutes
GPT Image 2.5 FlareEvery plan
Per image
Native 8 crediti · 2K 21 crediti · 4K 58 crediti
Letto in tempo reale dal catalogo quando la pagina si carica. Ogni prezzo viene mostrato prima che tu generi. Vedi tutte le tariffe.
Prova tu stesso
L'hero e il brief
- Hero delle cuffie, 2048x2048 WebPImmagine WebP · 2048x2048 · 233 KBScarica
Checklist
- Token connesso; nolgia_get_account risponde.
- Hero approvato prima di qualsiasi creativo; il suo id asset nel brief.
- Progetto creato; il suo id in ogni generazione.
- Modello specificato nel brief; l'elenco dei modelli lasciato invariato.
- Soglia massima e tariffa per immagine nel brief; gli strumenti jobs consentiti.
- Un timeout viene controllato, non ritentato a caso.
- Apri il progetto sul sito e guarda ogni immagine a dimensione intera.
Domande e risposte
- Claude Code può creare tutta la campagna in un colpo solo?
- Può concatenare le chiamate, ma approva prima l'hero: ogni creativo viene realizzato da esso, quindi un hero sbagliato significa sei immagini sbagliate.
- Quanto costa la sessione?
- Solo le generazioni. Creare il progetto, aprire e archiviare gli asset sono gratuiti; ogni immagine viene fatturata al prezzo pubblicato del modello. Il risultato di una chiamata immagine non include il prezzo, quindi controlla il registro.
- Una chiamata è scaduta. Mi è stato addebitato due volte?
- No. La stessa richiesta entro cinque minuti riceve un 409 che identifica il lavoro esistente, e solo il primo viene fatturato. Trova l'immagine con gli strumenti jobs o assets.
- Può inserire il mio titolo sulla creatività?
- Non con gli strumenti immagine raw. Il pacchetto Social e poster e i preset per annunci statici impostano le tue parole come testo reale; esegui li con nolgia_run_preset o dalla pagina Campagne.
- Funziona da ChatGPT?
- Non ancora. ChatGPT è contrassegnato come Prossimamente sulla pagina MCP. Claude Code e Cursor funzionano oggi.
Esegui la tua prima campagna dal terminale
Connetti Claude CodeGuide correlate
MCP
Genera da Claude Code o Cursor con MCP
Collega NOLGIA a Claude Code o Cursor con un solo token e un comando o una voce di configurazione, poi chiedi immagini, video e audio in parole semplici.
· 5 min di lettura
Agent
Il ricettario di NOLGIA Agent: cosa dire e cosa succede dopo
Dieci messaggi da inviare a NOLGIA Agent, cosa fa con ciascuno e il preset sottostante, dalle foto prodotto e un set per le inserzioni a un punteggio di hook e un montaggio valutato.
· 6 min di lettura
Video di prodotto
Video di prodotto senza riprese: scegli il formato
Sette formati per video di prodotto, dal tutorial allo unboxing, fino alle sole mani, ognuno con un esempio reale, a cosa serve e quando sceglierlo.
· 8 min di lettura




