Menggunakan server MCP Google Ad Manager

Google Ad Manager menawarkan server Model Context Protocol (MCP) jarak jauh yang memungkinkan agen AI berinteraksi secara aman dengan jaringan, inventaris, pesanan, dan data pengguna Google Ad Manager. Dengan mengonfigurasi server MCP Ad Manager, Anda mengizinkan aplikasi AI seperti Google Antigravity, Claude, dan ChatGPT untuk melakukan tindakan sebagai pengguna Ad Manager Anda.

Server MCP tersedia di https://admanager.googleapis.com/mcp.

Prasyarat

  • Akses untuk membuat project Google Cloud atau akses untuk melihat project Google Cloud yang ada.
  • Akses untuk mengedit koneksi atau Aplikasi di klien AI Anda (misalnya, ChatGPT atau Claude).

Mengonfigurasi server MCP Ad Manager

Untuk menggunakan server MCP Ad Manager, Anda harus menyelesaikan langkah-langkah berikut:

  • Aktifkan Ad Manager API di project Google Cloud Anda.
  • Konfigurasi autentikasi pengguna akhir OAuth 2.0.
  • Tambahkan server MCP ke klien AI Anda.

Mengaktifkan Ad Manager API

Untuk menggunakan server MCP Ad Manager, Anda harus mengaktifkan Ad Manager API di project Google Cloud Anda. Jika Anda perlu membuat project Google Cloud, lihat Project Baru.

Mengaktifkan API

Server MCP Ad Manager menggunakan OAuth 2.0 untuk autentikasi dan otorisasi pengguna akhir. Saat terhubung ke server MCP, klien AI akan diautentikasi sebagai pengguna yang menjalankan klien AI. Agen AI mewarisi peran pengguna, keanggotaan jaringan, dan izin Google Ad Manager yang sama persis dengan pengguna.

  1. Di konsol Google Cloud, buka Google Auth Platform > Branding.

    Buka Branding

  2. Jika sudah mengonfigurasi Platform Auth Google, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan Google Auth Platform not configured yet, klik Get Started:

    1. Di bagian Informasi Aplikasi, untuk Nama aplikasi, masukkan Ad Manager MCP Server atau nama pilihan Anda.
    2. Di User support email, pilih alamat email Anda atau grup yang sesuai.
    3. Klik Berikutnya.
    4. Untuk Audience, pilih Internal.
    5. Klik Berikutnya.
    6. Untuk Informasi Kontak, masukkan Alamat email tempat Anda dapat diberi tahu tentang perubahan apa pun pada project Anda.
    7. Klik Berikutnya.
    8. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya menyetujui Layanan Google API: Kebijakan Data Pengguna.
    9. Klik Lanjutkan.
    10. Klik Buat.

  3. Klik Akses Data > Tambahkan atau Hapus Cakupan. Panel akan muncul dengan daftar cakupan untuk setiap API yang telah Anda aktifkan di project Google Cloud Anda.

    1. Di bagian Tambahkan cakupan secara manual, masukkan cakupan OAuth yang diperlukan untuk server MCP Ad Manager:
      • https://www.googleapis.com/auth/admanager (Akses penuh untuk melihat dan mengelola kampanye)
    2. Klik Tambahkan ke Tabel.
    3. Klik Perbarui.
    4. Setelah memilih cakupan yang diperlukan oleh aplikasi Anda, di halaman Akses Data, klik Simpan.

Menambahkan server MCP ke klien AI Anda

Untuk menambahkan server MCP Ad Manager ke klien AI Anda, ikuti petunjuk untuk klien Anda:

Antigravity

Untuk menambahkan server MCP Ad Manager ke Antigravity, selesaikan langkah-langkah berikut:

  1. Buat client ID dan rahasia klien OAuth 2.0:

    1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

      Buka Buat klien

      Anda akan diminta untuk membuat project jika belum memilih project.

    2. Pada daftar Application type, pilih aplikasi web.

    3. Di kolom Name, masukkan nama aplikasi Anda.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://antigravity.google/oauth-callback di kolom URIs.

    5. Klik Buat. Klien dibuat.

      Dialog OAuth 2.0 client created akan terbuka.

    6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

  2. Untuk menambahkan server MCP Ad Manager ke Antigravity, perbarui file ~/.gemini/config/mcp_config.json Anda:

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

    Ganti CLIENT_ID dan CLIENT_SECRET dengan kredensial klien OAuth 2.0 Anda.

  3. Untuk mengautentikasi server MCP Ad Manager, lihat Antigravity: Mengautentikasi dengan OAuth.

Claude.ai

Untuk menambahkan server MCP Ad Manager ke Claude.ai, konfigurasikan konektor kustom dengan ID klien OAuth dan rahasia klien OAuth:

  1. Buat client ID dan rahasia klien OAuth 2.0:

    1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

      Buka Buat klien

      Anda akan diminta untuk membuat project jika belum memilih project.

    2. Pada daftar Application type, pilih aplikasi web.

    3. Di kolom Name, masukkan nama aplikasi Anda.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://claude.ai/api/mcp/auth_callback di kolom URIs.

    5. Klik Buat. Klien dibuat.

      Dialog OAuth 2.0 client created akan terbuka.

    6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

  2. Ikuti petunjuk untuk membuat konektor kustom. Masukkan ID dan rahasia Klien Anda di menu Setelan lanjutan.

Claude Code

