가이드 / MCP

MCP로 Claude Code에서 광고 캠페인을 끝까지 실행하기

컴포저를 열지 않아도 됩니다. 캠페인에 필요한 내용을 Claude Code에 전달하면, NOLGIA 도구를 호출하고 크리에이티브가 사이트에서 열 수 있는 프로젝트에 저장됩니다.

  • 8분 분량
  • 업데이트

영어에서 자동 번역되었습니다. 원문 보기

히어로 이미지크리에이티브프로젝트

만드는 것을 순서대로 보여 줍니다. 누르면 해당 단계로 이동합니다.

NOLGIA의 MCP 서버에 연결하고 평범한 말로 캠페인을 요청하면 Claude Code에서 소규모 광고 캠페인을 실행할 수 있습니다. Claude Code가 프로젝트를 생성하고, 승인한 히어로 이미지를 열며, 이미지 투 이미지 도구를 사용하여 해당 히어로 이미지에서 각 크리에이티브를 만들고, 지정된 크기로 모든 크리에이티브를 렌더링한 후 결과를 프로젝트에 저장합니다. 프로젝트 페이지나 라이브러리에서 이미지를 검토할 수 있으며, 이 과정에서는 컴포저를 열 필요가 없습니다.

아래 내용은 가상의 제품(주황색 라이트 링이 있는 무광 블랙 헤드폰)에 대한 실제 세션 하나를 보여줍니다. 도구 호출은 Claude Code가 생성한 그대로 표시되며, 이미지는 반환된 결과이고, 가격은 이 페이지가 로드될 때 라이브 카탈로그에서 가져옵니다. 연결 설정은 Claude Code 또는 Cursor에서 MCP로 생성하기에서 다루며, 이 가이드는 그 이후부터 시작합니다.

잘못된 점과 해결 방법

실수문제의 원인수정
한 줄에 여섯 개의 이미지를 모두 요청하기제품이 합의되기 전에 에이전트가 생성하므로 잘못된 이미지 여섯 개에 대한 비용을 지불하게 됩니다먼저 히어로 이미지를 승인한 후 확장하기
각 크리에이티브마다 제품을 다시 설명하기설명이 매번 달라져서 제품 모양이 변합니다승인된 히어로 이미지로 이미지 투 이미지를 통해 크리에이티브를 제작하여 참조가 유지되도록 합니다
프로젝트 건너뛰기여섯 개의 자산이 연결 없이 라이브러리에 흩어져 저장됩니다프로젝트를 먼저 생성하고 모든 생성 요청에 해당 id를 전달합니다
영수증처럼 지갑 잔액 읽기다른 사람도 사용하는 계정에서는 세션과 무관한 이유로 잔액이 변동되므로, 이를 통해 추론한 가격이 몇 배나 높을 수 있습니다에이전트에게 상한선과 이미지당 단가를 미리 알려주고, 잔액이 아니라 장부를 읽으세요
시간 초과된 호출 재시도첫 번째 호출은 서버에서 보통 완료되었습니다. 무작정 재시도하면 이미지가 두 개 생성됩니다동일한 요청을 5분 이내에 재시도하면 409 오류가 발생하며 두 번 청구되지 않습니다. assets 도구로 결과를 찾으세요

시작하기 전에

  • MCP 가이드에 따라 개인 액세스 토큰으로 NOLGIA에 연결된 Claude Code
  • 충전 잔액에 있는 크레딧: 토큰은 충전 크레딧만 소모합니다.
  • 라이브러리에 있는 승인된 제품 히어로 이미지. 저희는 GPT Image 2.5 Flare로 만든 가상의 제품입니다.
  • 모델, 크기, 상한선을 담은 짧은 브리핑입니다. 저희의 경우: 크리에이티브 3개, 1:1 및 9:16 비율, 최대 80 크레딧, 이미지당 비용 명시.
오후 늦은 시간의 창가 빛이 비치는 낡은 오크 책상 위에 놓인, 각 이어컵에 얇고 빛나는 주황색 링이 있는 무광 검은색 오버이어 헤드폰.
승인된 히어로 이미지. 세션 전에 GPT Image 2.5 Flare로 제작했습니다. 아래 모든 크리에이티브는 이 이미지를 기반으로 제작되었습니다.

Claude Code에 브리핑하기

한 번의 메시지로 전체 작업을 전달합니다: 제품, 히어로 이미지의 자산 ID, 모델, 크리에이티브 3개, 두 가지 크기, 파일링 규칙, 이미지당 비용이 명시된 상한선, 그리고 동시에 실행할 수 있는 호출 횟수까지 포함합니다. 또한 사용할 도구를 지정하고 모델 목록은 건드리지 않도록 지시했습니다. 모델은 직접 지정했기 때문입니다.

전송된 브리핑
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.

팁:모델과 참조 이미지 지정하기. nolgia_list_models는 세션에 필요한 것보다 훨씬 많은 전체 카탈로그를 반환합니다. 브리핑에서 모델 ID를 명시하세요. 히어로 이미지는 모든 이미지 투 이미지 호출의 참조 이미지로 사용되며, 이를 통해 크리에이티브 간에 제품이 일관되게 유지됩니다.

