Google Ad Manager MCP sunucusunu kullanma

Google Ad Manager, yapay zeka ajanlarının Google Ad Manager ağları, envanteri, siparişleri ve kullanıcı verileriyle güvenli bir şekilde etkileşim kurmasına olanak tanıyan uzaktan Model Bağlam Protokolü (MCP) sunucusu sunar. Ad Manager MCP sunucusunu yapılandırarak Google Antigravity, Claude ve ChatGPT gibi yapay zeka uygulamalarının Ad Manager kullanıcınız olarak işlem yapmasına izin verirsiniz.

MCP sunucusu https://admanager.googleapis.com/mcp adresinde kullanılabilir.

Ön koşullar

  • Google Cloud projeleri oluşturma veya mevcut bir Google Cloud projesini görüntüleme erişimi
  • Yapay zeka istemcilerinizdeki (ör. ChatGPT veya Claude) bağlantıları ya da uygulamaları düzenleme erişimi.

Ad Manager MCP sunucusunu yapılandırma

Ad Manager MCP sunucusunu kullanmak için aşağıdaki adımları tamamlamanız gerekir:

  • Google Cloud projenizde Ad Manager API'sini etkinleştirin.
  • OAuth 2.0 son kullanıcı kimlik doğrulamasını yapılandırın.
  • MCP sunucusunu yapay zeka istemcinize ekleyin.

Ad Manager API'yi etkinleştirme

Ad Manager MCP sunucusunu kullanmak için Google Cloud projenizde Ad Manager API'yi etkinleştirmeniz gerekir. Google Cloud projesi oluşturmanız gerekiyorsa Yeni Proje bölümüne bakın.

API'yi etkinleştirme

Ad Manager MCP sunucusu, son kullanıcı kimlik doğrulaması ve yetkilendirmesi için OAuth 2.0'ı kullanır. Bir yapay zeka istemcisi MCP sunucusuna bağlandığında, yapay zeka istemcisini çalıştıran kullanıcı olarak kimliği doğrulanır. Yapay zeka aracısı, kullanıcının Google Ad Manager kullanıcı rollerini, ağ üyeliklerini ve izinlerini aynen devralır.

  1. Google Cloud Console'da Google Auth Platform > Branding'e (Google Auth Platform > Markalama) gidin.

    Markalama'ya gidin

  2. Google Auth Platform'u daha önce yapılandırdıysanız Markalama, Kitle ve Veri Erişimi'nde aşağıdaki OAuth izin ekranı ayarlarını yapılandırabilirsiniz. Google Auth Platform not configured yet (Google Auth Platform henüz yapılandırılmadı) mesajını görürseniz Başlayın'ı tıklayın:

    1. Uygulama Bilgileri bölümündeki Uygulama adı için Ad Manager MCP Server veya tercih ettiğiniz adı girin.
    2. Kullanıcı destek e-postası bölümünde e-posta adresinizi veya uygun bir grubu seçin.
    3. İleri'yi tıklayın.
    4. Kitle için Dahili'yi seçin.
    5. İleri'yi tıklayın.
    6. İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirimleri alabileceğiniz bir e-posta adresi girin.
    7. İleri'yi tıklayın.
    8. Bitir bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
    9. Devam'ı tıklayın.
    10. Oluştur'u tıklayın.

  3. Veri Erişimi > Kapsam Ekleme veya Kaldırma'yı tıklayın. Google Cloud projenizde etkinleştirdiğiniz her API'nin kapsam listesini içeren bir panel gösterilir.

    1. Kapsamları manuel olarak ekleme bölümünde, Ad Manager MCP sunucusu için gereken OAuth kapsamlarını girin:
      • https://www.googleapis.com/auth/admanager (Kampanyaları görüntülemek ve yönetmek için tam erişim)
    2. Tabloya Ekle'yi tıklayın.
    3. Güncelle'yi tıklayın.
    4. Uygulamanızın gerektirdiği kapsamları seçtikten sonra Veri Erişimi sayfasında Kaydet'i tıklayın.

MCP sunucusunu yapay zeka istemcinize ekleme