Untuk menambahkan server MCP Ad Manager ke Claude Code, konfigurasi konektor kustom dengan ID klien OAuth dan rahasia klien OAuth:

  1. Instal Claude Code.

  2. Buat client ID dan rahasia klien OAuth 2.0:

    1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

      Buka Buat klien

      Anda akan diminta untuk membuat project jika belum memilih project.

    2. Pada daftar Application type, pilih aplikasi web.

    3. Di kolom Name, masukkan nama aplikasi Anda.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://claude.ai/api/mcp/auth_callback di kolom URIs.

    5. Klik Buat. Klien dibuat.

      Dialog OAuth 2.0 client created akan terbuka.

    6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

  3. Ikuti petunjuk untuk membuat konektor kustom. Masukkan ID dan rahasia Klien Anda di menu Setelan lanjutan.

Claude Desktop

Untuk menambahkan server MCP Ad Manager ke Claude Desktop, konfigurasi konektor kustom dengan ID klien OAuth dan secret klien OAuth:

  1. Instal Claude Desktop.

  2. Buat client ID dan rahasia klien OAuth 2.0:

    1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

      Buka Buat klien

      Anda akan diminta untuk membuat project jika belum memilih project.

    2. Pada daftar Application type, pilih aplikasi web.

    3. Di kolom Name, masukkan nama aplikasi Anda.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://claude.ai/api/mcp/auth_callback di kolom URIs.

    5. Klik Buat. Klien dibuat.

      Dialog OAuth 2.0 client created akan terbuka.

    6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

  3. Ikuti petunjuk untuk membuat konektor kustom. Masukkan ID dan rahasia Klien Anda di menu Setelan lanjutan.

ChatGPT

Anda harus memiliki langganan ChatGPT Business untuk menggunakan server MCP Ad Manager dengan ChatGPT.

Untuk menambahkan server MCP ke ChatGPT, buat ID dan rahasia klien Google OAuth 2.0, lalu tambahkan server MCP sebagai Aplikasi di ChatGPT.

Membuat ID dan rahasia klien OAuth 2.0

  1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

    Buka Buat klien

    Anda akan diminta untuk membuat project jika belum memilih project.

  2. Pada daftar Application type, pilih aplikasi web.

  3. Di kolom Name, masukkan nama aplikasi Anda.

  4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://chatgpt.com/connector_platform_oauth_redirect di kolom URIs.

  5. Klik Buat. Klien dibuat.

    Dialog OAuth 2.0 client created akan terbuka.

  6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

Menambahkan server MCP sebagai aplikasi di ChatGPT

  1. Login ke ChatGPT.
  2. Aktifkan Mode developer.
  3. Buka setelan Aplikasi ChatGPT.
  4. Klik Create app dan buat aplikasi untuk server MCP jarak jauh.
  5. Di bagian OAuth, berikan ID dan rahasia klien Anda.
  6. Konfirmasi bahwa Anda memahami risiko yang terkait dengan penggunaan server MCP, lalu klik Create.

Server MCP ditampilkan di menu Aplikasi, dan siap digunakan melalui perintah chat.

Kursor

Untuk menambahkan server MCP Ad Manager ke Cursor, buat ID dan rahasia klien. Konfigurasi server MCP dengan OAuth statis. Cursor menggunakan URI pengalihan, bergantung pada apa yang Anda gunakan untuk mengakses Cursor—seperti melalui web atau aplikasi desktop.

  1. Buat client ID dan rahasia klien OAuth 2.0:

    Agen Web atau Kursor

    1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

      Buka Buat klien

      Anda akan diminta untuk membuat project jika belum memilih project.

    2. Pada daftar Application type, pilih aplikasi web.

    3. Di kolom Name, masukkan nama aplikasi Anda.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://www.cursor.com/agents/mcp/oauth/callback di kolom URIs.

    5. Klik Buat. Klien dibuat.

      Dialog OAuth 2.0 client created akan terbuka.

    6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

    Desktop

    1. Di Konsol API Google, buka Google Auth Platform > Klien > Buat klien.

      Buka Buat klien

      Anda akan diminta untuk membuat project jika belum memilih project.

    2. Pada daftar Application type, pilih aplikasi web.

    3. Di kolom Name, masukkan nama aplikasi Anda.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan http://localhost:8787/callback di kolom URIs.

    5. Klik Buat. Klien dibuat.

      Dialog OAuth 2.0 client created akan terbuka.

    6. Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.

  2. Ikuti petunjuk untuk Mengonfigurasi server MCP dengan OAuth statis.
  3. Menggunakan server MCP di Chat.

Menguji server MCP Ad Manager

Setelah mengonfigurasi dan mengautentikasi klien MCP, Anda dapat memverifikasi koneksi dengan menjalankan perintah pengujian di antarmuka chat AI.

Coba ajukan pertanyaan berikut kepada klien AI Anda:

  • "Buat daftar jaringan Google Ad Manager yang dapat saya akses."

    Klien memanggil list_networks untuk mengambil dan menampilkan kode jaringan Ad Manager serta nama tampilan yang terkait dengan akun pengguna Anda.

  • "Temukan detail untuk kode jaringan NETWORK_CODE."

    Klien menggunakan get_network untuk mengambil metadata untuk jaringan yang ditentukan.

  • "Show the first 5 orders in network ." (Tampilkan 5 pesanan pertama di jaringan NETWORK_CODE.)

    Klien memanggil list_orders untuk mengkueri pesanan di jaringan Anda dan merangkumnya.

Jika alat berhasil dijalankan dan menampilkan data Google Ad Manager, koneksi server MCP Anda dikonfigurasi dengan benar.