Google Ads MCP

Google Ads MCP

Google Ads と Claude AI を接続し、自然言語での会話を通じて広告データを分析できるツールです。この連携により、Claude とのシンプルなチャットだけで、キャンペーン情報、パフォーマンス指標、キーワード分析、広告管理にアクセスできます。

---

広告の専門家向けに、このツールでできること

1. アカウント管理

   • Google Ads アカウントをすべて一か所で確認できます
   • アカウントの詳細と基本的なキャンペーン情報を取得できます

2. キャンペーン分析とレポート

   • 最も成果を上げているキャンペーンを確認できます
   • インプレッション数、クリック数、コンバージョン数、費用の指標を追跡できます
   • 時間の経過に伴うパフォーマンスの傾向を分析できます
   • 期間を比較して変化を把握できます
   • Claude が作成したチャートやグラフで、データを可視化できます

3. キーワードと広告のパフォーマンス

   • 成果の高いキーワードと低いキーワードを特定できます
   • 広告コピーの効果を分析できます
   • 品質スコアと競合指標を確認できます
   • キャンペーンを改善するための実用的なインサイトを得られます

4. 予算と入札の管理

   • キャンペーンの予算と支出をモニタリングできます
   • 入札戦略とパフォーマンスを分析できます
   • 最適化の機会を特定できます
   • 予算配分の推奨事項を取得できます

---

Google Ads MCP のアーキテクチャフロー

flowchart TB
    User(User) -->|Interacts with| Claude
    Claude(Claude AI Assistant) -->|Makes requests to| MCP[Google Ads MCP Server]
    User -->|Can also use| Cursor[Cursor AI Code Editor]
    Cursor -->|Makes requests to| MCP
    
    subgraph "MCP Server"
        FastMCP[FastMCP Server] 
        Tools[Available Tools]
        Auth[Authentication]
        
        FastMCP -->|Exposes| Tools
        FastMCP -->|Uses| Auth
    end
    
    subgraph "Google Ads Tools"
        ListAccounts[list_accounts]
        ExecuteGAQL[execute_gaql_query]
        CampaignPerf[get_campaign_performance]
        AdPerf[get_ad_performance]
        RunGAQL[run_gaql]
    end
    
    Tools -->|Includes| ListAccounts
    Tools -->|Includes| ExecuteGAQL
    Tools -->|Includes| CampaignPerf
    Tools -->|Includes| AdPerf
    Tools -->|Includes| RunGAQL
    
    subgraph "Authentication"
        OAuth[OAuth 2.0 Client ID]
        ServiceAccount[Service Account]
        Credentials[Google Ads API Credentials]
        
        OAuth -->|Provides| Credentials
        ServiceAccount -->|Provides| Credentials
    end
    
    MCP -->|Communicates with| GoogleAdsAPI[Google Ads API]
    GoogleAdsAPI -->|Returns| AdData[Advertising Data]
    AdData -->|Analyzed by| Claude
    AdData -->|Visualized by| Claude
    AdData -->|Can be used by| Cursor
    
    Credentials -->|Authorizes| GoogleAdsAPI
    
    subgraph "Configuration"
        EnvVars[Environment Variables]
        ConfigFiles[Configuration Files]
        
        EnvVars -->|Configures| MCP
        ConfigFiles -->|Configures| Claude
        ConfigFiles -->|Configures| Cursor
    end

利用可能なツール

この連携を設定すると、Claude に次のような操作を依頼できます。

依頼できること	機能	必要な情報
list_accounts	Google Ads アカウントをすべて表示します	何も必要ありません。依頼するだけです！
execute_gaql_query	Google Ads Query Language のクエリを実行します	アカウント ID と GAQL クエリ
get_campaign_performance	パフォーマンスデータを含むキャンペーン指標を表示します	アカウント ID と期間
get_ad_performance	広告クリエイティブのパフォーマンスを詳細に分析します	アカウント ID と期間
run_gaql	フォーマットオプションを指定して任意の GAQL クエリを実行します	アカウント ID、クエリ、フォーマット（table、JSON、または CSV）

高度なクエリツールの使用

run_gaql ツールは、任意のカスタム Google Ads Query Language（GAQL）クエリを実行できるため、特に強力です。使用できるクエリの例を以下に示します。

