Google Ads MCP Server

Google Ads 管理のための完全な MCP サーバー。完全な CRUD、可視化ダッシュボード、レポート、Google Ads パネルで利用可能なすべての機能の管理を提供します。

機能 (85以上のツール)

アカウント & クライアント

• list_accessible_customers — アクセス可能なアカウントを一覧表示

• get_customer_details — アカウントの詳細

• list_customer_clients — MCC 配下のクライアント

• update_customer — 設定を更新

• get_account_hierarchy — アカウント階層

• get_change_history — 変更履歴

キャンペーン (完全な CRUD)

• list_campaigns — フィルター付きでキャンペーンを一覧表示

• get_campaign — キャンペーンの完全な詳細

• create_campaign — キャンペーンを作成 (検索、ディスプレイ、ショッピング、動画、パフォーマンスマックスなど)

• update_campaign — 名前、ステータス、入札、日付を更新

• remove_campaign — キャンペーンを削除

• get_campaign_performance — パフォーマンス指標

• copy_campaign — キャンペーン設定をコピー

広告グループ (完全な CRUD)

• list_ad_groups — 広告グループを一覧表示

• get_ad_group — グループの詳細

• create_ad_group — 広告グループを作成

• update_ad_group — 設定を更新

• remove_ad_group — グループを削除

• get_ad_group_performance — パフォーマンス指標

広告 (完全な CRUD)

• list_ads — 広告を一覧表示

• get_ad — 広告の詳細

• create_responsive_search_ad — 見出しと説明文でレスポンシブ検索広告を作成

• update_ad_status — 広告を有効化/一時停止

• remove_ad — 広告を削除

• get_ad_performance — パフォーマンス指標

キーワード (完全な CRUD)

• list_keywords — 品質スコア付きでキーワードを一覧表示

• add_keywords — キーワードを追加 (完全一致、フレーズ一致、部分一致)

• update_keyword — 入札、ステータス、URL を更新

• remove_keyword — キーワードを削除

• get_keyword_performance — インプレッションシェアを含むパフォーマンス

• get_search_terms — 検索語句レポート

• add_negative_keywords — 否定キーワードを追加 (キャンペーンまたはグループ)

予算 & 入札戦略

• list_budgets — 予算を一覧表示

• create_budget — 予算を作成

• update_budget — 金額/配信方法を更新

• remove_budget — 予算を削除

• list_bidding_strategies — 戦略を一覧表示

• create_bidding_strategy — 戦略を作成 (目標 CPA、目標 ROAS など)

• update_bidding_strategy — 戦略を更新

• remove_bidding_strategy — 戦略を削除

オーディエンス & ターゲティング

• list_audiences — オーディエンス/ユーザーリストを一覧表示

• get_audience_performance — オーディエンスのパフォーマンス

• list_campaign_targeting — ターゲティング基準

• add_campaign_location_targeting — 地域ターゲティング

• add_campaign_language_targeting — 言語ターゲティング

• add_ad_schedule — 広告スケジュール (曜日・時間帯)

• remove_campaign_criterion — 基準を削除

• get_geo_target_constants — 地域ターゲット定数を検索

• get_demographics_performance — デモグラフィックのパフォーマンス

アセット & 拡張機能

• list_assets — すべてのアセットを一覧表示

• create_sitelink_asset — サイトリンクを作成

• create_callout_asset — コールアウトを作成

• create_structured_snippet_asset — 構造化スニペットを作成

• create_call_asset — 電話番号拡張機能を作成

• create_price_asset — 価格拡張機能を作成

• create_promotion_asset — プロモーション拡張機能を作成

• create_lead_form_asset — リードフォームを作成

• link_asset_to_campaign — アセットをキャンペーンにリンク

• link_asset_to_ad_group — アセットを広告グループにリンク

• remove_asset — アセットを削除

• get_asset_performance — アセットのパフォーマンス

• list_campaign_assets — キャンペーンのアセット

• remove_campaign_asset — アセットのリンクを解除

コンバージョン

• list_conversion_actions — コンバージョンアクションを一覧表示

• get_conversion_action — コンバージョンの詳細

• create_conversion_action — コンバージョンアクションを作成

• update_conversion_action — コンバージョンを更新

• remove_conversion_action — コンバージョンを削除

• get_conversion_performance — コンバージョンのパフォーマンス

レポート & ダッシュボード

• execute_gaql_query — カスタム GAQL クエリを実行

• get_account_dashboard — アカウントの完全なダッシュボード

• get_campaign_dashboard — キャンペーンの詳細ダッシュボード

• get_performance_by_device — デバイス別パフォーマンス

• get_performance_by_network — ネットワーク別パフォーマンス

• get_performance_by_hour — 時間別パフォーマンス

• get_performance_by_day_of_week — 曜日別パフォーマンス

• get_geographic_performance — 地域別パフォーマンス

• get_landing_page_performance — ランディングページのパフォーマンス

• compare_date_ranges — 期間を比較

ラベル & 共有セット

• list_labels — ラベルを一覧表示

• create_label — ラベルを作成

• remove_label — ラベルを削除

• apply_label_to_campaign — ラベルをキャンペーンに適用

• apply_label_to_ad_group — ラベルを広告グループに適用

• list_shared_sets — 共有リストを一覧表示

• create_shared_set — 共有否定リストを作成

• add_shared_set_criteria — リストに語句を追加

• link_shared_set_to_campaign — リストをキャンペーンにリンク

推奨 & 最適化

• list_recommendations — Google の推奨事項を一覧表示

• apply_recommendation — 推奨事項を適用

• dismiss_recommendation — 推奨事項を無視

• get_optimization_score — 最適化スコア

実験 & 変更

• list_experiments — A/B テストを一覧表示

• list_experiment_arms — バリアントを一覧表示

• get_change_status — 最近の変更

前提条件

1. Google Cloud Project で Google Ads API が有効になっていること

2. OAuth2 クライアント ID (デスクトップタイプ)

3. Google Ads 開発者トークン (ads.google.com > API センターで取得)

4. Node.js >= 18

インストール

npm install
npm run build

設定

オプション 1: 環境変数

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

オプション 2: 対話型セットアップ

npm run auth

これにより、~/.google-ads-mcp/credentials.json に資格情報ファイルが作成されます。

Claude Code での設定

~/.claude/settings.json に追加します:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

使用方法

設定後、すべてのツールが MCP 経由で利用可能になります。例:

• "アクティブなキャンペーンをすべて一覧表示して"

• "1日あたり R$50 の予算で検索キャンペーンを作成して"

• "過去30日間のパフォーマンスダッシュボードを表示して"

• "これらのキーワードを広告グループ X に追加して: ..."

• "キャンペーン Y を一時停止して"

• "検索語句レポートを表示して"

• "私のアカウントに対する Google の推奨事項は何ですか?"

API バージョン

このサーバーは Google Ads API v23 (最新版、2026年1月リリース) を使用しています。

プロジェクト構造

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions