Guías / MCP

Ejecuta una campaña publicitaria de principio a fin desde Claude Code con MCP

No abres un compositor. Le dices a Claude Code qué necesita la campaña, este llama a las herramientas de NOLGIA y los creativos llegan a un proyecto que puedes abrir en el sitio.

  • 8 min de lectura
  • Actualizado el

Traducido automáticamente del inglés. Leer el original

El héroeCreatividadesProyecto

Lo que creas, en orden. Pulsa uno para ir a su paso.

Ejecutas una pequeña campaña publicitaria desde Claude Code conectándolo al servidor MCP de NOLGIA y pidiendo la campaña en lenguaje natural. Claude Code crea un proyecto, abre la imagen principal que aprobaste, genera cada creativo a partir de esa imagen principal con la herramienta de imagen a imagen, renderiza cada creativo en los tamaños que indiques y archiva los resultados en el proyecto. Revisas las imágenes en la página del proyecto o en tu Biblioteca, y nada en el proceso requiere tener un compositor abierto.

Todo lo siguiente es una sesión real sobre un producto ficticio: auriculares negros mate con un anillo de luz naranja. Las llamadas a herramientas se muestran tal como las hizo Claude Code, las imágenes son las que devolvió y los precios provienen del catálogo en vivo cuando se carga esta página. La configuración de la conexión se explica en Generar desde Claude Code o Cursor con MCP; esta guía comienza después de eso.

Qué puede salir mal y la corrección

ErrorPor qué perjudicaCorregir
Pedir las seis imágenes en una sola líneaEl agente genera antes de que se apruebe el producto, y pagas por seis incorrectasAprueba primero la imagen principal y luego distribuye
Describir el producto de nuevo para cada creativoCada descripción se desvía y el producto cambia de formaCrea los creativos a partir del héroe aprobado usando imagen a imagen, para que la referencia se mantenga
Omitir el proyectoSeis recursos quedan sueltos en la Biblioteca sin nada que los vinculeCrea primero el proyecto y pasa su id en cada generación
Leer el saldo de la cartera como un reciboEn una cuenta que usan otras personas, el saldo cambia por motivos ajenos a la sesión, por lo que un precio inferido de él puede ser varias veces demasiado altoDale al agente el límite máximo y la tarifa por imagen de antemano, y lee el registro, no el saldo
Reintentar una llamada que expiróLa primera llamada suele haber terminado en el servidor; un reintento a ciegas genera una segunda imagenUn reintento de la misma solicitud devuelve un 409 en cinco minutos y no se factura dos veces; encuentra el resultado con la herramienta de recursos

Antes de empezar

  • Claude Code conectado a NOLGIA con un Personal Access Token, según la guía de MCP.
  • Créditos en tu saldo de recarga: un token solo gasta créditos de recarga.
  • Una imagen hero aprobada del producto en tu Biblioteca. La nuestra es un producto ficticio, creado con GPT Image 2.5 Flare.
  • Un brief breve con el modelo, los tamaños y el límite. El nuestro: tres creativos, 1:1 y 9:16, como máximo ochenta créditos, con la tarifa por imagen indicada.
Auriculares de diadema negro mate con un fino anillo naranja luminoso en cada copa, apoyados sobre un escritorio de roble desgastado bajo la luz de la ventana al final de la tarde.
El héroe aprobado. Creado con GPT Image 2.5 Flare antes de la sesión. Todos los creativos siguientes se hicieron a partir de él.

Brief para Claude Code

Un solo mensaje contiene todo el trabajo: el producto, el id del recurso del héroe, el modelo, los tres creativos, los dos tamaños, la regla de archivo, el límite con la tarifa por imagen y cuántas llamadas pueden ejecutarse a la vez. También le indicamos qué herramientas usar y que no tocara la lista de modelos, porque nosotros mismos estábamos nombrando el modelo.

El brief, tal como se envió
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.

Consejo:Nombra el modelo y la referencia. nolgia_list_models devuelve todo el catálogo, mucho más de lo que una sesión necesita. Indica el id del modelo en el brief. El héroe viaja como imagen de referencia en cada llamada de imagen a imagen, lo que mantiene el producto igual en todos los creativos.

La sesión, literal

