mcpField
G
Google Ads

Google Ads

ローカル
getmcpads.comビジネス・マーケティング13 日前に更新

Google Ads について

Google Adsは、アカウントの実績確認、キーワード調査、キャンペーン変更の準備に使うMCPサーバーです。13個の書き込みツールは初期状態で無効で、適用前のプレビューと明示的な確認が必要です。

主な機能

  1. 01レポートとアカウント情報の35ツール
  2. 02キーワード案、指標、予測
  3. 03指標とディメンションの組み合わせ検証
  4. 04GAQLクエリと読み取り専用RPCの実行
  5. 05プレビューと確認付きの任意の書き込み13種
  6. 06指標、ディメンション、ワークフローのリソース

活用シーン

  1. 01キャンペーン、予算、入札実績の確認
  2. 02キーワード候補と予測の調査
  3. 03API呼び出し前のクエリ互換性確認
  4. 04人による確認に向けたキャンペーン変更の準備

MCP 対応

Google Adsの読み取りツール、保護された任意の書き込みツール、カタログリソースをMCPクライアントに公開します。プラットフォーム認証情報を使ってstdio経由でローカル実行し、書き込みには有効化と明示的な確認が必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"com-getmcpads-google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
"GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
"GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
"GOOGLE_ADS_ACCOUNT_IDS": "<GOOGLE_ADS_ACCOUNT_IDS>",
"GOOGLE_ADS_ENABLE_WRITES": "<GOOGLE_ADS_ENABLE_WRITES>"
}
}
}
}
起動コマンドnpx -y @getmcpads/google-ads-mcp-server
設定が必要な環境変数
GOOGLE_ADS_DEVELOPER_TOKENシークレットGoogle Ads API developer token, Basic Access or above.
GOOGLE_ADS_CLIENT_IDOAuth client ID.
GOOGLE_ADS_CLIENT_SECRETシークレットOAuth client secret.
GOOGLE_ADS_REFRESH_TOKENシークレットOAuth refresh token.
GOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) account ID, when the customer sits under one.
GOOGLE_ADS_ACCOUNT_IDSComma-separated customer IDs every tool is limited to. Optional in 2.x, required in 3.0.0.
GOOGLE_ADS_ENABLE_WRITESSet to true to expose 13 write tools. Calls preview by default; confirm:true applies changes.

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@getmcpads/google-ads-mcp-server2.1.1

ツール

35

掲載時のツール一覧 · 3 日前に更新

このツールにパラメーターはありません。

詳細

Google Ads MCP サーバー

Google Adsに関する質問を、役立つ回答に変えます。

MCP クライアントからパフォーマンスを確認し、キーワードを調査して、キャンペーンの変更を準備できます。

リリース CI Smithery ライセンス:Apache 2.0 Node

動画を見る · 最新情報 · インストール · ツールリファレンス · ホスト版getmcpadsを試す

getmcpadsの動画を見る:AI アシスタントとの会話で、すべての広告アカウントを管理

45秒の動画を再生

動画では、サンプルデータを使ったホスト版getmcpadsを紹介しています。クリエイティブギャラリーやアラートから、Google Sheetsへのエクスポートや一括ローンチまで、MCP Appsはホスト版製品に含まれます。このリポジトリでは、単独で動作するネイティブAPIツールを提供します。

読み取りツール35個 · 書き込みツール13個(デフォルトでは無効)。

独自のプラットフォーム認証情報と、Claude Desktop、Claude Code、Cursorなどstdio MCPに対応するクライアントを使って、ローカルで実行できます。リクエストはプラットフォームに直接送信されます。対応するChatGPTのセットアップを含む、管理型の接続にはホスト版をご利用ください。

最新情報

