Google アド マネージャーの MCP サーバーを使用する

Google アド マネージャーは、AI エージェントが Google アド マネージャーのネットワーク、広告枠、注文、ユーザーデータと安全にやり取りできるリモート Model Context Protocol（MCP）サーバーを提供しています。アド マネージャーの MCP サーバーを構成すると、Google Antigravity、Claude、ChatGPT などの AI アプリケーションが、アド マネージャーのユーザーとしてアクションを実行できるようになります。

MCP サーバーは https://admanager.googleapis.com/mcp で使用できます。

前提条件

  • Google Cloud プロジェクトを作成する権限、または既存の Google Cloud プロジェクトを表示する権限。
  • AI クライアント（ChatGPT や Claude など）で接続やアプリを編集する権限。

アド マネージャーの MCP サーバーを構成する

Ad Manager MCP サーバーを使用するには、次の手順を完了する必要があります。

  • Google Cloud プロジェクトで Ad Manager API を有効にします。
  • OAuth 2.0 エンドユーザー認証を構成します。
  • MCP サーバーを AI クライアントに追加します。

Ad Manager API を有効にする

Ad Manager MCP サーバーを使用するには、Google Cloud プロジェクトで Ad Manager API を有効にする必要があります。Google Cloud プロジェクトを作成する必要がある場合は、新しいプロジェクトをご覧ください。

API の有効化

Ad Manager MCP サーバーは、エンドユーザーの認証と認可に OAuth 2.0 を使用します。AI クライアントが MCP サーバーに接続すると、AI クライアントを実行しているユーザーとして認証されます。AI エージェントは、ユーザーと同じ Google アド マネージャーのユーザー役割、ネットワーク メンバーシップ、権限を継承します。

  1. Google Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。

    [ブランディング] に移動

  2. Google Auth Platform をすでに構成している場合は、[ブランディング]、[対象]、[データアクセス] で次の OAuth 同意画面の設定を構成できます。「Google Auth Platform not configured yet」というメッセージが表示された場合は、[Get Started] をクリックします。

    1. [アプリ情報] セクションの [アプリ名] に、「Ad Manager MCP Server」または任意の名前を入力します。
    2. [ユーザー サポートメール] で、メールアドレスまたは適切なグループを選択します。
    3. [次へ] をクリックします。
    4. [対象] で [内部] を選択します。
    5. [次へ] をクリックします。
    6. [連絡先情報] で、プロジェクトに対する変更の通知を受け取るメールアドレスを入力します。
    7. [次へ] をクリックします。
    8. [完了] セクションで、Google API サービスのユーザーデータに関するポリシーを確認し、同意する場合は [Google API サービス: ユーザーデータに関するポリシーに同意します] を選択します。
    9. [続行] をクリックします。
    10. [作成] をクリックします。

  3. [データアクセス] > [スコープを追加または削除] をクリックします。パネルが表示され、Google Cloud プロジェクトで有効にした各 API のスコープのリストが表示されます。

    1. [スコープの手動追加] で、Ad Manager MCP サーバーに必要な OAuth スコープを入力します。
      • https://www.googleapis.com/auth/admanager（キャンペーンの表示と管理に対するフルアクセス権）
    2. [テーブルに追加] をクリックします。
    3. [更新] をクリックします。
    4. アプリに必要なスコープを選択したら、[データアクセス] ページで [保存] をクリックします。

MCP サーバーを AI クライアントに追加する

アド マネージャー MCP サーバーを AI クライアントに追加するには、クライアントの手順に沿って操作します。

Antigravity