세션 내용 그대로

Claude Code는 필요한 네 가지 도구를 불러오고, 프로젝트를 생성한 후, 히어로를 열고 등록했습니다. 그런 다음 세 번의 배치로 여섯 개의 이미지를 만들었으며, 한 번에 세 번 이상의 호출을 하지 않았고 각 배치 후 현재 사용 중인 비용을 보고했습니다. 서명된 URL은 단축되고, JSON 결과는 키와 값 줄로 출력되며, 모든 프롬프트가 공유하는 시작 부분은 한 번만 출력됩니다. 그 외의 내용은 수정되지 않습니다.

도구, 프로젝트 및 히어로 (인수와 결과를 키와 값 줄로 표시)
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
세 번의 배치로 만든 여섯 개의 이미지 (크레딧 수치를 글자로 표기)
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

작업은 깔끔하게 진행되었습니다. 여섯 개의 이미지, 48 크레딧으로 설정한 80 크레딧 이내에서 완료했으며, 중단, 시간 초과 또는 재시도가 없었습니다. 브리프에 이미지당 단가가 명시되어 있었기 때문에, 지갑을 확인하는 대신 자체적으로 비용을 계산했습니다.

마지막 메시지 (크레딧 수치를 글자로 표기)
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.

이미지는 보지 않고 세부 정보만 확인했기 때문에 마지막 줄에서 확인을 요청합니다. 프로젝트를 열고 모든 이미지를 전체 크기로 살펴보세요. 각 프롬프트의 "No text, no letters, no logos, no brand names, no watermark" 문구는 Claude Code가 자체적으로 추가한 것으로, 브리프에서 요청한 내용이 아닙니다. 크리에이티브에 간판이나 로고를 넣으려면 브리프에 명시하거나 정확한 로고 이미지를 첨부하세요. 텍스트가 깨져 나오면 다시 생성하세요.

캠페인

하나의 히어로 이미지에서 만든 6개의 이미지로, 모두 GPT Image 2.5 Flare를 사용했으며 모델 요금 기준으로 청구되었습니다. 모든 호출에서 히어로 이미지를 참조로 사용했기 때문에 모든 이미지의 제품이 동일한 객체입니다.

아침 창문 빛이 비치는 참나무 책상 위의 헤드폰, 빛줄기 속을 떠다니는 먼지, 정사각형.
크리에이티브 A, 1:1. 아침 책상.
아침 창문 빛이 비치는 참나무 책상 위의 헤드폰, 빛줄기 속을 떠다니는 먼지, 세로형.
크리에이티브 A, 9:16.
비로 젖은 헤드폰 클로즈업, 뒤로 보이는 호박색 가로등 반사와 도시 보케, 정사각형.
크리에이티브 B, 1:1. 밤비, 물방울에 비친 따뜻한 가로등.
비로 젖은 헤드폰 클로즈업, 뒤로 보이는 호박색 가로등 반사와 도시 보케, 세로형.
크리에이티브 B, 9:16.
흐릿한 연습실에서 긴 어두운 코트를 입은 젊은 무용수가 뒤에서 보이며 헤드폰을 착용하고 있다. 따뜻한 램프 하나가 켜져 있고 주황색 링이 빛나고 있으며 정사각형 구도이다.
크리에이티브 C, 1:1. 따뜻한 램프 아래 실루엣.
흐릿한 연습실에서 긴 어두운 코트를 입은 젊은 무용수가 뒤에서 보이며 헤드폰을 착용하고 있다. 따뜻한 램프 하나가 켜져 있고 주황색 링이 빛나고 있으며 세로형 구도이다.
크리에이티브 C, 9:16.

사이트에 표시되는 위치

프로젝트를 열고 캠페인 프로젝트를 선택하세요. 히어로 이미지와 6개의 크리에이티브가 미디어에 있으며, 다음 라운드에서 반복 출연자, 장소 또는 팔레트와 로고가 필요할 경우를 대비해 프로젝트의 출연진, 장소 및 브랜드 키트 슬롯이 준비되어 있습니다. 여기서 세트를 다운로드하거나 Studio에서 이미지를 열 수 있습니다.

Orange Ring 캠페인 2의 프로젝트 미디어 그리드: 히어로 이미지와 6개의 크리에이티브(정사각형 및 세로형)와 그 크기
프로젝트의 미디어. 세션별로 정리된 7개의 자산.

동일한 세션에서 캠페인 페이지의 nolgia_run_preset을 사용하여 캠페인 프리셋을 실행할 수 있습니다. 실제 텍스트로 설정된 문구가 포함된 4가지 크기의 포스터, 정적 광고 팩, 빌보드 및 런칭 필름을 생성합니다. 여기서는 모든 매개변수가 기록에 표시되도록 원본 이미지 도구를 사용했습니다.

실행하는 세 가지 방법

