Claude Code と MCP で広告キャンペーンをエンドツーエンドで実行する
コンポーザーを開く必要はありません。キャンペーンに必要な内容を Claude Code に伝えるだけで、NOLGIA のツールを呼び出し、クリエイティブがサイト上で開けるプロジェクトに保存されます。
- 8 分で読めます
- に更新
英語から自動翻訳されています。原文を読む
Claude Code に NOLGIA の MCP サーバーを接続し、自然な言葉でキャンペーンを依頼することで、小規模な広告キャンペーンを実行できます。Claude Code はプロジェクトを作成し、承認したヒーロー画像を開き、画像から画像へのツールを使ってそのヒーロー画像から各クリエイティブを作成し、指定したサイズですべてのクリエイティブをレンダリングし、結果をプロジェクトに保存します。プロジェクトページまたはライブラリで画像を確認でき、このワークフローではコンポーザーを開く必要はありません。
以下は、架空の製品(オレンジ色のライトリング付きマットブラックのヘッドホン)に関する実際のセッションの記録です。ツール呼び出しは Claude Code が生成したまま表示され、画像は返された結果であり、価格はページ読み込み時のライブカタログに基づいています。接続の設定については Generate from Claude Code or Cursor with MCP を参照してください。このガイドはその後の手順から始まります。
よくある問題と修正方法
| ミス | 影響 | **修正** |
|---|---|---|
| 6 枚すべての画像を 1 行で依頼する | エージェントが製品の合意前に生成を開始するため、誤った 6 枚分のクレジットを消費してしまいます | まずヒーロー画像を承認し、それから展開します |
| 各クリエイティブごとに製品を再度説明する | 説明が毎回異なり、製品の形状が変わってしまいます | 承認済みのヒーロー画像から、画像から画像への変換機能を使ってクリエイティブを作成します。これにより、参照画像が活用されます |
| プロジェクトをスキップする | 6つのアセットがライブラリにバラバラに保存され、それらを結びつけるものがありません | まずプロジェクトを作成し、すべての生成処理でそのIDを渡します |
| ウォレットの残高を領収書として読む | 他の人と共有するアカウントでは、セッション外の理由で残高が変動するため、そこから推定した価格は数倍高くなる可能性があります | エージェントに上限と画像ごとの料金を事前に伝え、残高ではなく台帳を確認します |
| タイムアウトした呼び出しを再試行する | 最初の呼び出しは通常、サーバー側で完了しています。無闇に再試行すると、画像が2枚作成されてしまいます | 同じリクエストの再試行は5分以内に409エラーを返し、二重に課金されません。アセットツールで結果を探します |
開始する前に
- MCPガイドに従い、Personal Access TokenでNOLGIAに接続されたClaude Code。
- チャージ済み残高内のクレジット: トークンはチャージ済みクレジットのみを消費します。
- ライブラリにある、承認済みの製品のヒーロー画像。当社の例は、GPT Image 2.5 Flareで作成した架空の製品です。
- モデル、サイズ、上限を記した短いブリーフです。私たちの例: クリエイティブ3点、1:1と9:16、最大80クレジット、画像1枚あたりの料金を明記。

Claude Codeへのブリーフ
1つのメッセージで、すべてのタスクを伝えます。製品、ヒーロー画像のアセットID、モデル、3つのクリエイティブ、2つのサイズ、保存ルール、画像1枚あたりの料金を含む上限、そして同時に実行できる呼び出し回数です。また、使用するツールと、モデルリストは触れないよう指示しました。モデルは私たちが指定していたためです。
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は必要な4つのツールを読み込み、プロジェクトを作成し、ヒーロー画像を開いて登録しました。その後、6枚の画像を3バッチに分けて作成しました。一度に3回以上の呼び出しは行わず、各バッチの後に実行中のコストを報告しました。署名付き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: trueCALL 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実行は問題なく完了しました。6枚の画像、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.AIは画像そのものではなく、その詳細情報のみを参照したため、最後の行で確認を促しています。プロジェクトを開き、すべての画像をフルサイズで確認してください。各プロンプトにある「No text, no letters, no logos, no brand names, no watermark」という行は、Claude Codeが独自に追加したもので、ブリーフには記載されていません。クリエイティブに看板やロゴを入れたい場合は、ブリーフで明示するか、正確なロゴ画像を添付してください。文字が乱れて生成された場合は、再生成してください。
キャンペーン
6枚の画像はすべて、同じヒーロー画像を参照し、GPT Image 2.5 Flareで生成されました。それぞれモデルのレートで課金されています。すべての呼び出しでヒーロー画像が参照されているため、どの画像でも製品は同じオブジェクトとして描かれています。






サイト上の配置場所
プロジェクトを開き、キャンペーンのプロジェクトを選択します。ヒーロー画像と6つのクリエイティブはメディアにあり、次のラウンドで繰り返し出演するパフォーマー、場所、またはカラーパレットとロゴが必要になった場合に備えて、プロジェクトのキャスト、ロケーション、ブランドキットのスロットが準備されています。ここからセットをダウンロードするか、Studioで任意の画像を開くことができます。

