Guides / MCP

Gérer une campagne publicitaire de bout en bout depuis Claude Code avec MCP

Vous n'ouvrez pas de composeur. Vous indiquez à Claude Code les besoins de la campagne, il appelle les outils NOLGIA, et les créatifs se retrouvent dans un projet que vous pouvez ouvrir sur le site.

  • 8 min de lecture
  • Mis à jour

Traduit automatiquement de l'anglais. Lire l'original

Le visuel principalCréationsProjet

Ce que vous créez, dans l'ordre. Touchez-en un pour aller à son étape.

Vous lancez une petite campagne publicitaire depuis Claude Code en le connectant au serveur MCP de NOLGIA et en demandant la campagne en langage naturel. Claude Code crée un projet, ouvre l’image principale que vous avez approuvée, génère chaque création à partir de cette image principale avec l’outil image to image, rend chaque création dans les formats que vous indiquez, et range les résultats dans le projet. Vous examinez les images sur la page du projet ou dans votre Bibliothèque, et rien dans le processus ne nécessite d’ouvrir un compositeur.

Tout ce qui suit est une session réelle sur un produit fictif : un casque noir mat avec un anneau lumineux orange. Les appels d’outils sont affichés tels que Claude Code les a effectués, les images sont celles qui ont été générées, et les prix proviennent du catalogue en direct au moment du chargement de cette page. La configuration de la connexion est décrite dans Générer depuis Claude Code ou Cursor avec MCP ; ce guide commence après cette étape.

Ce qui ne va pas, et la correction

ErreurPourquoi c’est problématiqueCorriger
Demander les six images en une seule ligneL’agent génère avant que le produit ne soit validé, et vous payez pour six images erronéesApprouvez d’abord l’image principale, puis déployez
Décrire à nouveau le produit pour chaque créationChaque description dérive et le produit change de formeCréez les visuels à partir du visuel principal approuvé grâce à la fonction image vers image, afin que la référence soit conservée
Ignorer le projetSix ressources se retrouvent dispersées dans la Bibliothèque, sans lien entre ellesCréez d'abord le projet et passez son id à chaque génération
Lire le solde du portefeuille comme un reçuSur un compte utilisé par plusieurs personnes, le solde évolue pour des raisons extérieures à la session, ce qui peut rendre le prix déduit plusieurs fois trop élevéIndiquez d'emblée à l'agent le plafond et le tarif par image, et consultez le registre, pas le solde
Réessayer un appel qui a expiréLe premier appel s'est généralement terminé sur le serveur ; une nouvelle tentative aveugle génère une seconde imageUne nouvelle tentative de la même requête renvoie une erreur 409 dans les cinq minutes et n'est pas facturée deux fois ; retrouvez le résultat avec l'outil assets

Avant de commencer

  • Claude Code connecté à NOLGIA avec un Personal Access Token, selon le guide MCP.
  • Des crédits dans votre solde de recharge : un token utilise uniquement les crédits de recharge.
  • Une image principale approuvée du produit dans votre Bibliothèque. La nôtre est un produit fictif, créé avec GPT Image 2.5 Flare.
  • Un brief court avec le modèle, les formats et le plafond. Le nôtre : trois créatifs, 1:1 et 9:16, au maximum quatre-vingts crédits, avec le tarif par image indiqué.
Casque supra-auriculaire noir mat avec une fine bague lumineuse orange sur chaque oreillette, posé sur un bureau en chêne usé sous la lumière de fin d'après-midi.
Le visuel principal approuvé. Créé avec GPT Image 2.5 Flare avant la session. Chaque créatif ci-dessous a été réalisé à partir de celui-ci.

Brief de Claude Code

Un seul message porte toute la tâche : le produit, l'identifiant de l'asset du visuel principal, le modèle, les trois créatifs, les deux formats, la règle de classement, le plafond avec le tarif par image, et le nombre d'appels pouvant s'exécuter simultanément. Nous lui avons également indiqué quels outils utiliser et de ne pas toucher à la liste des modèles, car nous nommions le modèle nous-mêmes.

Le brief, tel qu'envoyé
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.

Astuce :Nommer le modèle et la référence. nolgia_list_models renvoie tout le catalogue, bien plus que ce dont une session a besoin. Indiquez l'identifiant du modèle dans le brief. Le visuel principal sert d'image de référence pour chaque appel image vers image, ce qui garantit la cohérence du produit entre les créatifs.

