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 lo que 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éroeCreativosProyecto

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

Ejecutas una campaña publicitaria pequeña desde Claude Code conectándolo al servidor MCP de NOLGIA y pidiendo la campaña en palabras simples. 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 flujo 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 se obtuvieron y los precios provienen del catálogo en vivo cuando se carga esta página. La configuración de la conexión se cubre en Generar desde Claude Code o Cursor con MCP; esta guía comienza después de eso.

Qué sale mal y la corrección

ErrorPor qué afectaCorregir
Pedir las seis imágenes en una sola líneaEl agente genera antes de que se apruebe el producto y pagas por seis imágenes incorrectasAprueba primero la imagen principal y luego genera las demás
Describir el producto de nuevo para cada creativoCada descripción se desvía y el producto cambia de formaCrea los creativos a partir del hero aprobado usando imagen a imagen, para que la referencia se mantenga
Omitir el proyectoSeis activos quedan sueltos en la Biblioteca sin nada que los vinculeCrea el proyecto primero y pasa su id en cada generación
Leer el saldo de la billetera como comprobanteEn una cuenta que usan otras personas, el saldo cambia por razones ajenas a la sesión, por lo que un precio inferido de él puede ser varias veces más altoDale al agente el límite máximo y la tarifa por imagen desde el principio, y lee el registro, no el saldo
Reintentar una llamada que expiróLa primera llamada generalmente terminó en el servidor; un reintento a ciegas genera una segunda imagenUn reintento de la misma solicitud recibe un 409 dentro de cinco minutos y no se factura dos veces; encuentra el resultado con la herramienta de activos

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, un máximo de ochenta créditos, con la tarifa por imagen indicada.
Auriculares over-ear negros mate con un fino anillo naranja brillante 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. Cada creativo a continuación se creó a partir de él.

Brief para Claude Code

Un solo mensaje contiene todo el trabajo: el producto, el id del activo 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 estábamos nombrando el modelo.

El brief, 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 la imagen de referencia en cada llamada de imagen a imagen, lo que mantiene el producto igual en todos los creativos.

La sesión, palabra por palabra

Claude Code cargó las cuatro herramientas que necesitaba, creó el proyecto, abrió el héroe y lo archivó, luego hizo las seis imágenes en tres lotes, nunca más de tres llamadas a la vez, e indicó su gasto actual después de cada lote. Las URLs firmadas se acortan, los resultados JSON se imprimen como líneas de clave y valor, y el inicio 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 problemas: 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 billetera.

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 solicitó. Si quieres un letrero o tu logo en un creativo, 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 de la misma imagen principal, todas en GPT Image 2.5 Flare, cada una facturada a la tarifa del modelo. El producto es el mismo objeto en todas porque la imagen principal fue la referencia en cada llamada.

Los auriculares sobre un escritorio de roble en un rayo de luz de la ventana por la mañana, polvo flotando en el haz, formato cuadrado.
Creativo A, 1:1. Escritorio matutino.
Los auriculares sobre un escritorio de roble en un rayo de luz de la ventana por la mañana, polvo flotando en el haz, formato vertical.
Creativo A, 9:16.
Primer plano de los auriculares cubiertos de gotas de lluvia, reflejos de farolas ámbar y desenfoque de la ciudad detrás, formato cuadrado.
Creativo B, 1:1. Lluvia nocturna, luz cálida de farola en las gotas.
Primer plano de los auriculares cubiertos de gotas de lluvia, reflejos de farolas ámbar y desenfoque de la ciudad detrás, formato vertical.
Creativo B, 9:16.
Una joven bailarina vista de espaldas, con un abrigo oscuro largo y los auriculares puestos, en una sala de ensayo brumosa, con 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 de espaldas, con un abrigo oscuro largo y los auriculares puestos, en una sala de ensayo brumosa, con 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, Locaciones y Kit de marca del proyecto están listos por 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, organizados 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: pósters en cuatro tamaños con tus palabras como texto real, paquetes de anuncios estáticos, vallas publicitarias y películas de lanzamiento. Nos quedamos en las herramientas de imagen sin procesar aquí para que la transcripción muestre cada parámetro.

Tres formas de ejecutarlo

RutaCómoIdeal 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 texto real en los pósters
Sin intervenciónDale instrucciones al NOLGIA Agent en su chat; trabaja con los formatos y los archivaNo estás frente a una terminal
Mayor 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 pósteres sí.
  • Creativos de video. La misma sesión puede llamar a nolgia_text_to_video y nolgia_image_to_video; esta guía se centró en imágenes estáticas.
  • Un precio en el resultado. Un resultado de imagen devuelve el recurso, no los créditos que costó. El registro en tu página de facturación tiene el cargo por imagen.
  • ChatGPT. Marcado como Próximamente en la página de MCP; esta guía es solo para Claude Code.

Cuánto cuesta

La lectura es gratuita: listar modelos, crear un proyecto, abrir un activo y archivar activos 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 vivo 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

  • Héroe de auriculares, 2048x2048 WebPImagen WebP · 2048x2048 · 233 KBDescargar
Sube el héroe a tu Biblioteca, coloca su id de activo 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 jobs. Tus creativos diferirán de los nuestros; el producto no debería, porque el héroe es la referencia en cada llamada.

Lista de verificación

  1. Token conectado; nolgia_get_account responde.
  2. Héroe aprobado antes de cualquier creativo; su id de activo 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 la tarifa por imagen en el brief; las herramientas de jobs permitidas.
  6. Se revisa un timeout, no se reintenta a ciegas.
  7. Abre el proyecto en el sitio y mira cada imagen a tamaño completo.

Preguntas y respuestas

¿Puede Claude Code hacer toda la campaña de una sola vez?
Puede encadenar las llamadas, pero aprueba el héroe primero: cada creativo se hace a partir de él, por lo que un héroe incorrecto significa seis imágenes incorrectas.
¿Cuánto cuesta la sesión?
Solo las generaciones. Crear el proyecto, abrir y archivar recursos es gratis; cada imagen se factura a la tarifa publicada del modelo. El resultado de una llamada de imagen no incluye su precio, así que revisa el registro.
Una llamada expiró. ¿Me cobraron dos veces?
No. La misma solicitud dentro de cinco minutos devuelve un 409 que nombra 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 paquete de redes sociales y póster y los presets de anuncios estáticos establecen tus palabras como texto real; ejecútalos con nolgia_run_preset o desde la página de Campañas.
¿Esto funciona desde ChatGPT?
Aún no. ChatGPT está marcado como Pronto 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, luego pide imágenes, video y audio en palabras simples.

· 5 min de lectura

Video de producto

Videos de producto sin grabar: elige el formato

Siete formatos de video de producto, desde un tutorial hasta un unboxing o solo manos, cada uno con un ejemplo real, su propósito y cuándo elegirlo.

· 8 min de lectura