경로방법적합한 경우
가장 빠름Claude Code에서 nolgia_run_preset을 사용하여 형식별 프리셋 하나를 실행하거나, 사이트의 캠페인에서 실행검증된 레이아웃과 포스터에 실제 텍스트가 설정된 상태를 원할 때
자동화NOLGIA Agent에 채팅으로 브리핑하면 형식을 처리하고 파일을 저장합니다터미널에 있지 않을 때
가장 높은 제어이 가이드에서처럼 원시 이미지 도구를 사용하여 Claude Code로 실행각 크리에이티브를 직접 지시하고 참조를 유지하고 싶을 때

세션 외부에 남는 요소

  • 게시. NOLGIA는 광고 플랫폼에 게시하거나 일정을 잡지 않습니다. 세트를 다운로드하여 캠페인이 실행되는 곳에 업로드하세요.
  • 이미지 내 카피. 원시 이미지 도구는 실제 텍스트를 설정하지 않으며, 포스터 프리셋이 이를 수행합니다.
  • 비디오 크리에이티브. 동일한 세션에서 nolgia_text_to_video 및 nolgia_image_to_video를 호출할 수 있지만, 이 가이드는 정지 이미지에만 집중했습니다.
  • 결과에 포함된 가격. 이미지 결과는 자산만 반환하며, 소모된 크레딧은 포함되지 않습니다. 청구 페이지의 장부에 이미지당 비용이 기록되어 있습니다.
  • ChatGPT. MCP 페이지에서 '준비 중'으로 표시되어 있으며, 이 가이드는 Claude Code 전용입니다.

비용

읽기는 무료입니다: 모델 목록 보기, 프로젝트 생성, 자산 열기, 자산 등록은 비용이 들지 않습니다. 각 이미지는 해당 모델의 요금으로 청구됩니다. 이 가이드의 모델과 캠페인 페이지에서 실행하는 프리셋의 실시간 요금:

  • GPT Image 2.5 FlareEvery plan

    Per image

    Native 8 크레딧 · 2K 21 크레딧 · 4K 58 크레딧

이 페이지를 열 때 카탈로그에서 실시간으로 불러옵니다. 모든 가격은 생성하기 전에 표시됩니다. 모든 요금 보기.

직접 해보세요

히어로 이미지와 브리프

  • 헤드폰 히어로 이미지, 2048x2048 WebPWebP 이미지 · 2048x2048 · 233 KB다운로드
히어로 이미지를 라이브러리에 업로드하고, 위 브리프의 자산 ID를 본인 것으로 교체한 뒤, NOLGIA가 연결된 Claude Code로 브리프를 전송하세요. 작업 도구도 허용해 주세요. 제작물은 저희 것과 다를 수 있지만, 제품은 달라지면 안 됩니다. 모든 호출에서 히어로 이미지가 기준이 되기 때문입니다.

체크리스트

  1. 토큰 연결됨; nolgia_get_account 응답 확인됨.
  2. 제작물 생성 전 히어로 이미지 승인됨; 브리프에 자산 ID 포함됨.
  3. 프로젝트 생성됨; 모든 생성 작업에 프로젝트 ID 사용됨.
  4. 브리프에 모델 명시됨; 모델 목록은 그대로 둠.
  5. 브리프에 상한선과 이미지당 요금 명시됨; 작업 도구 허용됨.
  6. 타임아웃은 무작정 재시도하지 않고 확인함.
  7. 사이트에서 프로젝트를 열고 모든 이미지를 전체 크기로 확인하세요.

자주 묻는 질문

Claude Code로 전체 캠페인을 한 번에 만들 수 있나요?
호출을 연결할 수는 있지만, 먼저 히어로 이미지를 승인하세요. 모든 제작물이 이를 기반으로 생성되므로, 잘못된 히어로 이미지는 잘못된 이미지 6장을 의미합니다.
세션 비용은 얼마나 되나요?
생성에만 비용이 발생합니다. 프로젝트 생성, 자산 열람 및 파일링은 무료이며, 각 이미지는 해당 모델의 공개된 요금으로 청구됩니다. 이미지 호출 결과에는 가격이 표시되지 않으므로 장부를 확인하세요.
호출 시간이 초과되었습니다. 두 번 청구된 건가요?
아니요. 5분 이내의 동일 요청은 기존 작업을 명시하는 409 오류를 반환하며, 첫 번째 요청만 청구됩니다. jobs 또는 assets 도구를 사용하여 이미지를 찾으세요.
크리에이티브에 헤드라인을 넣을 수 있나요?
원시 이미지 도구로는 불가능합니다. Social 및 poster pack, 정적 광고 프리셋은 텍스트를 실제 문자로 설정합니다. nolgia_run_preset을 실행하거나 Campaigns 페이지에서 사용하세요.
ChatGPT에서도 작동하나요?
아직은 아닙니다. MCP 페이지에서 ChatGPT는 'Soon'으로 표시되어 있습니다. 현재 Claude Code와 Cursor는 작동합니다.

터미널에서 첫 번째 캠페인 실행하기

Claude Code 연결하기

MCP

MCP로 Claude Code 또는 Cursor에서 생성하기

토큰 하나와 명령어 또는 설정 항목 하나로 NOLGIA를 Claude Code 또는 Cursor에 연결한 후, 평범한 말로 이미지, 영상, 오디오 생성을 요청하세요.

· 5분 분량