La session, mot pour mot

Claude Code a chargé les quatre outils nécessaires, a créé le projet, a ouvert le visuel principal et l'a archivé, puis a généré les six images en trois lots, sans jamais dépasser trois appels simultanés, et a indiqué ses dépenses en cours après chaque lot. Les URL signées sont raccourcies, les résultats JSON sont affichés sous forme de lignes clé et valeur, et l'ouverture commune à chaque prompt est imprimée une seule fois ; rien d'autre n'est modifié.

Outils, projet et visuel principal (arguments et résultats sous forme de lignes clé et valeur)
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
Les six images en trois lots (chiffres de crédits en toutes lettres)
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'exécution s'est déroulée sans erreur : six images, quarante-huit crédits, dans la limite des quatre-vingts fixés, sans arrêt, sans délai d'expiration et sans nouvelle tentative. Comme le brief indiquait le coût par image, il a calculé ses propres dépenses au lieu de lire le portefeuille.

Son message de clôture (chiffres de crédits en toutes lettres)
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.

Il n'a jamais vu les images, seulement leurs détails, c'est pourquoi ses dernières lignes vous demandent de les vérifier : ouvrez le projet et regardez chaque image en taille réelle. La ligne « No text, no letters, no logos, no brand names, no watermark » dans chaque prompt était une addition propre à Claude Code ; le brief ne la demandait pas. Si vous souhaitez un panneau ou votre logo dans une création, nommez-le dans le brief ou joignez l'image exacte du logo, et régénérez si le lettrage revient illisible.

La campagne

Six images, toutes issues du même visuel principal, toutes générées avec GPT Image 2.5 Flare, chacune facturée au tarif du modèle. Le produit est le même objet sur chaque image car le visuel principal servait de référence pour chaque appel.

Le casque audio sur un bureau en chêne dans un rayon de lumière du matin provenant d'une fenêtre, poussière flottant dans le faisceau, format carré.
Création A, 1:1. Bureau du matin.
Le casque audio sur un bureau en chêne dans un rayon de lumière du matin provenant d'une fenêtre, poussière flottant dans le faisceau, format vertical.
Création A, 9:16.
Gros plan du casque audio couvert de gouttes de pluie, reflets de lampadaires ambrés et flou urbain en arrière-plan, format carré.
Création B, 1:1. Pluie nocturne, lumière chaude des lampadaires dans les gouttes.
Gros plan du casque audio couvert de gouttes de pluie, reflets de lampadaires ambrés et flou urbain en arrière-plan, format vertical.
Créatif B, 9:16.
Jeune danseuse vue de dos, portant un long manteau sombre et le casque, dans une salle de répétation brumeuse, une lampe chaude, les anneaux orange lumineux, format carré.
Créatif C, 1:1. Silhouette sous une lampe chaude.
Jeune danseuse vue de dos, portant un long manteau sombre et le casque, dans une salle de répétation brumeuse, une lampe chaude, les anneaux orange lumineux, format vertical.
Créatif C, 9:16.

Où cela se trouve sur le site

Ouvrez Projets et le projet de la campagne. Le visuel principal et les six créatifs se trouvent dans ses médias, et les emplacements Distribution, Lieux et Kit de marque du projet sont prêts si la prochaine étape nécessite un interprète récurrent, un lieu ou votre palette et logo. Depuis ici, vous pouvez télécharger l'ensemble ou ouvrir n'importe quelle image dans Studio.

La grille des médias du Projet Orange Ring campaign 2 : le visuel principal et les six créatifs, formats carré et vertical, avec leurs tailles
Les médias du projet. Sept ressources, classées par session.

La même session peut exécuter les presets de campagne sur la page Campagnes avec nolgia_run_preset : affiches en quatre tailles avec votre texte en vrai texte, packs de publicités statiques, panneaux d'affichage et films de lancement. Nous sommes restés sur les outils d'image bruts ici afin que la transcription montre chaque paramètre.

Trois façons de l'exécuter

VoieCommentIdéal quand
Le plus rapideUn preset par format avec nolgia_run_preset depuis Claude Code, ou sur le site depuis CampagnesVous souhaitez les mises en page éprouvées et un vrai texte sur les affiches
Sans interventionDécrivez la tâche à l'Agent NOLGIA dans sa discussion ; il traite les formats et les archiveVous n'êtes pas devant un terminal
Le plus de contrôleClaude Code avec les outils d'image bruts, comme dans ce guideVous souhaitez diriger chaque création et conserver la référence