Claude Code cargó las cuatro herramientas que necesitaba, creó el proyecto, abrió el héroe y lo archivó, luego generó las seis imágenes en tres lotes, nunca más de tres llamadas a la vez, e indicó su gasto acumulado tras cada lote. Las URLs firmadas se acortan, los resultados JSON se imprimen como líneas de clave y valor, y la apertura que comparten todos los prompts se imprime una sola vez; nada más se edita.

Herramientas, proyecto y héroe (argumentos y resultados como líneas de clave y valor)
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
Las seis imágenes en tres lotes (cifras de créditos escritas en letras)
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

Se ejecutó sin fallos: seis imágenes, cuarenta y ocho créditos, dentro de los ochenta que establecimos, sin detenerse, sin tiempos de espera ni reintentos. Como el brief indicaba la tarifa por imagen, contó su propio gasto en lugar de leer la cartera.

Su mensaje de cierre (cifras de créditos escritas en letras)
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.

Nunca vio las imágenes, solo sus detalles, por eso sus últimas líneas te piden que las revises: abre el proyecto y mira cada imagen a tamaño completo. La línea "No text, no letters, no logos, no brand names, no watermark" en cada prompt fue una adición propia de Claude Code; el brief no la solicitaba. Si quieres un cartel o tu logo en una creatividad, nómbralo en el brief o adjunta la imagen exacta del logo, y regenera si el texto sale distorsionado.

La campaña

Seis imágenes, todas a partir del mismo héroe, todas en GPT Image 2.5 Flare, cada una facturada a la tarifa del modelo. El producto es el mismo objeto en todas porque el héroe fue la referencia en cada llamada.

Los auriculares sobre un escritorio de roble en un rayo de luz de la ventana matinal, con polvo flotando en el haz, formato cuadrado.
Creatividad A, 1:1. Escritorio matinal.
Los auriculares sobre un escritorio de roble en un rayo de luz de la ventana matinal, con polvo flotando en el haz, formato vertical.
Creatividad A, 9:16.
Primer plano de los auriculares cubiertos de gotas de lluvia, con reflejos de farolas ámbar y bokeh de la ciudad al fondo, formato cuadrado.
Creatividad B, 1:1. Lluvia nocturna, luz cálida de farola en las gotas.
Primer plano de los auriculares cubiertos de gotas de lluvia, con reflejos de farolas ámbar y bokeh de la ciudad al fondo, formato vertical.
Creativo B, 9:16.
Una joven bailarina vista por detrás con un abrigo largo oscuro y los auriculares puestos en una sala de ensayo brumosa, una lámpara cálida, los anillos naranjas brillando, formato cuadrado.
Creativo C, 1:1. Silueta bajo una lámpara cálida.
Una joven bailarina vista por detrás con un abrigo largo oscuro y los auriculares puestos en una sala de ensayo brumosa, una lámpara cálida, los anillos naranjas brillando, formato vertical.
Creativo C, 9:16.

Dónde se muestra en el sitio

Abre Proyectos y el proyecto de la campaña. El hero y los seis creativos están en sus medios, y los espacios de reparto, localizaciones y kit de marca del proyecto están listos si la siguiente ronda necesita un intérprete recurrente, un lugar o tu paleta y logo. Desde aquí puedes descargar el conjunto o abrir cualquier imagen en Studio.

La cuadrícula de medios del Proyecto de la campaña Orange Ring 2: el hero y los seis creativos, en formato cuadrado y vertical, con sus tamaños
Los medios del proyecto. Siete recursos, archivados por la sesión.

La misma sesión puede ejecutar los presets de campaña en la página Campañas con nolgia_run_preset: carteles en cuatro tamaños con tu texto como texto real, packs de anuncios estáticos, vallas publicitarias y películas de lanzamiento. Nos hemos quedado en las herramientas de imagen sin procesar aquí para que la transcripción muestre cada parámetro.

Tres formas de ejecutarlo

RutaCómoMejor cuando
Más rápidoUn preset por formato con nolgia_run_preset desde Claude Code, o en el sitio desde CampañasQuieres los diseños probados y el texto real en los carteles
Sin intervenciónDale instrucciones al NOLGIA Agent en su chat; trabaja con los formatos y los archivaNo estás en una terminal
Máximo controlClaude Code con las herramientas de imagen sin procesar, como en esta guíaQuieres dirigir cada creativo y mantener la referencia