Ad Manager MCP サーバーを Antigravity に追加する手順は次のとおりです。

  1. OAuth 2.0 クライアント ID とシークレットを作成します。

    1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

      プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

    2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

    3. [名前] フィールドに、アプリケーションの名前を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://antigravity.google/oauth-callback と入力します。

    5. [作成] をクリックします。クライアントが作成されます。

      [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

    6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

  2. アド マネージャーの MCP サーバーを Antigravity に追加するには、~/.gemini/config/mcp_config.json ファイルを更新します。

    {
  "mcpServers": {
    "AdManager-MCP": {
      // Use your chosen MCP server URL.
      "serverUrl": "https://admanager.googleapis.com/mcp",
      "oauth": {
        "clientId": "CLIENT_ID",
        "clientSecret": "CLIENT_SECRET"
      }
    }
  }
}

    CLIENT_ID と CLIENT_SECRET は、OAuth 2.0 クライアント認証情報に置き換えます。

  3. アド マネージャーの MCP サーバーを認証するには、Antigravity: OAuth で認証するをご覧ください。

Claude.ai

Ad Manager MCP サーバーを Claude.ai に追加するには、OAuth クライアント ID と OAuth クライアント シークレットを使用してカスタム コネクタを構成します。

  1. OAuth 2.0 クライアント ID とシークレットを作成します。

    1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

      プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

    2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

    3. [名前] フィールドに、アプリケーションの名前を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://claude.ai/api/mcp/auth_callback と入力します。

    5. [作成] をクリックします。クライアントが作成されます。

      [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

    6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

  2. 手順に沿って、カスタム コネクタを作成します。[詳細設定] メニューでクライアント ID とシークレットを入力します。

Claude Code

Ad Manager MCP サーバーを Claude Code に追加するには、OAuth クライアント ID と OAuth クライアント シークレットを使用してカスタム コネクタを構成します。

  1. Claude Code をインストールします。

  2. OAuth 2.0 クライアント ID とシークレットを作成します。

    1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

      プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

    2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

    3. [名前] フィールドに、アプリケーションの名前を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://claude.ai/api/mcp/auth_callback と入力します。

    5. [作成] をクリックします。クライアントが作成されます。

      [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

    6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

  3. 手順に沿って、カスタム コネクタを作成します。[詳細設定] メニューでクライアント ID とシークレットを入力します。

Claude Desktop

Ad Manager MCP サーバーを Claude Desktop に追加するには、OAuth クライアント ID と OAuth クライアント シークレットを使用してカスタム コネクタを構成します。

  1. Claude Desktop をインストールします。

  2. OAuth 2.0 クライアント ID とシークレットを作成します。

    1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

      プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

    2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

    3. [名前] フィールドに、アプリケーションの名前を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://claude.ai/api/mcp/auth_callback と入力します。

    5. [作成] をクリックします。クライアントが作成されます。

      [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

    6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

  3. 手順に沿って、カスタム コネクタを作成します。[詳細設定] メニューでクライアント ID とシークレットを入力します。

ChatGPT

ChatGPT でアド マネージャーの MCP サーバーを使用するには、ChatGPT Business サブスクリプションが必要です。

MCP サーバーを ChatGPT に追加するには、Google OAuth 2.0 クライアント ID とシークレットを作成し、MCP サーバーを ChatGPT のアプリとして追加します。

OAuth 2.0 クライアント ID とシークレットを作成する

  1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

    [クライアントの作成] に移動

    プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

  2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

  3. [名前] フィールドに、アプリケーションの名前を入力します。

  4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://chatgpt.com/connector_platform_oauth_redirect と入力します。

  5. [作成] をクリックします。クライアントが作成されます。

    [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

  6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

ChatGPT にアプリとして MCP サーバーを追加する

  1. ChatGPT にログインします。
  2. デベロッパー モードをオンにします。
  3. ChatGPT アプリの設定を開きます。
  4. [アプリを作成] をクリックして、リモート MCP サーバーのアプリを作成します。
  5. [OAuth] セクションで、クライアント ID とシークレットを指定します。
  6. MCP サーバーの使用に伴うリスクを理解していることを確認し、[作成] をクリックします。

MCP サーバーが [アプリ] メニューに表示され、チャット プロンプトで使用できるようになります。

Cursor

Ad Manager MCP サーバーを Cursor に追加するには、クライアント ID とシークレットを作成します。静的 OAuth を使用して MCP サーバーを構成します。Cursor は、ウェブ アプリケーションやデスクトップ アプリケーションなど、Cursor へのアクセスに使用するツールに応じてリダイレクト URI を使用します。

  1. OAuth 2.0 クライアント ID とシークレットを作成します。

    ウェブまたはカーソル エージェント

    1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

      プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

    2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

    3. [名前] フィールドに、アプリケーションの名前を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://www.cursor.com/agents/mcp/oauth/callback と入力します。

    5. [作成] をクリックします。クライアントが作成されます。

      [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

    6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

    パソコン

    1. Google API Console で、[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。

      [クライアントの作成] に移動

      プロジェクトが選択されていない場合は、プロジェクトの作成を求めるメッセージが表示されます。

    2. [アプリケーションの種類] リストで、[ウェブ アプリケーション] をクリックします。

    3. [名前] フィールドに、アプリケーションの名前を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに http://localhost:8787/callback と入力します。

    5. [作成] をクリックします。クライアントが作成されます。

      [OAuth 2.0 クライアントが作成されました] ダイアログが開きます。

    6. [クライアント シークレット] セクションで、クライアント シークレットをコピーして安全な場所に保存します。コピーできるのは 1 回のみです。紛失した場合は、シークレットを削除して新しいシークレットを作成します。

  2. 手順に沿って、静的 OAuth を使用して MCP サーバーを構成します。
  3. Chat で MCP サーバーを使用する。

アド マネージャーの MCP サーバーをテストする

MCP クライアントを構成して認証したら、AI チャット インターフェースでテスト プロンプトを実行して接続を確認できます。

AI クライアントに次の質問をしてみてください。

  • 「アクセスできる Google アド マネージャー ネットワークを一覧表示して。」

    クライアントは list_networks を呼び出して、ユーザー アカウントに関連付けられているアド マネージャー ネットワーク コードと表示名を取得して表示します。

  • 「ネットワーク コード NETWORK_CODE の詳細を教えて。」

    クライアントは get_network を使用して、指定されたネットワークのメタデータを取得します。

  • 「ネットワーク NETWORK_CODE の最初の 5 件の注文を表示して。」

    クライアントは list_orders を呼び出して、ネットワーク内の注文をクエリして要約します。

ツールが正常に実行され、Google アド マネージャーのデータが返された場合、MCP サーバー接続は正しく構成されています。