例 1：基本的なキャンペーン指標

SELECT 
    campaign.name, 
    metrics.clicks, 
    metrics.impressions 
FROM campaign 
WHERE segments.date DURING LAST_7DAYS

例 2：広告グループのパフォーマンス

SELECT 
    ad_group.name, 
    metrics.conversions, 
    metrics.cost_micros 
FROM ad_group 
WHERE metrics.clicks > 100

例 3：キーワード分析

SELECT 
    keyword.text, 
    metrics.average_position, 
    metrics.ctr 
FROM keyword_view 
ORDER BY metrics.impressions DESC

利用可能なツールの一覧と詳細な説明をすべて確認するには、セットアップ後に Claude に「list tools」と依頼してください。

---

はじめに（コーディング経験は不要です！）

1. Google Ads API アクセスを設定する

このツールを使用する前に、Claude が Google Ads データにアクセスできるようにする API 認証情報を作成する必要があります。認証方法は 2 種類から選択できます。

オプション A：OAuth 2.0 クライアント ID（ユーザー認証）

個人ユーザーまたはデスクトップアプリに最適です。

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. Google Ads API を有効にします
4. 「Credentials」→「Create Credentials」→「OAuth Client ID」の順に進みます
5. アプリケーションの種類として「Desktop Application」を選択します
6. OAuth クライアント設定ファイル（client_secret.json）をダウンロードします
7. Google Ads API の開発者トークンを作成します（以下を参照）

オプション B：サービスアカウント（サーバー間認証）

自動化システムや複数のアカウントの管理に適しています。

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. Google Ads API を有効にします
4. 「認証情報」→「認証情報を作成」→「サービスアカウント」に移動します
5. サービスアカウントのキー ファイル（JSON）をダウンロードします
6. サービスアカウントに Google Ads アカウントへのアクセス権を付与します
7. Google Ads API デベロッパー トークンを作成します（下記を参照）

認証トークンの更新

アプリケーションには、堅牢なトークン更新処理が備わっています。

• OAuth 2.0 トークン：可能な場合、ツールは期限切れの OAuth トークンを自動的に更新します。更新トークンが無効な場合は、再認証を求めます。
• サービスアカウント トークン：サービスアカウントのトークンは、ユーザーの操作なしに必要に応じて自動生成・更新されます。

認証方法の比較

次の場合は、OAuth 2.0 クライアント ID を選択してください。

• デスクトップアプリケーションを構築する場合
• ユーザーが明示的にアクセスを許可する必要がある場合
• 1 つのアカウント、または少数の個人アカウントを管理する場合
• アクセス権限をユーザー自身が管理できるようにしたい場合

次の場合は、サービスアカウントを選択してください。

• 自動化システムを構築する場合
• サーバー間認証が必要な場合
• 複数のアカウントをプログラムで管理する場合
• 認証にユーザーの操作が不要な場合
• ユーザーの操作なしにトークンを自動更新する必要がある場合

デベロッパー トークンの取得

1. https://ads.google.com で Google Ads アカウントにログインします
2. 上部のナビゲーションで「ツールと設定」（レンチのアイコン）をクリックします
3. 「設定」の下にある「API センター」をクリックします
4. 利用規約にまだ同意していない場合は、同意します
5. 「トークンを申請」をクリックします
6. API の使用予定についての詳細を記入し、申請フォームに入力します
7. 申請を送信し、承認を待ちます（通常、1～3 営業日かかります）

注：最初に取得できるテスト用デベロッパー トークンには、いくつかの制限があります。実装をテストした後、これらの制限が解除される本番用トークンを申請できます。

ログイン顧客 ID について

GOOGLE_ADS_LOGIN_CUSTOMER_ID は任意の設定で、主に次の場合に使用します。

• Google Ads クライアント センター（MCC）を利用する場合
• そのクライアント センターに属する複数のクライアント アカウントにアクセスする必要がある場合

次の場合、ログイン顧客 ID にはクライアント センターの ID（形式：XXX-XXX-XXXX）を指定してください。

• クライアント センターに属する複数のアカウントにアクセスする場合
• クライアント アカウントへのアクセスに、クライアント センターの認証情報を使用する場合

次の場合は、この設定を省略できます。

• 1 つの Google Ads アカウントにのみアクセスする場合
• アクセスするアカウントの認証情報を直接使用する場合

クライアント センターの ID を確認するには：

1. Google Ads クライアント センターにログインします
2. 設定アイコン（歯車）をクリックします
3. クライアント センターの ID が XXX-XXX-XXXX の形式で表示されます
4. 認証情報ファイル（JSON ファイル）をダウンロードします

🎬 初心者向けのチュートリアルを Youtube でご覧ください： 近日公開

2. 必要なソフトウェアをインストールする

コンピューターに次のツールをインストールする必要があります。

• Python（バージョン 3.11 以降） - Google Ads と Claude の接続を実行します
• Node.js - MCP インスペクターや一部の MCP コンポーネントの実行に必要です
• Claude Desktop - チャットに使用する AI アシスタントです

先に進む前に、Python と Node.js の両方が正しくインストールされ、システムのパスから利用できることを確認してください。

3. Google Ads MCP をダウンロードする

このツールをコンピューターにダウンロードする必要があります。最も簡単な方法は次のとおりです。

1. このページの上部にある緑色の「Code」ボタンをクリックします
2. 「Download ZIP」を選択します
3. ダウンロードしたファイルを、簡単に見つけられる場所（ドキュメント フォルダーなど）に展開します

Git に慣れている場合は、次の方法も利用できます。

git clone https://github.com/ixigo/mcp-google-ads.git

4. 必要なコンポーネントをインストールする

コンピューターでターミナル（Mac）またはコマンドプロンプト（Windows）を開きます。

1. ファイルを解凍したフォルダーに移動します。

   # Example (replace with your actual path):
   cd ~/Documents/mcp-google-ads-main
   

2. 仮想環境を作成します（これにより、プロジェクトの依存関係が分離されます）。

   # Using uv (recommended):
   uv venv .venv
   
   # If uv is not installed, install it first:
   pip install uv
   # Then create the virtual environment:
   uv venv .venv
   
   # OR using standard Python:
   python -m venv .venv
   

   注： uv のインストール時に「pip not found」エラーが発生する場合は、下記の「「pip not found」エラーが発生した場合」セクションを参照してください。

3. 仮想環境を有効にします。

   # On Mac/Linux:
   source .venv/bin/activate
   
   # On Windows:
   .venv\Scripts\activate
   

4. 必要な依存関係をインストールします。

   # Using uv:
   uv pip install -r requirements.txt
   
   # OR using standard pip:
   pip install -r requirements.txt
   
   # If you encounter any issues with the MCP package, install it separately:
   pip install mcp
   

   「pip not found」エラーが発生した場合：

   # First ensure pip is installed and updated:
   python3 -m ensurepip --upgrade
   python3 -m pip install --upgrade pip
   
   # Then try installing the requirements again:
   python3 -m pip install -r requirements.txt
   
   # Or to install uv:
   python3 -m pip install uv
   

コマンドプロンプトの先頭に (.venv) と表示されていれば、仮想環境が有効になっています。依存関係はシステムの Python インストールに影響を与えることなく、その環境にインストールされます。

5. 環境設定を行う

Google Ads MCP は、設定を簡単にするための環境ファイル設定に対応しました。

.env ファイルを使用する（推奨）

1. .env.example ファイルをプロジェクトディレクトリ内の .env にコピーします。

   cp .env.example .env
   

2. .env ファイルを編集し、実際の設定値を入力します。

   # Edit the .env file with your favorite text editor
   # For Mac:
   nano .env
   
   # For Windows:
   notepad .env
   

3. .env ファイルに次の値を設定します。

   # Authentication Type: "oauth" or "service_account"
   GOOGLE_ADS_AUTH_TYPE=oauth
   
   # Path to your credentials file (OAuth client secret or service account key)
   GOOGLE_ADS_CREDENTIALS_PATH=/path/to/your/credentials.json
   
   # Your Google Ads Developer Token
   GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token_here
   
   # Optional: Manager Account ID (if applicable)
   GOOGLE_ADS_LOGIN_CUSTOMER_ID=your_manager_account_id
   

4. ファイルを保存します。

アプリケーションの起動時に、これらの値が .env ファイルから自動的に読み込まれます。

環境変数を直接設定する

システム上、または Claude や Cursor の設定ファイル内で、環境変数を直接設定することもできます。

Claude Desktop の場合

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_AUTH_TYPE": "oauth",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

Cursor の場合

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_AUTH_TYPE": "oauth",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

6. Claude を Google Ads に接続する

1. まだインストールしていない場合は、Claude Desktop をダウンロードしてインストールします。
2. Google サービスアカウントの認証情報ファイルをコンピューター上のどこかに保存してあることを確認します。
3. コンピューターでターミナル（Mac）またはコマンドプロンプト（Windows）を開き、次のように入力します。

# For Mac users:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

# For Windows users:
notepad %APPDATA%\Claude\claude_desktop_config.json

次のテキストを追加します（これにより、Claude が Google Ads に接続する方法を指定します）。

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/service_account_credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

重要： すべてのパスと値を、アカウントの実際の情報に置き換えてください。

• 1 つ目のパスには、仮想環境内の Python 実行ファイルを指定します。
• 2 つ目のパスには、解凍したフォルダー内の google_ads_server.py ファイルを指定します。
• 3 つ目のパスには、Google サービスアカウントの認証情報 JSON ファイルを指定します。
• Google Ads の開発者トークンを追加します。
• Google Ads のマネージャーアカウント ID を追加します（該当する場合）。

例：

• Mac：
  • Python のパス：/Users/ernesto/Documents/mcp-google-ads/.venv/bin/python
  • スクリプトのパス：/Users/ernesto/Documents/mcp-google-ads/google_ads_server.py
• Windows：
  • Python のパス：C:\\Users\\ernesto\\Documents\\mcp-google-ads\\.venv\\Scripts\\python.exe
  • スクリプトのパス：C:\\Users\\ernesto\\Documents\\mcp-google-ads\\google_ads_server.py

4. ファイルを保存します。

   • Mac：Ctrl+O を押してから Enter を押し、次に Ctrl+X を押して終了します。
   • Windows：［ファイル］>［保存］をクリックし、メモ帳を閉じます。

5. Claude Desktop を再起動します。

6. Claude が起動したら、ツールのセクションに Google Ads のツールが表示されます。

5a. Cursor に接続する（AI コードエディター）

Cursor は、MCP ツールで機能を拡張できる AI 搭載のコードエディターです。この Google Ads MCP ツールを Cursor と統合すると、コーディング環境内で直接広告データを分析できます。

Cursor との統合を設定する

1. まだインストールしていない場合は、Cursor をダウンロードしてインストールします。

2. Cursor の MCP 設定ファイルを作成します。

   プロジェクト固有の設定の場合： プロジェクトディレクトリ内に .cursor/mcp.json ファイルを作成します。

   グローバル設定（すべてのプロジェクトで使用可能）の場合： ホームディレクトリ内に ~/.cursor/mcp.json ファイルを作成します。

3. MCP 設定ファイルに次の設定を追加します。

   {
     "mcpServers": {
       "googleAdsServer": {
         "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
         "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
         "env": {
           "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/service_account_credentials.json",
           "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
           "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
         }
       }
     }
   }
   

   重要： Claude Desktop の設定と同様に、すべてのパスと値をアカウントの実際の情報に置き換えてください。

4. Cursor を再起動するか、ワークスペースを再読み込みして、新しい設定を適用します。

5. Google Ads MCP が Cursor の「利用可能なツール」セクションに表示され、必要に応じて Cursor の AI エージェントから使用できるようになります。

Cursor で Google Ads MCP を使用する

Cursor で作業するときは、AI エージェントに Google Ads ツールを直接使用するよう依頼できます。たとえば、次のように指示できます。

• 「Google Ads MCP を使ってすべてのアカウントを一覧表示し、費用が最も多いアカウントを教えてください。」
• 「Google Ads MCP を使って、過去 30 日間のキャンペーンのパフォーマンスを分析してもらえますか？」
• 「Google Ads ツールを使って GAQL クエリを実行し、コンバージョン数が最も多いキーワードを見つけてください。」

Cursor はツールの使用を承認するよう求め（Yolo モードを有効にしている場合を除く）、結果をチャットインターフェースに直接表示します。

Cursor 固有の機能

Cursor で Google Ads MCP を使用すると、次のことができます。