v2.1.1:Zod 4セキュリティアップデート · 2026年10月26日

  • zodを4.6.7に更新しました。4.6.6より前のZodリリースはすべて、深刻度の高い勧告GHSA-mrhx-c7xc-m3w5の対象です。サイズ制限のある大きなコレクションを検証するとメモリを使い果たす可能性があり、この修正を含むZod 3のリリースはありません。npm audit --omit=devで再び脆弱性が報告されなくなりました。
  • Zod 3の検証動作を維持します。パラメーターのデフォルト値は使用前に引き続き検証・補完されるため、省略されたオブジェクトにも必須フィールドを指定する必要があります。
  • パラメーターがオプションの場合やデフォルト値を持つ場合も、各パラメーター固有の説明を維持します。Zod 4ではラップされたスキーマにのみ説明が保存されるため、そうしないと共有のフォールバック説明で置き換えられる可能性があります。
  • MCP経由で公開されるツール名、パラメーター、説明に変更はありません。server-card.jsonはZod 4のJSON Schema出力で再生成されており、一部の制約の表記が異なります。

以前のリリース

バージョン日付主な変更点
2.1.02026年10月23日名前の変更、Google Ads API v26、Search Lift
2.0.12026年9月23日パブリックリポジトリを復元
2.0.02026年9月20日ゲートウェイの同期とセキュリティ修正
1.1.02026年9月13日プラットフォーム機能の同期と品質コントラクト
1.0.22026年8月30日パッケージのバージョンをMCP経由で通知。
1.0.12026年8月30日公式MCP Registry向けに、com.getmcpads/google-adsのserver.jsonとmcpNameを追加。
1.0.02026年8月29日最初のオープンソースリリース

変更履歴の全文 · すべてのリリース

ソースの同期:SOURCE_SYNC.md。

アップグレードに関する注意事項

Node.js 22.23.4、24.22.1、または26.12.1、あるいはこれらの系列のより新しいリリースが必要です。古いリリースには2026年10月のセキュリティ修正が含まれておらず、それらのリリースでサーバーを起動すると、stderr に警告が出力されます。CI では Node 22、24、26 を対象としています。

このリリースでは、設定に破壊的変更はありません。3.0.0 に向けて、次の2つの変更をお知らせします。

  • 2.x では GOOGLE_ADS_ACCOUNT_IDS は任意です。設定すると、すべてのツールで対象が指定された顧客に限定されます。設定しない場合、サーバーはこれまでどおり起動し、stderr に設定を推奨する1行が出力されます。3.0.0 では必須になります。
  • GOOGLE_ADS_ENABLE_WRITES は引き続き 1、yes、on を受け付け、stderr に非推奨を知らせる1行が出力されます。3.0.0 で受け付ける唯一の値である true を使用してください。

サーバーでは Google Ads API v26 が固定されています。google_ads_run_gaql および google_ads_run_readonly_rpc を通じて送信される生クエリも v26 に準拠します。customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled を読み取るクエリ、または ad_group_bid_modifier のホテル関連フィールドを読み取るクエリでは、Google の v26 リリースノートに記載されている v26 の名前を使用する必要があります。書き込みは引き続き任意で、明示的な確認が必要です。

このリリースをインストールする

これは GitHub のソースリリースです。npm と MCP Registry のバージョンは別途公開されます。以下のコマンドではこの特定のバージョンを指定しています。このドキュメントの後半にある、バージョンを固定していない npx の例では、npm で現在入手できるバージョンが選択されます。

git clone --branch v2.1.1 --depth 1 https://github.com/get-mcp-ads/google-ads-mcp-server.git
cd google-ads-mcp-server
npm ci
npm run build

MCP クライアントが node を実行し、絶対パスで dist/cli.js を指定するよう設定してください。また、以下に記載するプラットフォームの認証情報を設定してください。

管理された接続をお望みですか? ホスト型 getmcpads で Google Ads を使用する。アカウントを接続し、アシスタントがアクセスできるデータを選択して、ホスト型 MCP 接続を使用できます。現在の機能とプランについては、サイトをご覧ください。

利用できる機能

