google-ads-mcp

Google Ads API 用の読み取り専用 MCP サーバーです。キャンペーン、広告グループ、キーワード、生のGAQLクエリなどのレポーティングツールを公開しているため、MCP クライアント（Claude Code、Claude Desktop など）から Google Ads アカウントをクエリできます。mutate/write ツールはありません — サーがキャンペーン、予算、入札を変更することはできません。

ツール

前提条件

Google Ads API の認証情報が必要です。

1. 認証に使用するマネージャー（MCC）アカウントの Google Ads API Center（ツールと設定 → API Center）から取得した developer token。

2. Google Ads API を有効にした Google Cloud プロジェクトから取得した OAuth2 の client ID / client secret。

3. ターゲットのアカウントに対するアクセス権を持つユーザーの refresh token。Google の OAuth デスクトップフローガイ を参照するか、google-ads Python ライブラリに同梱のヘルパースクリプトを実行してください。

4. マネージャー（MCC）アカウントを介してクライアカルアントの代わりに認証する場合、その login_customer_id。

設定

# from the repo root
pip install -e .

認証情報は次のいずれの方法で設定します。

オプション A: YAML ファイル

cp google-ads.yaml.example google-ads.yaml
# edit google-ads.yaml with your values

オプション B: 環境変数

cp .env.example .env
# edit .env, then export the variables into your shell environment

カレンとディレクトリの google-ads.yaml、ま たは GOOGLE_ADS_* 環境変数が自動的に読み込まれます。別の場場所の YAML ファイルを指定する場合は、GOOGLE_ADS_CONFIGURATION_FILE_PATH を設定してください。

単独実行

python -m google_ads_mcp
# or, after `pip install -e .`:
google-ads-mcp

サーバーは MCP 仕様に従って、stdio で通信します。

MCP クライアントへの登録

Claude Code（プロジェクトレベルの .mcp.json、または claude mcp で追加）:

{
  "mcpServers": {
    "google-ads": {
      "command": "google-ads-mcp",
      "env": {
        "GOOGLE_ADS_CONFIGURATION_FILE_PATH": "/absolute/path/to/google-ads.yaml"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json) も同様です。

セキュリティ上の注意

• このサーバーは GoogleAdsService.SearchStream を介して GAQL SELECT クエリのみを発行します。GAQL には INSERT/UPDATE/DELETE 構文がないため、 これらのツールを介して Google Ads のデータを変更することはできません。

• google-ads.yaml や .env をコミットしないでください。どちらも gitignore 対象です。developer token、OAuth client secret、refresh token は認証情報として扱ってください。

• customer_id および エンティティ ID は、GAQL クエリ文字列に埋め込まれる前に数値として検証されます。