同じセッションでは、キャンペーンページでnolgia_run_presetを使用してキャンペーンプリセットを実行できます。これにより、実際のテキストとして設定されたワードを含む4種類のサイズのポスター、静的広告パック、ビルボード、ローンチフィルムを作成できます。ここではすべてのパラメータをトランスクリプトに示すため、生の画像ツールを使用しました。
実行方法は3つあります
| パス | 方法 | 最適な場面 |
|---|---|---|
| 最速 | 各フォーマットに1つのプリセットを、Claude Codeからnolgia_run_presetで実行するか、サイト上のCampaignsから実行します | 実績のあるレイアウトを使い、ポスターに実際のテキストを設定したい場合 |
| 手動操作なし | NOLGIA Agentにチャットで指示を出します。エージェントが各フォーマットで作業し、ファイルを保存します | ターミナルにいない場合 |
| 最も細かい制御 | このガイドのように、Claude Codeで生の画像ツールを使用します | 各クリエイティブを細かく指示し、参照素材を保持したい場合 |
セッション外で行うこと
- 公開。 NOLGIAは広告プラットフォームへの投稿やスケジュール設定は行いません。セットをダウンロードし、キャンペーンを実行する場所にアップロードしてください。
- 画像上のコピー。 生の画像ツールでは実際のテキストを設定できません。ポスターのプリセットでは可能です。
- 動画クリエイティブ。 同じセッションでnolgia_text_to_videoやnolgia_image_to_videoを呼び出すこともできますが、このガイドでは静止画のみを扱います。
- 結果に表示される価格。 画像の結果にはアセットが返され、消費したクレジット数は表示されません。請求ページの台帳に画像ごとの課金情報が記載されています。
- ChatGPT。 MCPページで「Soon」と表示されています。このガイドはClaude Codeのみを対象としています。
コスト
閲覧は無料です。モデルのリスト表示、プロジェクトの作成、アセットを開く操作、アセットの登録には何も消費されません。画像は各モデルの料金で課金されます。このガイドで使用しているモデルの現在の料金と、Campaigns ページで実行されるプリセットは以下の通りです。
- Static ad formats
8 credits per ad, 32 for four versions, 21 each at 2K
所要時間 under 2 min
- Social and poster pack
Priced on the review card before it runs
所要時間 3 to 8 minutes
GPT Image 2.5 FlareEvery plan
Per image
Native 8 クレジット · 2K 21 クレジット · 4K 58 クレジット
このページを開いたときにカタログから最新の値を読み込みます。 料金はすべて生成前に表示されます。 すべての料金を見る.
自分で試してみる
ヒーロー画像とブリーフ
- ヘッドフォンのヒーロー画像、2048x2048 WebPWebP 画像 · 2048x2048 · 233 KBダウンロード
チェックリスト
- トークンが接続されており、nolgia_get_account が応答します。
- クリエイティブを作成する前にヒーロー画像を承認し、そのアセット ID をブリーフに記載します。
- プロジェクトを作成し、すべての生成処理でその ID を使用します。
- ブリーフでモデルを指定し、モデルリストは変更しません。
- 上限と画像ごとの料金をブリーフに記載し、ジョブツールを許可します。
- タイムアウトは再試行せず、確認します。
- サイト上でプロジェクトを開き、すべての画像をフルサイズで確認します。
よくある質問
- Claude Code でキャンペーン全体を一度に作成できますか?
- 呼び出しを連鎖させることはできますが、まずヒーロー画像を承認してください。すべてのクリエイティブはそれに基づいて作成されるため、間違ったヒーロー画像は 6 枚の間違った画像につながります。
- セッションのコストはいくらですか?
- 課金されるのは生成のみです。プロジェクトの作成、アセットの開封と整理は無料です。各画像はモデルの公開料金で課金されます。画像呼び出しの結果には価格情報が含まれないため、台帳をご確認ください。
- 呼び出しがタイムアウトしました。二重に課金されましたか?
- いいえ。5分以内の同一リクエストは、既存のジョブを特定する409エラーを返し、最初のジョブのみが課金されます。jobsまたはassetsツールで画像を見つけてください。
- 見出しをクリエイティブに配置できますか?
- 生の画像ツールではできません。Socialおよびposter pack、static adプリセットでは、テキストを実際の文字として設定できます。nolgia_run_presetまたはCampaignsページから実行してください。
- ChatGPTからも使えますか?
- まだです。MCPページではChatGPTは「Soon」と表示されています。現在、Claude CodeとCursorが利用可能です。
ターミナルから最初のキャンペーンを実行する
Claude Codeを接続する関連ガイド
MCP
Claude CodeやCursorからMCPで生成する
1つのトークンと1つのコマンドまたは設定エントリでNOLGIAをClaude CodeやCursorに接続し、画像、動画、音声を自然な言葉でリクエストします。
· 5 分で読めます
Agent
NOLGIA Agent クックブック: 何を伝えるか、そして次に何が起きるか
商品写真やリスティングセットからフックスコアやグレーディング済みカットまで、NOLGIA Agent に送信できる10件のメッセージ、それぞれの処理内容、そしてその背後にあるプリセットについて解説します。
· 6 分で読めます
商品動画
撮影なしでプロダクト動画を作る:フォーマットを選ぶ
ハウツー動画からアンボクシング、ハンドオンリーまで、7つのプロダクト動画フォーマットを、実例、用途、選び方とあわせて解説します。
· 8 分で読めます