Ce qui reste hors de la session

  • Publication. NOLGIA ne publie pas sur les plateformes publicitaires ni ne planifie. Vous téléchargez le lot et l'importez là où la campagne est diffusée.
  • Texte sur l'image. Les outils d'image bruts n'ajoutent pas de vrai texte ; les presets d'affiche le font.
  • Créations vidéo. La même session peut appeler nolgia_text_to_video et nolgia_image_to_video ; ce guide s'est limité aux images fixes.
  • Un prix dans le résultat. Un résultat d'image renvoie le fichier, pas les crédits consommés. Le registre sur votre page de facturation indique le coût par image.
  • ChatGPT. Indiqué comme Bientôt disponible sur la page MCP ; ce guide concerne uniquement Claude Code.

Ce que cela coûte

La lecture est gratuite : lister les modèles, créer un projet, ouvrir un asset et classer des assets ne coûtent rien. Chaque image est facturée au tarif de son modèle. Tarifs en vigueur pour le modèle de ce guide et les presets exécutés par la page Campagnes :

  • GPT Image 2.5 FlareEvery plan

    Per image

    Native 8 crédits · 2K 21 crédits · 4K 58 crédits

Lu en direct dans le catalogue au chargement de cette page. Chaque prix est affiché avant que vous ne génériez. Voir tous les tarifs.

Essayez par vous-même

Le visuel principal et le brief

  • Visuel principal des écouteurs, WebP 2048x2048Image WebP · 2048x2048 · 233 KBTélécharger
Importez le visuel principal dans votre Bibliothèque, placez son id d'asset dans le brief ci-dessus à la place du nôtre, puis envoyez le brief à Claude Code avec NOLGIA connecté. Autorisez également les outils de tâches. Vos visuels différeront des nôtres ; le produit, lui, ne doit pas changer, car le visuel principal sert de référence à chaque appel.

Liste de contrôle

  1. Jeton connecté ; nolgia_get_account répond.
  2. Visuel principal approuvé avant tout autre visuel ; son id d'asset dans le brief.
  3. Projet créé ; son id pour chaque génération.
  4. Modèle nommé dans le brief ; ne pas modifier la liste des modèles.
  5. Plafond de dépenses et tarif par image dans le brief ; outils de tâches autorisés.
  6. Un délai d'expiration est vérifié, pas relancé aveuglément.
  7. Ouvrez le projet sur le site et examinez chaque image en taille réelle.

Questions et réponses

Claude Code peut-il réaliser toute la campagne en une seule fois ?
Il peut enchaîner les appels, mais approuvez d'abord le visuel principal : chaque visuel est créé à partir de lui, donc un mauvais visuel principal signifie six images erronées.
Quel est le coût de la session ?
Seules les générations sont facturées. La création du projet, l'ouverture et le classement des ressources sont gratuits ; chaque image est facturée au tarif publié du modèle. Le résultat d'un appel d'image n'indique pas son prix, consultez donc le registre.
Un appel a expiré. Ai-je été facturé deux fois ?
Non. La même requête dans les cinq minutes renvoie une erreur 409 qui nomme la tâche existante, et seule la première est facturée. Trouvez l'image avec les outils jobs ou assets.
Peut-il placer mon titre sur le visuel ?
Non avec les outils d'image bruts. Le pack Social et poster et les presets de publicité statique définissent vos mots comme du texte réel ; exécutez-les avec nolgia_run_preset ou depuis la page Campagnes.
Cela fonctionne-t-il depuis ChatGPT ?
Pas encore. ChatGPT est marqué « Bientôt » sur la page MCP. Claude Code et Cursor fonctionnent dès aujourd'hui.

Lancez votre première campagne depuis le terminal

Connecter Claude Code

MCP

Générer depuis Claude Code ou Cursor avec MCP

Connectez NOLGIA à Claude Code ou Cursor avec un seul jeton et une seule commande ou entrée de configuration, puis demandez des images, des vidéos et de l'audio en langage naturel.

· 5 min de lecture

Vidéo produit

Vidéos produit sans tournage : choisir le format

Sept formats de vidéos produit, du tutoriel à la vidéo d'unboxing en passant par les mains seules, chacun avec un exemple réel, son utilité et quand le choisir.

· 8 min de lecture