Lo que queda fuera de la sesión

  • Publicación. NOLGIA no publica en plataformas de anuncios ni programa. Descargas el conjunto y lo subes donde se ejecuta la campaña.
  • Texto en la imagen. Las herramientas de imagen sin procesar no añaden texto real; los presets de carteles sí.
  • Creativos de vídeo. La misma sesión puede llamar a nolgia_text_to_video y nolgia_image_to_video; esta guía se ha centrado en imágenes estáticas.
  • Un precio en el resultado. Un resultado de imagen devuelve el recurso, no los créditos que ha costado. El registro en tu página de facturación muestra el coste por imagen.
  • ChatGPT. Marcado como Próximamente en la página de MCP; esta guía es solo para Claude Code.

Cuánto cuesta

Leer es gratis: listar modelos, crear un proyecto, abrir un recurso y archivar recursos no consume nada. Cada imagen se factura a la tarifa de su modelo. Tarifas vigentes para el modelo de esta guía y los presets que ejecuta la página de Campañas:

  • GPT Image 2.5 FlareEvery plan

    Per image

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

Se lee en directo del catálogo al cargar esta página. Cada precio se muestra antes de generar. Ver todas las tarifas.

Pruébalo tú mismo

El héroe y el brief

  • Imagen principal de auriculares, 2048x2048 WebPImagen WebP · 2048x2048 · 233 KBDescargar
Sube la imagen principal a tu Biblioteca, coloca su id de recurso en el brief anterior en lugar del nuestro y envía el brief a Claude Code con NOLGIA conectado. Permite también las herramientas de trabajos. Tus creativos diferirán de los nuestros; el producto no debería, porque la imagen principal es la referencia en cada llamada.

Lista de comprobación

  1. Token conectado; nolgia_get_account responde.
  2. Imagen principal aprobada antes de cualquier creativo; su id de recurso en el brief.
  3. Proyecto creado; su id en cada generación.
  4. Modelo especificado en el brief; la lista de modelos sin cambios.
  5. Límite máximo y tarifa por imagen en el brief; herramientas de trabajos permitidas.
  6. Se comprueba un tiempo de espera, no se reintenta a ciegas.
  7. Abre el proyecto en el sitio y revisa cada imagen a tamaño completo.

Preguntas y respuestas

¿Puede Claude Code crear toda la campaña de una vez?
Puede encadenar las llamadas, pero aprueba primero la imagen principal: cada creativo se genera a partir de ella, por lo que una imagen principal incorrecta significa seis imágenes erróneas.
¿Cuánto cuesta la sesión?
Solo las generaciones. Crear el proyecto, abrir y archivar los recursos son gratuitos; cada imagen se factura según la tarifa publicada del modelo. El resultado de una llamada de imagen no incluye su precio, así que consulta el registro.
Una llamada ha expirado. ¿Me han cobrado dos veces?
No. La misma solicitud dentro de cinco minutos devuelve un error 409 que identifica el trabajo existente, y solo se factura el primero. Encuentra la imagen con las herramientas de trabajos o recursos.
¿Puede poner mi titular en el material creativo?
No con las herramientas de imagen sin procesar. El pack de redes sociales y carteles y los presets de anuncios estáticos configuran tus palabras como texto real; ejecútalos con nolgia_run_preset o desde la página Campañas.
¿Funciona esto desde ChatGPT?
Todavía no. ChatGPT aparece como Próximamente en la página de MCP. Claude Code y Cursor funcionan hoy.

Ejecuta tu primera campaña desde la terminal

Conectar Claude Code

MCP

Genera desde Claude Code o Cursor con MCP

Conecta NOLGIA a Claude Code o Cursor con un token y un comando o entrada de configuración, y luego pide imágenes, vídeo y audio con palabras sencillas.

· 5 min de lectura

Vídeo de producto

Vídeos de producto sin grabar: elige el formato

Siete formatos de vídeo de producto, desde un tutorial hasta un unboxing o solo manos, cada uno con un ejemplo real, su utilidad y cuándo elegirlo.

· 8 min de lectura