Ad Manager MCP sunucusunu yapay zeka istemcinize eklemek için istemcinizle ilgili talimatları uygulayın:

Antigravity

Ad Manager MCP sunucusunu Antigravity'ye eklemek için aşağıdaki adımları tamamlayın:

  1. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

      İstemci oluşturma sayfasına gitme

      Seçili bir projeniz yoksa proje oluşturmanız istenir.

    2. Uygulama türü listesinde Web uygulaması'nı seçin.

    3. Ad alanına uygulamanız için bir ad girin.

    4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://antigravity.google/oauth-callback girin.

    5. Oluştur'u tıklayın. İstemci oluşturulur.

      OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

    6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

  2. Ad Manager MCP sunucusunu Antigravity'ye eklemek için ~/.gemini/config/mcp_config.json dosyanızı güncelleyin:

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

    CLIENT_ID ve CLIENT_SECRET kısımlarını OAuth 2.0 istemci kimlik bilgilerinizle değiştirin.

  3. Ad Manager MCP sunucusunun kimliğini doğrulamak için Antigravity: Authenticate with OAuth başlıklı makaleyi inceleyin.

Claude.ai

Ad Manager MCP sunucusunu Claude.ai'ye eklemek için OAuth istemci kimliği ve OAuth istemci gizli anahtarı içeren özel bir bağlayıcı yapılandırın:

  1. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

      İstemci oluşturma sayfasına gitme

      Seçili bir projeniz yoksa proje oluşturmanız istenir.

    2. Uygulama türü listesinde Web uygulaması'nı seçin.

    3. Ad alanına uygulamanız için bir ad girin.

    4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://claude.ai/api/mcp/auth_callback girin.

    5. Oluştur'u tıklayın. İstemci oluşturulur.

      OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

    6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

  2. Özel bağlayıcı oluşturma talimatlarını uygulayın. İstemci kimliğinizi ve istemci sırrınızı Gelişmiş ayarlar menüsüne girin.

Claude Code

Ad Manager MCP sunucusunu Claude Code'a eklemek için OAuth istemci kimliği ve OAuth istemci gizli anahtarı ile özel bir bağlayıcı yapılandırın:

  1. Claude Code'u yükleyin.

  2. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

      İstemci oluşturma sayfasına gitme

      Seçili bir projeniz yoksa proje oluşturmanız istenir.

    2. Uygulama türü listesinde Web uygulaması'nı seçin.

    3. Ad alanına uygulamanız için bir ad girin.

    4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://claude.ai/api/mcp/auth_callback girin.

    5. Oluştur'u tıklayın. İstemci oluşturulur.

      OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

    6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

  3. Özel bağlayıcı oluşturma talimatlarını uygulayın. İstemci kimliğinizi ve istemci sırrınızı Gelişmiş ayarlar menüsüne girin.

Claude Desktop

Ad Manager MCP sunucusunu Claude Desktop'a eklemek için OAuth istemci kimliği ve OAuth istemci gizli anahtarıyla özel bir bağlayıcı yapılandırın:

  1. Claude Desktop'u yükleyin.

  2. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

      İstemci oluşturma sayfasına gitme

      Seçili bir projeniz yoksa proje oluşturmanız istenir.

    2. Uygulama türü listesinde Web uygulaması'nı seçin.

    3. Ad alanına uygulamanız için bir ad girin.

    4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://claude.ai/api/mcp/auth_callback girin.

    5. Oluştur'u tıklayın. İstemci oluşturulur.

      OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

    6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

  3. Özel bağlayıcı oluşturma talimatlarını uygulayın. İstemci kimliğinizi ve istemci sırrınızı Gelişmiş ayarlar menüsüne girin.

ChatGPT

Ad Manager MCP sunucusunu ChatGPT ile kullanmak için ChatGPT Business aboneliğiniz olmalıdır.

