# Google Ads MCP サーバー

Google による公式オープンソース Model Context Protocol (MCP) サーバーです。Gemini、Claude、Cursor などの AI アシスタントが、GAQL を通じて自然言語で Google Ads キャンペーン、パフォーマンスメトリクス、アカウントデータを安全にクエリおよび分析できるようにします。

Canonical URL: https://a2a-mcp.org/entry/google-ads-mcp-ja

Language: ja

Category: MCP Servers

Updated: 2026-03-21

## 概要

**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クライアントに接続すると:

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

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

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

### クイックスタート

pipxを使って実行:

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

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

```json
{
  "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](https://github.com/googleads/google-ads-mcp) をご覧ください。また、[Google Ads API MCP 開発者ガイド](https://developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server)も確認してください。

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

## Tags

- google-ads
- mcp
- mcp-サーバー
- google-ads-api
- ai-統合
- マーケティング
- 広告
- gaql
- 読み取り専用
- gemini
- claude
- cursor

## Sources

- [Project website](https://github.com/googleads/google-ads-mcp)