35 個の読み取りツールキャンペーン、広告グループ、予算、入札戦略、検索語句、ランディングページ、Performance Max アセットとプレースメント、ショッピング、推奨事項、変更履歴
13 個の書き込みツールデフォルトでは無効です。ステータス、予算、入札単価、スケジュール、名前変更、キャンペーン作成に対応しています。各ツールは適用前にプレビューを表示します
Keyword Planner の全機能キーワード候補、過去の指標、予測、広告グループのテーマ、地域ターゲットの候補
145 個の指標、88 個のディメンションAPI に送信する前に無効な組み合わせを検出する互換性マトリックス付き
Google Ads API v26このリリースで固定されているバージョンです。lift_measurement_config から読み取る Search Lift 指標も含まれます
5 個のリソースモデルが読み取れる最新のカタログです。指標、ディメンション、互換性ルール、11 個のワークフローレシピを収録しています
GAQL など生クエリ用の google_ads_run_gaql と、GAQL ではアクセスできないサービス用の google_ads_run_readonly_rpc
GAQL の知識は不要です

Google Ads API へのクエリには独自のクエリ言語である GAQL を使用します。また、API の大部分にはこの方法でしかアクセスできません。このサーバーには指標とディメンションのカタログが用意されているため、モデルが cost や conversions を名前で指定すると、サーバーがクエリを作成します。

google_ads_validate_query を使うと、API を呼び出す前に組み合わせを検証できます。また、自分で GAQL を書きたい場合は google_ads_run_gaql も利用できます。

Keyword Planner は GAQL では利用できません

キーワード候補、過去の検索ボリューム、予測は、GAQL からは一切アクセスできない別の RPC サービスにあります。Reach Planner、オーディエンス分析、ベンチマークも同様です。このサーバーでは、google_ads_run_readonly_rpc と専用ツールを通じてこれらの機能を利用できます。


認証情報の取得

広告プラットフォームの中でも、セットアップが最も複雑です。4つの値が必要で、そのうち1つは Google による審査が必要です。初回は1時間ほどを見込んでください。

1. デベロッパートークン

マネージャー(MCC)アカウントから、ツール → API Centerを開き、トークンを申請します。 最初は テストアカウント レベルで、テストアカウントにしかアクセスできません。実際のアカウントにアクセスするには、Basic Accessを申請してください。Google による審査には数日かかることがあります。

📖 デベロッパートークンのドキュメント

2. OAuth クライアント

Google Cloud プロジェクトでGoogle Ads APIを有効にし、API とサービス → 認証情報で OAuth クライアントを作成します。ローカルで使用する場合は、デスクトップアプリを選択してください。クライアント IDとクライアントシークレットを控えておきます。

3. リフレッシュトークン

広告アカウントを確認できる Google アカウントでログインし、OAuth 同意フローを一度実行して、返されるリフレッシュトークンを保管します。Google が提供するヘルパースクリプトを使えば、1 つのコマンドで実行できます。

📖 OAuth デスクトップフロー

**リフレッシュトークンの有効期限はありません。**これはここで扱う機密情報です。これを持つ人は誰でも、無期限にアクセストークンを発行できます。パスワードと同様に扱い、このサーバー専用の OAuth クライアントを使用して、必要なときにそのクライアントだけを失効できるようにしてください。

4. ログイン顧客 ID(マネージャーアカウントを使用する場合)

照会するアカウントが MCC の配下にある場合は、GOOGLE_ADS_LOGIN_CUSTOMER_ID にマネージャーアカウント ID を設定します。ハイフンは使用でき、自動的に取り除かれます。単独のアカウントの場合は設定不要です。

設定しないままにすることもできます。Google は、管理対象アカウントへのリクエストにマネージャーの指定がない場合、アカウント名もマネージャー名も示さない USER_PERMISSION_DENIED を返すため、ヘッダーがないというよりアクセス権がないように見えます。この変数が未設定で、照会するアカウントに直接アクセスできない場合、サーバーはアクセス可能なマネージャーに保有アカウントを問い合わせ、該当アカウントを保有するマネージャーを通知します。この照会は一度だけ行われ、プロセスが終了するまで結果が保持されます。

変数を設定したほうが処理は速くなります。探索処理を完全に省略できるため、照会するすべてのアカウントが同じ MCC の配下にある場合は、設定することをおすすめします。

最初の呼び出しでは google_ads_health_check を実行してください。4 つの認証情報をすべて検証し、実際にアクセスできるアカウントを一覧表示して、不足している項目を報告します。秘密情報が出力されることはありません。


セットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) または %APPDATA%\Claude\claude_desktop_config.json(Windows):

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/google-ads-mcp-server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
        "GOOGLE_ADS_CLIENT_ID": "your-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_ADS_ACCOUNT_IDS": "123-456-7890"
      }
    }
  }
}

Claude Desktop を再起動します。「Google Ads アカウントを一覧表示して」と尋ねてください。

Claude Code
claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=... --env GOOGLE_ADS_CLIENT_ID=... --env GOOGLE_ADS_CLIENT_SECRET=... --env GOOGLE_ADS_REFRESH_TOKEN=... -- npx -y @getmcpads/google-ads-mcp-server
Cursor

プロジェクト内の .cursor/mcp.json に、上記の Claude Desktop の設定と同じ形式で記述します。

ソースから
git clone https://github.com/get-mcp-ads/google-ads-mcp-server.git
cd google-ads-mcp-server
npm install && npm run build
cp .env.example .env   # then fill in your credentials
npm start
設定
変数デフォルト値説明
GOOGLE_ADS_DEVELOPER_TOKENなし**必須。**API Center から取得します。Basic Access 以上が必要です
GOOGLE_ADS_CLIENT_IDなし**必須。**OAuth クライアント ID
GOOGLE_ADS_CLIENT_SECRETなし**必須。**OAuth クライアントシークレット
GOOGLE_ADS_REFRESH_TOKENなし**必須。**同意フローから取得します
GOOGLE_ADS_LOGIN_CUSTOMER_IDなし任意。マネージャー(MCC)アカウント ID。未設定の場合は自動的に解決されます
GOOGLE_ADS_ACCOUNT_IDS未設定推奨。すべてのツールがアクセスできるアカウントを制限する、カンマ区切りの顧客 ID。未設定の場合、認証情報でアクセスできるすべてのアカウントを利用できます。3.0.0 では必須です
GOOGLE_ADS_ENABLE_WRITES未設定書き込みツール 13 個を登録するには、true に設定します。1、yes、on も引き続き使用できますが、非推奨を示すメッセージが出力されます
LOG_LEVELinfodebug、info、warn、error

セットアップはいつでも確認できます。

npm run doctor

書き込みと、事前プレビューを行う理由

書き込みツールはデフォルトで無効です。GOOGLE_ADS_ENABLE_WRITES=true で有効にしてください。 Google 独自の Google Ads MCP server は読み取り専用なので、この部分は注意してお読みください。

有効にすると、すべての書き込みツールはプレビューを返し、何も変更しません。

// google_ads_update_campaign_budget { customerId: "123-456-7890", budgetId: "555", dailyAmount: 50 }
{
  "applied": false,
  "action": "google_ads_update_campaign_budget",
  "change": { "customer": "1234567890", "budget": "555",
              "newDailyBudget": 50, "inMicros": 50000000 },
  "message": "Preview only, nothing was changed. Repeat the same call with confirm: true to apply this change to the live account."
}

confirm: true を付けた 2 回目の呼び出しでのみ、実際のアカウントが変更されます。

これは意図的な設計です。アシスタントがこれらの呼び出しを組み立てるため、誤った顧客やキャンペーンを選んだり、予算の桁を間違えたりする可能性があります。必須のプレビューによって、費用が発生する前に間違いを確認でき、プロトコル自体では保証されない、人が処理を止められるタイミングを設けます。

さらに、次の 2 つの安全策があります。

  • google_ads_create_campaign は、キャンペーンを必ず PAUSED の状態で作成します。 有効な状態で作成するオプションはありません。費用が発生する前に、誰かが内容を確認する必要があります。
  • 金額は自動的にマイクロ単位に変換されます。 Google では金額を百万分の 1 単位で保持するため、アカウントの通貨で 12.50 は 12500000 です。プレビューには両方の値が表示されるので、1,000 倍の間違いも適用前に確認できます。
