この頁は英語の原文の参考訳です。内容が異なる場合は原文が優先します。
ガイド
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_workspaces | read | 鍵が属するワークスペース、その通貨、鍵の範囲。 |
get_overview | read | 広告費・有料のインストール・インストール単価と前の期間との差、見出し、計測の注意、承認待ちの数。 |
list_campaigns | read | Loop が運用するすべてのキャンペーンの状態・予算と、媒体が報告した広告費・インストール。 |
get_campaign | read | 1 つのキャンペーンの数・日ごとの広告費・承認待ちの提案・実行した変更。 |
list_proposals | read | 受信箱:人を待つ提案、ガードレールが止めている提案、直近の実行と失敗の理由。 |
create_launch_draft | propose | 新しいキャンペーンを下書きする。Loop の入力画面と同じ検査を通り、受信箱で承認を待つ。 |
prepare_campaign_change | propose | 動いているキャンペーンの変更を下書きする:予算の移し替え・総額の上限・上限 CPC・広告グループの追加・広告文・言語・終了日。 |
list_app_events | read | アプリが送る Meta のアプリ内イベント。下書きの最適化のイベントに使える。 |
list_budget_tests | read | ガードレール付きの予算テスト:期間・日の幅・止める条件・最新の判定。 |
エージェントにできないこと
承認・却下・実行。広告費を動かすのは人の判断なので、エージェントは下書きで止まり、承認は Loop の受信箱に残ります。
ガードレール・課金・接続・メンバーの変更。自分の上限を上げられる鍵は、上限の意味を無くします。鍵で鍵は作れません。
下書きと断った呼び出しは、鍵の名前で監査ログに残ります。1 本の鍵は 1 分に 60 回まで呼べます。
広告の API を直に呼ばず Loop を通す理由
どの媒体も同じ形。エージェントは 4 つの API と認証を覚えずに、Apple・Google・Meta・TikTok のキャンペーンを同じ欄・ワークスペースの通貨で受け取ります。
まだ決められない数は、そう言う。get_overview は Loop が人に見せる計測の注意を含むので、始めて 2 日のキャンペーンを失敗と読み違えません。
作りの上で人が必ず入る。下書きは予算の上限を確かめた上で承認を待つので、エージェントに提案させても、使わせることにはなりません。
自分のキャンペーンにエージェントをつなぐ
ワークスペースを作り、広告アカウントを 1 つつないで read の鍵を作れば、その日のうちにエージェントが自分のキャンペーンについて答えられます。
14 日間無料。ワークスペースを作るのにカードは要りません。