MCP 経由で Snapchat Ads を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Snapchat Ads をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Snapchat Ads + Gemini

AI に Snapchat 広告を操作させます。組織、広告アカウント、キャンペーン、広告セット（Ad Squad）、広告、クリエイティブ、オーディエンスの一覧、日別または合計のインプレッション、スワイプ、費用の参照ができ、確認のうえでキャンペーンの一時停止や再開もできます。サインインには Snap Business Manager の自分の OAuth アプリを使います。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

SNAPCHAT_CLIENT_ID, SNAPCHAT_CLIENT_SECRET

ステップ 1 — 認証情報を取得

1. Organization Admin として business.snapchat.com にサインインします。OAuth アプリの設定が見えるのは管理者だけです。
2. Business Details（または Business Settings）→ OAuth Apps を開き、アプリを作成します。名前を付け、Redirect URI に https://cloud.anythingmcp.com/api/mcp-oauth/callback を設定します。AnythingMCP を自分でホストしている場合は https://your-anythingmcp-host/api/mcp-oauth/callback を使います。Snap Developer Terms と Snap Business Tools Terms に同意します。
3. Client ID を SNAPCHAT_CLIENT_ID に、Client Secret を SNAPCHAT_CLIENT_SECRET にコピーします。シークレットは一度しか表示されません。なくした場合は新しいアプリを作成してください。
4. コネクタをインストールし、コネクタのページで Authorize with Provider をクリックして、広告アカウントにアクセスできる Snapchat アカウントでサインインし、承認します。
5. まず snapchat_list_organizations を使います。組織と、その広告アカウント、通貨、タイムゾーンが一覧表示されます。

Marketing API はすべての広告主に開放されており、Snap への申請や審査はありません。

誰が何を見られるか: コネクタはスコープ snapchat-marketing-api を要求し、サインインしたユーザーが Ads Manager で見られるものだけを見ます。そのユーザーにロールのない広告アカウントは 403 を返します。

参照できるもの: 組織と広告アカウント。目的、期間、1 日の予算、費用上限を含むキャンペーン。配置、最適化の目標、入札額、予算、ターゲティングを含む Ad Squad（Snapchat の広告セット）。審査ステータスと却下理由付きの広告。クリエイティブ。顧客リストや類似オーディエンスなどのオーディエンスセグメントと、そのおおよその規模。統計では、広告アカウント、キャンペーン、Ad Squad、広告ごとに、インプレッション、スワイプ、費用などの指標を、合計、日別（最大 31 日）、時間別（最大 7 日）で取得でき、キャンペーン、Ad Squad、広告ごとに分けることもできます。

金額はマイクロ単位: Snapchat は予算、入札額、費用をアカウント通貨の 100 万分の 1 単位で表します。費用 12345678 は 12.35 です。AI は数字を換算してから伝えます。数値は 1 日の終わりから 48 時間後に確定します。

変更の前には必ず確認します: snapchat_set_campaign_status はキャンペーンを一時停止したり再開したりします。再開すると予算の消化が始まるため、AI は対象のキャンペーンと何が起きるかを伝え、あなたの承認を待ちます。変わるのはステータスだけです。その後 Snapchat がキャンペーン全体を確認し、無効な点があれば変更を拒否します。

インストール時に無効: snapchat_set_campaign_daily_budget。予算の変更は使う金額を決めるため、管理者が意図して有効にします。有効にした場合も、AI は変更内容を示して事前に確認します。

サインインの維持: アクセストークンの有効期間は 1 時間で、自動的に更新されます。ユーザーが組織から外されるか、アプリが削除されるとサインインは終了します。その場合はもう一度 Authorize with Provider をクリックしてください。

よくあるエラー: 401: サインインの期限が切れたか取り消されました。再度認可してください。403: ユーザーがその組織や広告アカウントにロールを持っていません。400: Snapchat がメッセージで該当の項目を示します（ステータス変更が拒否された場合など）。統計では、指標を減らすか期間を短くしてください。429: リクエストが多すぎます。待ってから再試行してください。

このコネクタは、キャンペーン、Ad Squad、広告、クリエイティブの作成や削除、メディアのアップロード、ターゲティングの変更には対応しておらず、Conversions API、ピクセル、請求、請求書も扱いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Snapchat Ads のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先週の Snapchat の費用をキャンペーンごとに、インプレッションとスワイプ付きで教えて。」
• 「審査で却下された広告はどれ？理由も教えて。」
• 「Summer Sale キャンペーンの 10 月 1 日から 14 日までの日別の費用とスワイプを見せて。」
• 「Back to School キャンペーンを一時停止して。その前に何が起きるかを正確に教えて。」
• 「ターゲティングに使えるオーディエンスセグメントを、おおよその規模付きで一覧にして。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続