この頁は英語の原文の参考訳です。内容が異なる場合は原文が優先します。

ガイド

MCP で広告アカウントを読む:Claude を Apple Ads・Google 広告・Meta・TikTok につなぐ

Loop は、運用する広告媒体の前にリモートの MCP の窓口を置いています。Claude などの MCP クライアントをつなぐと、エージェントはキャンペーンごとの広告費、もたらしたインストールとその単価、受信箱で承認を待つ提案、直前の変更が失敗した理由を読めます。

提案用(propose)の鍵なら、新しいキャンペーンや動いているキャンペーンの変更を下書きできます。下書きは Loop の入力画面と同じ検査を通って受信箱に入ります。人がそこで承認するまで、広告の媒体には何も届きません。

2 分でつなぐ

ワークスペースを作り、広告アカウントを 1 つつなぎます。Settings › Team › API keys で範囲(read か propose)を選んで鍵を作ります。鍵は lmk_ で始まり、1 回だけ表示されます。

サーバーは Streamable HTTP で話し、セッションの状態を持ちません。鍵を Bearer トークンとして送ります。

Claude Code

claude mcp add --transport http loop https://loopmarket.ing/api/mcp \
  --header "Authorization: Bearer $LOOP_API_KEY"

.mcp.json(どの MCP クライアントでも)

{
  "mcpServers": {
    "loop": {
      "type": "http",
      "url": "https://loopmarket.ing/api/mcp",
      "headers": {
        "Authorization": "Bearer ${LOOP_API_KEY}"
      }
    }
  }
}

道具

どの道具も、鍵が属する 1 つのワークスペースだけを扱います。read の鍵には読む道具が、propose の鍵には両方が見えます。説明は API が返す原文のままです。

道具鍵の範囲すること
list_workspacesread鍵が属するワークスペース、その通貨、鍵の範囲。
get_overviewread広告費・有料のインストール・インストール単価と前の期間との差、見出し、計測の注意、承認待ちの数。
list_campaignsreadLoop が運用するすべてのキャンペーンの状態・予算と、媒体が報告した広告費・インストール。
get_campaignread1 つのキャンペーンの数・日ごとの広告費・承認待ちの提案・実行した変更。
list_proposalsread受信箱:人を待つ提案、ガードレールが止めている提案、直近の実行と失敗の理由。
create_launch_draftpropose新しいキャンペーンを下書きする。Loop の入力画面と同じ検査を通り、受信箱で承認を待つ。
prepare_campaign_changepropose動いているキャンペーンの変更を下書きする:予算の移し替え・総額の上限・上限 CPC・広告グループの追加・広告文・言語・終了日。
list_app_eventsreadアプリが送る Meta のアプリ内イベント。下書きの最適化のイベントに使える。
list_budget_testsreadガードレール付きの予算テスト:期間・日の幅・止める条件・最新の判定。

エージェントにできないこと

承認・却下・実行。広告費を動かすのは人の判断なので、エージェントは下書きで止まり、承認は Loop の受信箱に残ります。

ガードレール・課金・接続・メンバーの変更。自分の上限を上げられる鍵は、上限の意味を無くします。鍵で鍵は作れません。

下書きと断った呼び出しは、鍵の名前で監査ログに残ります。1 本の鍵は 1 分に 60 回まで呼べます。

広告の API を直に呼ばず Loop を通す理由

どの媒体も同じ形。エージェントは 4 つの API と認証を覚えずに、Apple・Google・Meta・TikTok のキャンペーンを同じ欄・ワークスペースの通貨で受け取ります。

まだ決められない数は、そう言う。get_overview は Loop が人に見せる計測の注意を含むので、始めて 2 日のキャンペーンを失敗と読み違えません。

作りの上で人が必ず入る。下書きは予算の上限を確かめた上で承認を待つので、エージェントに提案させても、使わせることにはなりません。

自分のキャンペーンにエージェントをつなぐ

ワークスペースを作り、広告アカウントを 1 つつないで read の鍵を作れば、その日のうちにエージェントが自分のキャンペーンについて答えられます。

14 日間無料。ワークスペースを作るのにカードは要りません。