Google Ads MCP sunucusu: Geliştirici entegrasyon kılavuzu

Model Context Protocol (MCP), büyük dil modellerinin (LLM'ler) harici veriler ve uygulamalarla güvenli bir şekilde etkileşim kurmasını sağlayan açık bir standarttır. Google Ads MCP sunucusu, Google Ads API'ye standartlaştırılmış bir köprü sağlar. Böylece yapay zeka temsilcileri, doğal dili kullanarak kampanya verilerini analiz edip alabilir.

Teknik genel bakış

Bu MCP sunucusunu uygulayarak Google Ads API kimlik doğrulaması, kaynak getirme ve veri ayrıştırma için özel "bağlayıcı kod" yazma ihtiyacını ortadan kaldırırsınız. Sunucu, LLM'nin bağımsız olarak keşfedip çağırabileceği belirli araçlar sunar.

Temel özellikler

  • Protokol: MCP (Model Context Protocol)
  • Mod: Salt okunur (mevcut sürüm)
  • Dil: Python
  • Taşıma: Standart giriş/çıkış (stdio)
  • Kimlik doğrulama: OAuth 2.0 veya hizmet hesabı

Etkileşim döngüsünün işleyiş şekli

  1. İstek: Bir kullanıcı "Kampanya performansım bu hafta nasıl?" gibi bir sorgu gönderiyor.
  2. Keşif: LLM, mevcut araçlarını inceler ve google-ads-mcp arama özelliklerini belirler.
  3. Yürütme: MCP sunucusu, Google Ads API'yi sorgulamak için temel Python mantığını yürütür.
  4. Bağlam yerleştirme: Yapılandırılmış sonuçlar, LLM'nin bağlam penceresine döndürülür.
  5. Yanıt: LLM, verileri insan tarafından okunabilecek bir yanıta dönüştürür.

Başlayın

Google Ads MCP sunucusunu yapılandırmak ve kullanmak için aşağıdaki adımları uygulayın.

Ön koşullar

Yapılandırmadan önce Google Ads Geliştirici Konsolu'ndan aşağıdaki kimlik bilgilerine sahip olduğunuzdan emin olun:

  • Geliştirici jetonu: 22 karakterlik benzersiz erişim dizeniz.
  • Proje kimliği: Google Cloud proje tanımlayıcınız.
  • Kimlik bilgileri dosyası: Yetkili bir credentials.json (OAuth 2.0 veya hizmet hesabı).

Yapılandırma

Sunucuyu MCP ile uyumlu bir ana makineye entegre etmek için ana makinenizin MCP yapılandırma dosyasına (ör. settings.json). Bu yapılandırmanın tam konumu ve dosya adı için barındırıcınızın dokümanlarına bakın.

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/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Temel özellikler (araçlar)

Sunucu, hesap keşfi ve performans raporlaması için tasarlanmış araçlar sunar:

  • list_accessible_customers: Kimliği doğrulanmış kullanıcının erişebildiği Google Ads müşteri kimliklerinin ve hesap adlarının listesini döndürür.
  • search: Kampanya metriklerini, bütçelerini ve durumunu getirmek için Google Ads Sorgu Dili (GAQL) isteklerini yürütür.

Başlamak için örnek istemler

Sunucunun neler yapabileceğini sorun:

What can the google-ads-mcp server do?

Müşteriler hakkında soru sorma:

What customers do I have access to?

Kampanyalar hakkında soru sorma:

How many active campaigns do I have?
How is my campaign performance this week?

Topluluk kaynakları ve desteği