Google Ads MCP

これはリモートの完全ホスト型サーバーです。 クローン、インストール、実行は必要ありません。以下のエンドポイントを MCP クライアントに設定して、サインインしてください。このリポジトリには接続設定とドキュメントのみが含まれており、サーバーは AdPlug が運用しています。

エンドポイント

https://api.adplug.app/mcp/google-ads

できること

AI アシスタントから平易な言葉で Google Ads を管理、分析できます。MCC 全体の費用やコンバージョンのレポートを取得し、キーワードを調査し、生の GAQL を記述して、変更を確定する前にプレビューする安全な手順で変更を加えられます。費用は通貨記号付きで表示され、ID には常にアカウント名が付与されます。また、MCC の親アカウントは自動検出されるため、login_customer_id を操作する必要はほとんどありません。

PPC のベテランが開発

こんにちは。AdPlug の創業者、Daniel Popa です。パフォーマンスマーケティングに10年以上携わり、1億ドル以上の広告予算を管理してきました。Coca-Cola、Rolex、Boots、British Gas、Europcar、O2、SeedLegals などのブランドで、有料顧客獲得とコンバージョン最適化を担当しました。

今でも毎日 Google Ads と LinkedIn Ads を運用しています。自分が考えるために使う AI と、仕事で使う広告プラットフォームを行き来するのにうんざりして、このサーバーを開発しました。汎用的な API ラッパーではありません。実際のアカウントで必要だった機能を、それぞれのツールとして実装しています。1回の呼び出しで複数アカウントの費用を一覧表示する機能、GAQL のセグメント分割を自動処理するコンバージョンレポート、実際のアカウントに変更を適用する前のプレビュー手順などです。日々の業務で遅いと感じたワークフローは、ツールにしました。

ご質問、機能のご要望、PPC の体験談などがあれば、LinkedIn または [email protected] までご連絡ください。

クイックスタート

接続を認証するには、無料の AdPlug アカウントが必要です。サーバーは OAuth 2.1 を使用します。追加すると、クライアントでブラウザーウィンドウが開き、AdPlug にサインインして Google Ads を接続できます。API キーやトークンを貼り付ける必要はありません。

1. adplug.app でアカウントを作成し、Google Ads を接続します。
2. エンドポイントをクライアントに追加します（以下からお使いのクライアントを選択してください）。
3. OAuth プロンプトを承認します。これで接続完了です。

クライアントに追加

Claude.ai と Claude Desktop

設定 → コネクタ → カスタムコネクタを追加 → 名前と URL を貼り付けます。

項目	値
名前	Google Ads MCP
URL	https://api.adplug.app/mcp/google-ads

ブラウザーウィンドウが開くので、サインインして認証します。これで完了です。

Claude Code（CLI）

claude mcp add --transport http adplug-google-ads https://api.adplug.app/mcp/google-ads

次に、Claude Code 内で /mcp を実行し、OAuth ログインを完了します。

ChatGPT

設定 → コネクタ → 作成（開発者モード／カスタムコネクタ）→ URL https://api.adplug.app/mcp/google-ads を貼り付けて認証します。カスタム MCP コネクタに対応した ChatGPT プランが必要です。

Cursor

または、~/.cursor/mcp.json に手動で追加します。

{
  "mcpServers": {
    "adplug-google-ads": {
      "url": "https://api.adplug.app/mcp/google-ads"
    }
  }
}

VS Code

code --add-mcp '{"name":"adplug-google-ads","url":"https://api.adplug.app/mcp/google-ads"}'

stdio ブリッジが必要なクライアント（Windsurf、旧バージョンのデスクトップアプリ）

mcp-remote を使用して、stdio 経由でリモートサーバーに接続します。OAuth のハンドシェイクは自動的に処理されます。

{
  "mcpServers": {
    "adplug-google-ads": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.adplug.app/mcp/google-ads"]
    }
  }
}

ツール

16 個のツールを用意しています。細分化したツールを多数用意するのではなく、柔軟に使えるツールをいくつか提供します。

ツール	機能
adplug_get_status	Google Ads が接続され、正常に動作しているか確認します。
google_ads_list_accounts	アクセス可能なすべてのアカウントを、名前、種類、通貨、MCC の階層とともに一覧表示します。
google_ads_account_performance	1 回の呼び出しでアカウントを横断して費用を確認します（MCC マネージャーは除外されます）。
google_ads_campaign_performance	GAQL を必要とせず、キャンペーン単位の指標を取得します。
google_ads_conversion_performance	セグメント化を自動的に処理して、コンバージョン アクションの内訳を取得します。
google_ads_daily_trends	日ごとの指標の推移を取得します。
google_ads_search_terms	費用順に並べた検索語句レポートを取得します。
google_ads_shared_set_criteria	共有の除外キーワード リストの内容を取得します。
google_ads_keyword_ideas	キーワード調査とアイデアの提案を行います。
google_ads_gaql_doc	GAQL の構文リファレンスです。
google_ads_reporting_view_doc	レポートビューの正確なフィールド名、型、フィルタリング可否を確認できます。
google_ads_query	カスタムクエリや高度なクエリ向けに、生の GAQL を実行します。
google_ads_preview_mutation	ステータス変更（一時停止／有効化／削除）を確定する前にプレビューします。
google_ads_execute_mutation	プレビューした変更を実行します。
google_ads_preview_add_negatives	除外キーワードの追加（キャンペーン単位または共有リスト）をプレビューします。
google_ads_execute_add_negatives	除外キーワードの追加を実行します。

認証

Dynamic Client Registration を使用した OAuth 2.1 です。クライアントはエンドポイントから認可サーバーを検出し、自身を登録した後、ブラウザーを開いて AdPlug にサインインし、アクセスを許可するよう求めます。AdPlug と Google 間の接続情報はサーバー側に保存され、暗号化されます。MCP クライアントが Google のトークンを参照することはありません。

サーバー設定（ディレクトリへの登録用）

{
  "mcpServers": {
    "adplug-google-ads": {
      "url": "https://api.adplug.app/mcp/google-ads"
    }
  }
}

リンク

• ウェブサイト：https://adplug.app
• ダッシュボードと接続：https://adplug.app/dashboard/connections
• セットアップガイド：https://adplug.app/guides/google-ads
• サポート：[email protected]

AdPlug のその他のサービス

AdPlug は、広告アカウントを Model Context Protocol 経由で AI アシスタントに接続するマーケティングコントロールプレーンです。これは複数ある AdPlug サーバーの 1 つです。

• Google Ads MCP（このサーバー）：https://api.adplug.app/mcp/google-ads
• LinkedIn Ads MCP：https://api.adplug.app/mcp/linkedin-ads
• 統合版（Google Ads と LinkedIn Ads を 1 つのコネクターに統合）：https://api.adplug.app/mcp

1 つの AdPlug アカウントですべてのサービスを利用できます。

ライセンス

このリポジトリの内容（セットアップとドキュメント）には MIT ライセンスが適用されます。ホスティングサービスには独自の利用規約があります。

Google Ads は Google LLC の商標です。AdPlug は独立したインテグレーションであり、Google の推奨を受けておらず、Google と提携していません。