ツール変更内容
google_ads_update_campaign_status / google_ads_update_adgroup_status一時停止、再有効化、または削除
google_ads_update_campaign_budget1 日の予算
google_ads_update_adgroup_bidデフォルトの CPC 入札単価
google_ads_update_campaign_schedule開始日と終了日
google_ads_rename_campaign / google_ads_rename_adgroup / google_ads_rename_asset_group / google_ads_rename_account名前のみ。広告の名前は変更できません。Google では広告名は変更不可です
google_ads_create_campaign予算を作成してからキャンペーンを作成します。状態は必ず PAUSED です

ツール

すべてのツールを以下に記載しています。パラメーターと出力の完全なスキーマについては、server-card.json をご覧ください。

35 個の読み取りツール | ツール | 目的 | | --- | --- | | `google_ads_list_accounts` | 現在の認証情報でアクセスできる Google Ads の顧客アカウントを一覧表示します。 | | `google_ads_get_account_details` | 指定した Google Ads の顧客アカウントの詳細情報を取得します。 | | `google_ads_run_gaql` | GAQL(Google Ads Query Language)のクエリをそのまま実行します。 | | `google_ads_get_insights` | インテリジェントなクエリ計画により、Google Ads のパフォーマンスに関するインサイトを照会します。 | | `google_ads_get_campaigns` | Google Ads アカウントのキャンペーンを、ステータス、予算、チャネルタイプ、入札戦略とともに一覧表示します。 | | `google_ads_get_adgroups` | Google Ads アカウントの広告グループを一覧表示します。必要に応じてキャンペーンで絞り込めます。 | | `google_ads_get_keyword_performance` | `keyword_view` リソースからキーワード単位のパフォーマンスデータを取得します。 | | `google_ads_validate_query` | クエリを実行する前に、指標、ディメンション、リソースの互換性を検証します。 | | `google_ads_health_check` | 読み取り専用の接続チェックを行います。 | | `google_ads_get_account_hierarchy` | アクセス可能な顧客と、可能な場合は GAQL の `customer_client` から取得した管理者/クライアント関係を一覧表示します。 | | `google_ads_get_conversion_actions` | コンバージョン アクションを一覧表示します。対応している場合、ステータス、タイプ、カテゴリ、主要/コンバージョンに含めるフラグ、所有者の顧客、最終アクティビティ日も含まれます。 | | `google_ads_get_change_events` | 最近の `change_event` 行を取得します。 | | `google_ads_get_recommendations` | Google Ads の最適化案を一覧表示します。対応している場合、タイプ、リソース、キャンペーン/広告グループとの関連、適用除外の状態、効果も含まれます。 | | `google_ads_get_budgets` | キャンペーン予算を一覧表示します。対応している場合、金額、ステータス、配信方法、おすすめの予算フィールドも含まれます。 | | `google_ads_get_bidding_strategies` | ポートフォリオ入札戦略を一覧表示します。 | | `google_ads_get_search_terms` | `reportType` に応じて、`search_term_view` または `campaign_search_term_insight` から検索語句のパフォーマンスを取得します。 | | `google_ads_get_landing_pages` | `landing_page_view` のパフォーマンスを取得します。対応している場合、最終ページ URL、キャンペーン/広告グループのコンテキスト、トラフィック、コンバージョン、ランディングページの品質指標も含まれます。 | | `google_ads_get_pmax_assets` | `asset_group_asset` から P-MAX のアセットグループのアセットを一覧表示します。アセットグループ/キャンペーンのコンテキストと、オプションの日付範囲別パフォーマンス指標も取得できます。 | | `google_ads_get_simulations` | キャンペーン、広告グループ、またはポートフォリオの入札シミュレーションに関する読み取り専用のプランニング/予測クエリを実行します。 | | `google_ads_get_paid_organic_search_terms` | 有料/オーガニック検索語句レポートを読み取り専用で取得します。 | | `google_ads_get_shopping_products` | `shopping_product` を通じて、Merchant Center の商品カタログ/掲載資格レポートを読み取り専用で取得します。 | | `google_ads_get_shopping_performance` | Merchant Center の商品ディメンションをキーとするショッピングのパフォーマンスレポートを読み取り専用で取得します。 | | `google_ads_get_pmax_placements` | `performance_max_placement_view` から P-MAX のプレースメント診断情報を読み取り専用で取得します。 | | `google_ads_get_pmax_asset_diagnostics` | P-MAX のアセットグループ診断情報を読み取り専用で取得します。 | | `google_ads_list_image_assets` | アカウントの画像アセットライブラリ(`FROM asset`)を一覧表示します。`tpc.googlesyndication.com` で公開配信される安定したフルサイズ URL、寸法、ファイルサイズ、MIME タイプが含まれます。 | | `google_ads_list_video_assets` | アカウントの YouTube 動画アセット(`FROM asset`)を一覧表示します。生成された視聴用、埋め込み用、公開サムネイル用 URL が含まれます。 | | `google_ads_get_demand_gen_assets` | Demand Gen 広告(動画レスポンシブ広告、複数アセット広告、カルーセル広告)を一覧表示し、参照されているクリエイティブを解決します。安定した画像 URL と、埋め込み用およびサムネイル用 URL を備えた YouTube 動画 ID が含まれます。 | | `google_ads_generate_keyword_historical_metrics` | 指定したキーワードの Keyword Planner 検索ボリューム履歴を取得します。 | | `google_ads_generate_keyword_ideas` | 最大 20 個のシードキーワード、URL、キーワードと URL の組み合わせ、またはサイト全体から Keyword Planner の候補を見つけます。 | | `google_ads_generate_keyword_forecast_metrics` | 一時的なキーワードキャンペーンのクリック数、CPC、費用、コンバージョン数、CPA を予測します。 | | `google_ads_search_fields` | Google の最新の GoogleAdsField カタログを検索します。 | | `google_ads_suggest_geo_targets` | 最大 25 個の地域名または地域ターゲット ID を Google Ads の `geoTargetConstants` に解決します。 | | `google_ads_generate_ad_group_themes` | 指定したキーワードを既存の Google Ads 広告グループに整理します。 | | `google_ads_run_readonly_rpc` | GAQL の対象外にある許可リスト登録済みの Google Ads サービス向けの、高度な読み取り専用の代替手段です。Audience Insights、Reach Planner、ベンチマーク、クリエイター/トレンドに関するインサイト、ターゲティング候補、スマートキャンペーン候補、本人確認、請求書、支払いアカウントに対応します。 | | `google_ads_get_video_upload` | 選択した顧客における 1 件の Google Ads アップロードについて、処理状態と YouTube 動画 ID を読み取ります。 |
13 個の書き込みツール