1. コードと広告の分析を組み合わせる：マーケティング関連のコードと実際のキャンペーンパフォーマンスデータをあわせて分析するよう Cursor に依頼できます。
2. データの可視化を生成する：開発環境で広告パフォーマンスのグラフや可視化を直接作成するよう依頼できます。
3. 推奨事項を実装する：実際の広告データに基づいて、コードの改善を Cursor に提案させることができます。

この連携は、広告パフォーマンスがコードの判断に直接影響するマーケティングオートメーション、分析ダッシュボード、または E コマースアプリケーションに取り組む開発者にとって特に有用です。

6. 広告データの分析を開始しましょう！

これで、Google Ads のデータについて Claude に質問できます。Claude はデータを取得するだけでなく、分析や傾向の説明、可視化も行い、広告パフォーマンスへの理解を深めるのに役立ちます。

各ツールで使用できる便利なプロンプトを以下に示します。

ツール名	プロンプトの例
list_accounts	「すべての Google Ads アカウントを一覧表示し、今月の費用が最も多いアカウントを教えてください。」
execute_gaql_query	「アカウント 123-456-7890 に対してこのクエリを実行してください：SELECT campaign.name, metrics.clicks FROM campaign WHERE metrics.impressions > 1000」
get_campaign_performance	「過去 30 日間のアカウント 123-456-7890 のキャンペーン上位 10 件を表示し、ROAS が 2 を下回るものを強調して、最適化戦略を提案してください。」
get_ad_performance	「検索キャンペーンで最も高い CTR を生み出している広告コピーの要素を包括的に分析し、実践的な提案をしてください。」
run_gaql	「このクエリを実行し、CSV 形式にしてください：SELECT ad_group.name, metrics.clicks, metrics.conversions FROM ad_group WHERE campaign.name LIKE '%Brand%'」

複数のツールを組み合わせて、その結果を分析するよう Claude に依頼することもできます。たとえば、次のように指示できます。

• 「コンバージョン数が最も多いキーワードを上位 20 件見つけ、品質スコアとインプレッションシェアを確認して、拡大の機会をまとめたレポートを作成してください。」

• 「過去 90 日間のアカウントのパフォーマンス傾向を分析し、最も成長の速いキャンペーンを特定して、成長を妨げている予算制限がないか確認してください。」

• 「デスクトップとモバイルの広告パフォーマンスを比較し、グラフで違いを可視化して、パフォーマンスの差に基づき、モバイルの入札単価調整が必要なキャンペーンを具体的に提案してください。」

• 「キーワードリストにない検索語句に最も多く費用をかけているキャンペーンを特定し、完全一致キーワードとして追加すべき語句を提案してください。」

Claude は Google Ads ツールを使ってデータを取得し、わかりやすい形式で提示します。役立つ場合は可視化を作成し、結果に基づく実践的な分析も提供します。

---

データ可視化機能

Claude は、さまざまな方法で Google Ads のデータを可視化できます。

• トレンドチャート：指標の経時変化を確認できます
• 比較グラフ：異なるキャンペーンや広告グループを比較できます
• パフォーマンスの分布：デバイスやオーディエンスごとの広告のパフォーマンスを把握できます
• 相関分析：費用とコンバージョン指標の関係を特定できます
• ヒートマップ：複雑なデータセットを色分けして可視化できます

データを分析するときに Claude に「可視化して」または「グラフを作成して」と依頼するだけで、情報をより理解しやすくする適切な可視化を生成します。

---

トラブルシューティング

Python コマンドが見つからない

macOS では、デフォルトの Python コマンドは python ではなく python3 であることが多く、Node.js との連携を含む一部のアプリケーションで問題が発生する場合があります。

Python が見つからないというエラーが発生した場合は、エイリアスを作成できます。

1. Python のエイリアスを作成します（初回のみ）。

   # For macOS users:
   sudo ln -s $(which python3) /usr/local/bin/python
   
   # If that doesn't work, try finding your Python installation:
   sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python
   

2. エイリアスが機能することを確認します。

   python --version
   

これによりシンボリックリンクが作成され、アプリケーションが python を呼び出すと、実際には python3 のインストールが使用されます。

Claude の設定に関する問題

接続に問題がある場合は、次の点を確認してください。

