Guide / MCP

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

L'heroCreativitàProgetto

Cosa crei, in ordine. Tocca un elemento per andare al suo passaggio.

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

ErrorePerché è dannosoCorreggi
Chiedere tutte e sei le immagini in una sola rigaL'agente genera prima che il prodotto sia concordato, e paghi per sei immagini sbagliateApprova prima l'hero, poi dirama
Descrivere di nuovo il prodotto per ogni creativitàOgni descrizione devia e il prodotto cambia formaCrea i materiali dall'hero approvato usando image to image, così il riferimento viene mantenuto
Saltare il progettoSei asset finiscono sparsi nella Libreria senza nulla che li leghiCrea prima il progetto e passa il suo id a ogni generazione
Leggere il saldo del wallet come ricevutaSu un account usato da altre persone, il saldo cambia per motivi esterni alla sessione, quindi un prezzo dedotto può essere molto più altoDai all'agente il limite e il costo per immagine in anticipo, e leggi il registro, non il saldo
Riprovare una chiamata scadutaLa prima chiamata di solito è finita sul server; un retry cieco genera una seconda immagineUn 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.
Cuffie over-ear nere opache con un sottile anello arancione luminoso su ogni padiglione, appoggiate su una scrivania in legno di rovere consumato, illuminate dalla luce del tardo pomeriggio.
L'hero approvato. Realizzato con GPT Image 2.5 Flare prima della sessione. Ogni creativo seguente è stato realizzato a partire da questo.

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.

Il brief, come inviato
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.

Strumenti, progetto e hero (argomenti e risultati come righe chiave e valore)
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: true
Le sei immagini in tre batch (cifre dei crediti scritte per esteso)
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: 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-dd9d4ab1e9d9

L'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.

Il messaggio finale (cifre dei crediti scritte per esteso)
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.

Le cuffie su una scrivania di quercia in un raggio di luce della finestra mattutina, polvere che fluttua nel fascio, formato quadrato.
Creatività A, 1:1. Scrivania al mattino.
Le cuffie su una scrivania di quercia in un raggio di luce della finestra mattutina, polvere che fluttua nel fascio, formato verticale.
Creatività A, 9:16.
Primo piano delle cuffie appannate dalla pioggia, riflessi di lampioni ambrati e bokeh della città sullo sfondo, formato quadrato.
Creatività B, 1:1. Pioggia notturna, luce calda del lampione nelle gocce.
Primo piano delle cuffie appannate dalla pioggia, riflessi di lampioni ambrati e bokeh della città sullo sfondo, formato verticale.
Creativo B, 9:16.
Un giovane ballerino visto di spalle, con un lungo cappotto scuro e le cuffie, in una sala prove nebbiosa, una lampada calda, gli anelli arancioni luminosi, formato quadrato.
Creativo C, 1:1. Silhouette sotto una lampada calda.
Un giovane ballerino visto di spalle, con un lungo cappotto scuro e le cuffie, in una sala prove nebbiosa, una lampada calda, gli anelli arancioni luminosi, formato verticale.
Creativo C, 9:16.

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 griglia dei media del Progetto Orange Ring campaign 2: l'hero e i sei creativi, quadrati e verticali, con le loro dimensioni
I media del progetto. Sette asset, archiviati dalla sessione.

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

PercorsoComeIdeale quando
Più veloceUn preset per formato con nolgia_run_preset da Claude Code, o sul sito da CampagneVuoi layout collaudati e testo reale sui poster
Senza intervento manualeDai istruzioni all'NOLGIA Agent nella sua chat; lavora sui formati e archivia i fileNon sei al terminale
Massimo controlloClaude Code con gli strumenti di immagine raw, come in questa guidaVuoi 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:

  • 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
Carica l'hero nella tua Libreria, inserisci il suo id asset nel brief sopra al posto del nostro e invia il brief a Claude Code con NOLGIA connesso. Consenti anche gli strumenti jobs. I tuoi creativi saranno diversi dai nostri; il prodotto non dovrebbe esserlo, perché l'hero è il riferimento in ogni chiamata.

Checklist

  1. Token connesso; nolgia_get_account risponde.
  2. Hero approvato prima di qualsiasi creativo; il suo id asset nel brief.
  3. Progetto creato; il suo id in ogni generazione.
  4. Modello specificato nel brief; l'elenco dei modelli lasciato invariato.
  5. Soglia massima e tariffa per immagine nel brief; gli strumenti jobs consentiti.
  6. Un timeout viene controllato, non ritentato a caso.
  7. 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 Code

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

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