MCP sunucusunu ChatGPT'ye eklemek için Google OAuth 2.0 istemci kimliği ve istemci sırrı oluşturun, ardından MCP sunucusunu ChatGPT'ye uygulama olarak ekleyin.

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturma

  1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

    İstemci oluşturma sayfasına gitme

    Seçili bir projeniz yoksa proje oluşturmanız istenir.

  2. Uygulama türü listesinde Web uygulaması'nı seçin.

  3. Ad alanına uygulamanız için bir ad girin.

  4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://chatgpt.com/connector_platform_oauth_redirect girin.

  5. Oluştur'u tıklayın. İstemci oluşturulur.

    OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

  6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

MCP sunucusunu ChatGPT'ye uygulama olarak ekleme

  1. ChatGPT'de oturum açın.
  2. Geliştirici modunu etkinleştirin.
  3. ChatGPT Uygulamaları ayarları'nı açın.
  4. Uygulama oluştur'u tıklayın ve uzak MCP sunucusu için bir uygulama oluşturun.
  5. OAuth bölümünde istemci kimliğinizi ve gizli anahtarınızı girin.
  6. MCP sunucusu kullanımıyla ilişkili riski anladığınızı onaylayın ve Oluştur'u tıklayın.

MCP sunucusu Uygulamalar menüsünde gösterilir ve sohbet istemleri aracılığıyla kullanılmaya hazırdır.

İmleç

Ad Manager MCP sunucusunu Cursor'a eklemek için istemci kimliği ve gizli anahtar oluşturun. MCP sunucusunu statik OAuth ile yapılandırın. Cursor, Cursor'a erişmek için kullandığınız yönteme (ör. web veya masaüstü uygulaması) bağlı olarak yönlendirme URI'leri kullanır.

  1. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    Web veya Cursor temsilcileri

    1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

      İstemci oluşturma sayfasına gitme

      Seçili bir projeniz yoksa proje oluşturmanız istenir.

    2. Uygulama türü listesinde Web uygulaması'nı seçin.

    3. Ad alanına uygulamanız için bir ad girin.

    4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://www.cursor.com/agents/mcp/oauth/callback girin.

    5. Oluştur'u tıklayın. İstemci oluşturulur.

      OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

    6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

    Masaüstü

    1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Kimlik Doğrulama Platformu > İstemciler > İstemci oluştur) gidin.

      İstemci oluşturma sayfasına gitme

      Seçili bir projeniz yoksa proje oluşturmanız istenir.

    2. Uygulama türü listesinde Web uygulaması'nı seçin.

    3. Ad alanına uygulamanız için bir ad girin.

    4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına http://localhost:8787/callback girin.

    5. Oluştur'u tıklayın. İstemci oluşturulur.

      OAuth 2.0 istemcisi oluşturuldu iletişim kutusu açılır.

    6. Client secrets (İstemci gizli anahtarları) bölümünde Client secret'ı (İstemci gizli anahtarı) kopyalayın ve güvenli bir yere kaydedin. Yalnızca bir kez kopyalayabilirsiniz. Kaybederseniz gizli anahtarı silip yeni bir tane oluşturun.

  2. MCP sunucusunu statik OAuth ile yapılandırma talimatlarını uygulayın.
  3. Chat'te MCP sunucusunu kullanma

Ad Manager MCP sunucusunu test etme

MCP istemcinizi yapılandırıp kimliğini doğruladıktan sonra, yapay zeka sohbet arayüzünüzde test istemleri çalıştırarak bağlantıyı doğrulayabilirsiniz.

Yapay zeka istemcinize aşağıdaki soruları sormayı deneyin:

  • "Erişebildiğim Google Ad Manager ağlarını listele."

    İstemci, kullanıcı hesabınızla ilişkili Ad Manager ağ kodlarını ve görünen adları almak ve görüntülemek için list_networks çağrılarını yapar.

  • "NETWORK_CODE ağ kodunun ayrıntılarını bul."

    İstemci, belirtilen ağın meta verilerini getirmek için get_network kullanır.

  • "NETWORK_CODE ağındaki ilk 5 siparişi göster."

    İstemci, ağınızdaki siparişleri sorgulamak ve özetlemek için list_orders işlevini çağırır.

Araçlar başarıyla çalışır ve Google Ad Manager verilerini döndürürse MCP sunucusu bağlantınız doğru şekilde yapılandırılmıştır.