1. 設定内のすべてのファイルパスが正しく、フルパスを使用していることを確認します
2. サービスアカウントが Google Ads アカウントにアクセスできることを確認します
3. Developer Token が有効で、正しく入力されていることを確認します
4. 変更を加えた後、Claude Desktop を再起動します
5. ツールを使用しようとしたときに、Claude の応答にエラーメッセージがないか確認します
6. サーバーを手動で実行する際に、仮想環境が有効になっていることを確認します

Google Ads API の制限

API の割り当てや権限に関する問題が発生した場合は、次の点を確認してください。

1. Google Cloud Console で Google Ads API の割り当て上限を確認します
2. Developer Token に適切なアクセスレベルが設定されていることを確認します
3. サービスアカウントに適切な権限を付与していることを確認します

その他の予期しない問題

インストール中または使用中に、その他の予期しない問題が発生した場合は、次の手順に従ってください。

1. 表示されたエラーメッセージをそのままコピーします
2. サポートについて、次の情報を添えて [email protected] の Ernesto Cohnen に連絡します。
   • 実行しようとしていたこと
   • 正確なエラーメッセージ
   • 使用しているオペレーティングシステム
   • すでに試した手順

AI アシスタントに相談することもできます。多くの場合、状況に合わせた具体的な解決策を提案し、技術的な問題の診断や解決を支援してくれます。

ほとんどの問題は以前に他の人も経験しており、通常は簡単に解決できる方法があることを覚えておいてください。

セットアップのテスト

このリポジトリにはテストファイルが含まれており、Claude や Cursor で使用する前に、Google Ads API への接続が正しく機能していることを確認できます。

基本機能のテスト

1. 仮想環境が有効になっていることを確認します。

   # On Mac/Linux:
   source .venv/bin/activate
   
   # On Windows:
   .venv\Scripts\activate
   

2. テストファイル内の環境変数を設定するか、環境に設定します。

   • テキストエディターで test_google_ads_mcp.py を開きます
   • if not os.environ.get("GOOGLE_ADS_CREDENTIALS_PATH"): で始まるセクションを見つけます
   • プレースホルダーの値を実際の認証情報に置き換えるか、環境変数として設定済みの場合はこのセクションをコメントアウトします

3. テストを実行します。

   python test_google_ads_mcp.py
   

4. テストでは、次の処理が行われます。

   • すべての Google Ads アカウントを一覧表示します
   • 最初のアカウント ID を使用して、キャンペーンのパフォーマンス取得をテストします
   • 広告のパフォーマンスデータをテストします
   • 広告クリエイティブを取得します
   • サンプルの GAQL クエリを実行します

認証とトークン更新のテスト

認証とトークン更新の仕組みを個別にテストするには、次の手順に従ってください。

1. 仮想環境が有効になっており、.env ファイルが設定されていることを確認します。

2. トークン更新テストを実行します。

   python test_token_refresh.py
   

3. このテストでは、次のことを行います。

   • 設定した認証タイプ（OAuth またはサービスアカウント）から認証情報を読み込めることを確認します
   • 現在のトークンの状態と有効期限に関する情報を表示します
   • 顧客 ID のフォーマット関数をテストします
   • OAuth トークンの場合は、トークンの更新を試み、成功したことを確認します

トークン更新テストを行うと、サーバーを Claude または Cursor で使用する前に、OAuth とサービスアカウントの両方の認証情報が正しく設定されていることを確認できます。

すべてのテストが正常に完了すれば、セットアップは正しく機能しており、Claude または Cursor で使用する準備が整っています。

---

コントリビューション

バグを見つけた場合や、改善のアイデアがある場合は、ぜひお知らせください。GitHub でイシューを作成するか、プルリクエストを送信するか、[email protected] から Ernesto Cohnen に直接ご連絡ください。

---

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。

---

ixigo について

ixigo はインドを代表する旅行アプリです。何百万人もの旅行者が、航空券、列車、バス、ホテルのお得なプランを見つけるお手伝いをしています。詳細については、ixigo.com をご覧ください。

ixigo は、航空券、列車、バス、ホテルのお得なプランを見つけるための製品を開発するテクノロジー企業です。私たちは旅行を誰もがより手頃な価格で楽しめるようにすることに情熱を注ぐ、旅行好きのチームです。