デフォルトでは無効です。明示的に確認されない限り、呼び出しはプレビューを行います。使用前に設定と正確なスキーマを確認してください。

ツール目的
google_ads_upload_video選択した広告アカウントの Google 管理 YouTube チャンネルに、MP4/WebM/QuickTime のデータ(最大 16 MiB)をアップロードします。
google_ads_remove_video_upload選択した広告アカウントが所有する動画アップロードを削除します。
google_ads_apply_planキャンペーン、予算、広告グループ、RSA/ディスプレイ/Demand Gen 広告、画像/テキスト/YouTube アセット、PMax アセットグループとリンク、キーワード、地域/言語ターゲティング、掲載グループ、コンバージョン アクションの設定(コンバージョン イベントのアップロードは含みません)について、Google Ads v26 の構築/変更プランをプレビュー、検証し、アトミックに適用します。
google_ads_update_campaign_statusGoogle Ads キャンペーンを一時停止、再有効化、または削除します。
google_ads_create_campaignGoogle Ads キャンペーンを作成します。
google_ads_update_campaign_budgetGoogle Ads キャンペーンの日予算を変更します。
google_ads_rename_campaignGoogle Ads キャンペーンの名前を変更します。
google_ads_rename_adgroupGoogle Ads 広告グループの名前を変更します。
google_ads_rename_asset_groupGoogle Ads Performance Max アセットグループの名前を変更します。
google_ads_rename_accountGoogle Ads アカウントの名前(説明用の名前)を変更します。
google_ads_update_campaign_scheduleGoogle Ads キャンペーンの開始日または終了日を変更します。
google_ads_update_adgroup_statusGoogle Ads 広告グループを一時停止、再有効化、または削除します。
google_ads_update_adgroup_bidGoogle Ads 広告グループのデフォルト CPC 入札単価を変更します。
5 個のリソース
URI内容
google-ads://manifestこのサーバーが公開する内容と、最初に実行するツール
google-ads://metricsカテゴリと形式を含む全 145 個の指標
google-ads://dimensions全 88 個のディメンションと、それらを使用できる場所
google-ads://compatibility互換性マトリックス
google-ads://recipes11 個のステップごとのワークフロー

