概要

Google Ads MCP Server は、Googleが公式に提供するModel Context Protocol (MCP)のオープンソース実装です。これは大規模言語モデル (LLM) とGoogle Ads APIの間の、安全で標準化された橋渡し役として機能します。

このサーバーにより、AIアシスタントは自然言語での指示を用いてキャンペーンデータ、パフォーマンス指標、予算、キーワード、アカウント情報を取得することができます — カスタムAPIコードの作成や複雑な認証フローの管理なしに。

現在は 読み取り専用 (キャンペーン作成や編集のような書き込み操作なし)であり、Gemini CLI/Code Assistなどのツールに最適化して積極的に維持されています。Claude Desktop、Cursor、他のMCPクライアントへの完全な互換性もあります。

主な機能

自然言語によるアクセス: 「この週のキャンペーンパフォーマンスはどうですか？」や「上位パフォーマンスのキーワードをリストしてください」といった質問で構造化された回答を得られます。
GAQLサポート: 強力なカスタムレポート作成のためにGoogle Ads Query Languageへの完全アクセス。
複数アカウントサポート: アクセス可能な顧客とマネージャーアカウントをリストするツール。
ローカル実行 & 安全性: 適切なOAuth/サービスアカウント認証情報を用いて完全にユーザーのマシン上で実行されます。
結合コードなし: AIクライアントはMCP標準によりツールを自動的に発見・利用します。
Pythonベース: GitHubリポジトリからpipxで直接簡単にインストールできます。

動作原理

このサーバーはローカルMCPエンドポイント (stdioトランスポート)として実行されます。AIクライアントに接続すると:

LLMが利用可能なツール (search と list_accessible_customers)を発見します。
ユーザーの指示に基づいてGAQLクエリを生成します。
サーバーがGoogle Ads APIを通じて認証し、整理された構造化された結果を返します。
結果は分析と要約のためにLLMのコンテキストに戻されて注入されます。

セットアップ & インストール

前提条件

Google Ads Developer Token (開発者トークン)
Google Ads APIが有効化されたGoogle Cloudプロジェクト
OAuth認証情報 (credentials.json) またはサービスアカウント
Python + pipxのインストール

クイックスタート

pipxを使って実行:

pipx run git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

必要な環境変数でMCPクライアント (例: Geminiのsettings.jsonやClaude/Cursorの設定)を構成します:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": ["run", "--spec", "git+https://github.com/googleads/google-ads-mcp.git", "google-ads-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json",
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token"
      }
    }
  }
}

利用可能なツール

search: キャンペーン、広告、キーワード、指標、予算などを取得するための任意のGAQLクエリを実行します。
list_accessible_customers: アクセス可能なすべての顧客IDと名前を返します (マネージャーアカウントで有用)。

ユースケース

キャンペーン分析: パフォーマンス概要を即座に取得、効果の低い広告を特定、または複数アカウント間で指標を比較します。
レポート自動化: AIに依頼して週次レポートを生成したり、Google Adsダッシュボードにログインせずにトレンドを発見したりします。
キーワード & 競合他社インサイト: キーワードのパフォーマンスや最適化のアイデアについて、自然言語クエリで取得します。
エージェンシーワークフロー: AIエージェントに、複数アカウントにわたるクライアントレポート作成や診断業務を支援させます。
マルチMCPオーケストレーション: 他のMCPサーバー（Notion、カレンダー、アナリティクスなど）と組み合わせて、フルファネル対応のマーケティングエージェントを実現します。

制限事項とセキュリティに関する注意点

現在のリリースでは読み取り専用モードです（キャンペーンの作成や編集はできません）。
データは接続されたAIエージェント/LLMに公開されます。信頼できるクライアントのみ接続してください。
有効なGoogle Ads認証情報と開発者トークンが必要です。
主に分析や診断用途に最適です。完全な書き込み機能は今後のリリースで追加される可能性があります。

はじめに

最新のコード、課題、更新情報については、公式リポジトリ github.com/googleads/google-ads-mcp をご覧ください。また、Google Ads API MCP 開発者ガイドも確認してください。

Google Ads MCPサーバーは、エージェント型広告への大きな一歩です。Google Adsデータを会話型のAIネイティブなリソースに変えます。

Google Ads MCP サーバー

概要