セキュリティ

このサーバーは、有効期限のないリフレッシュトークン、クライアントシークレット、開発者トークンを保持します。 具体的には、次のとおりです。

  • 4 つの認証情報は、どのログレベルでもログに記録されず、ディスクにも書き込まれません。
  • アクセストークンは、有効期限の 1 分前までメモリにキャッシュされます。 呼び出しのたびに再リクエストすることはありません。読み取りと書き込みで共有されます。
  • 失効したリフレッシュトークンは 1 回だけ報告されます。 Google が invalid_grant を返すと、それ以降のすべての呼び出しで、再認証の手順を含む同じメッセージが返され、サーバーは再起動するまで Google にトークンを要求しません。
  • アカウントを制限できます。 GOOGLE_ADS_ACCOUNT_IDS が設定されている場合、別の顧客を指定する呼び出しはリクエストの前に拒否され、アカウントの検出結果には許可された顧客のみが表示されます。
  • 接続先は 2 つだけです。 googleads.googleapis.com と oauth2.googleapis.com です。ソースに 3 つ目のホストが現れると、テストでビルドが失敗します。
  • リダイレクト先へのフェッチは行いません。 すべての送信呼び出しで redirect: "error" を設定しているため、リダイレクトによってベアラートークンやクライアントシークレットが別のホストに転送されることはありません。いずれかのフェッチでこの設定が省略されていると、テストでビルドが失敗します。
  • テレメトリーはありません。 サーバーは Google 以外へのネットワーク呼び出しを行いません。

ポリシー全文と報告手順:SECURITY.md。


マネージド型のマルチプラットフォーム版をお探しですか?

ローカルサーバーを運用せずにこのソースを利用したい場合は、ホスト型 Google Adsをお試しください。 getmcpads では、1 つの MCP URL を通じて広告、Search Console、GA4 にも接続できます。 利用可能なソースとプランの上限はサイトに記載されています。アカウントへの接続は引き続き必要です。

  1. Google Ads 接続ガイドに従ってください。
  2. アシスタントが読み取り可能なアカウントまたはプロパティを選択します。
  3. Claude、 ChatGPT、または Codexを接続します。
  4. 読み取り専用の確認を試します。「同じ期間でキャンペーンの費用とコンバージョンを比較してください。データが欠落している場合はその旨を示し、何も変更しないでください。」

有料プランを選ぶ前に、現在のホスト型ツールカタログと 料金をご確認ください。 この Apache 2.0 アダプターは、ご自身の認証情報を使って独立して利用することもできます。


コントリビューション

Issue とプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。 セキュリティ関連の報告を行う前に、SECURITY.mdをお読みください。

ライセンス

Apache License 2.0。NOTICEもご覧ください。

Google、Google Ads、Google Ads API は Google LLC の商標です。 このプロジェクトは Google LLC と提携しておらず、同社の推奨や後援を受けていません。 これは公開 API の独立したクライアントです。

MCP コントラクトとデスクトップバンドル

各ツールは、読み取り/書き込みのアノテーション、パラメーターの説明、構造化出力スキーマを宣言します。呼び出しが成功すると、ペイロードは structuredContent.result として公開されます。エラーの場合は isError: true が保持されます。生成されたサーバーカードには定義のみが含まれます。

npm run bundle -- /path/to/output を実行すると、現在のカタログから .mcpb デスクトップバンドルをビルドできます。認証情報はインストール時にローカルで入力します。書き込みツールは明示的に有効にしない限り、無効のままです。

getmcpads のその他のプロジェクト

Meta Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

getmcpadsのEmmanuelがメンテナンスしています。お問い合わせ:[email protected]。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。