Google Ads MCP Kurulum Skill'i

Bu skill, Google Ads hesabını Claude Desktop'a MCP üzerinden bağlamak için gereken tüm teknik adımları otomatik yürütür. Kullanıcıdan sadece Google tarafındaki manuel adımlar için rehberlik yapması beklenir.

Em tire kullanma, üçlü fiil ritmi ve simetrik liste kurma. Düz ve doğrudan yaz.

---

Genel Akış

0. Ön bilgileri topla (kullanıcıdan)
1. Repo kurulumu (otomatik)
2. Google Cloud kurulumu (kullanıcı + rehberlik)
3. Developer Token al (kullanıcı + rehberlik)
4. Kimlik doğrulama (yarı otomatik)
5. .env dosyası oluştur (otomatik)
6. Claude Desktop config (otomatik)
7. Test et (otomatik rehberlik)

---

ADIM 0 — Bilgi Toplama

Kuruluma başlamadan önce kullanıcıdan şunları öğren:

1. İşletim sistemi: macOS mu, Windows mu?
2. Python yüklü mü? → python3 --version ile kontrol etmelerini iste
3. Claude Desktop yüklü mü?
4. Google Ads hesap türü: Normal hesap mı, MCC (Yönetici) hesabı mı?

Bu bilgileri aldıktan sonra kuruluma başla.

---

ADIM 1 — Repo Kurulumu (Otomatik)

# Repo klonla
git clone https://github.com/googleads/google-ads-mcp.git
cd google-ads-mcp

# Sanal ortam oluştur
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Bağımlılıkları kur
pip install -e .

Beklenen çıktı: Successfully installed google-ads-mcp-0.0.1

Hata durumu: requirements.txt not found hatası gelirse pip install -e . kullan.

---

ADIM 2 — Google Cloud Kurulumu (Rehberlik)

Kullanıcıya şu adımları yaptır:

1. console.cloud.google.com → Mevcut projeyi kullan veya yeni proje oluştur
2. APIs & Services → Library → "Google Ads API" → Enable
3. APIs & Services → Credentials → Create Credentials → OAuth 2.0 Client ID
   • Application type: Desktop app
   • Name: google-ads-mcp
4. JSON dosyasını indir → google-ads-mcp klasörüne taşı → adını client_secret.json yap

Kritik not: OAuth Consent Screen'de kullanıcının kendi e-posta adresini "Test Users"a eklemesi gerekir. Aksi halde "Erişim engellendi" hatası alır.

Terminal'de doğrulama:

ls ~/google-ads-mcp/client_secret.json

---

ADIM 3 — Developer Token (Rehberlik)

Developer Token sadece MCC (Yönetici) hesaplarından alınabiliyor.

Kullanıcının normal bir Google Ads hesabı varsa önce MCC açması gerekir: → ads.google.com/home/tools/manager-accounts adresinden ücretsiz açılır. → Asıl reklam hesabını MCC'ye bağlaması gerekir: Erişim ve güvenlik → Yöneticiler sekmesi.

MCC hesabında: Araçlar → API Merkezi → Form doldur → Developer Token kopyala.

Token'ı konuşmada paylaşmasına gerek yok, "aldım" demesi yeterli.

---

ADIM 4 — Kimlik Doğrulama (Yarı Otomatik)

macOS

# Homebrew yoksa önce kur
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# PATH'e ekle (Homebrew kurulumundan sonra çıkan komutu çalıştır)
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv zsh)"

# gcloud kur
brew install --cask google-cloud-sdk

Windows

cloud.google.com/sdk/docs/install adresinden installer indir ve çalıştır.

OAuth kimlik doğrulama (her iki OS)

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=/Users/KULLANICI/google-ads-mcp/client_secret.json

Beklenen çıktı: Tarayıcı açılır → Google hesabıyla giriş → İzinler onaylanır → Terminal'de "Credentials saved" yazısı çıkar.

Hata: "Erişim engellendi" → Google Cloud Console'da OAuth Consent Screen → Audience → Test Users'a e-posta ekle.

Hata: Tarayıcı açılmadı → Terminal'deki URL'yi kopyala, tarayıcıya yapıştır.

---

ADIM 5 — .env Dosyası Oluştur (Otomatik)

Kullanıcıdan şu bilgileri al:

• DEVELOPER_TOKEN (Adım 3'te aldıkları)
• PROJECT_ID (Google Cloud proje ID'si, console.cloud.google.com'da görünür)
• MCC_ID (MCC hesap numarası, Google Ads'te sağ üstte görünür, tire olmadan yaz)

cat > ~/google-ads-mcp/.env << 'EOF'
GOOGLE_ADS_DEVELOPER_TOKEN=BURAYA_TOKEN
GOOGLE_ADS_MCP_OAUTH_CLIENT_ID=BURAYA_CLIENT_ID
GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET=BURAYA_CLIENT_SECRET
GOOGLE_ADS_LOGIN_CUSTOMER_ID=BURAYA_MCC_ID
EOF

Client ID ve Secret'ı client_secret.json'dan al:

cat ~/google-ads-mcp/client_secret.json

client_id ve client_secret değerlerini kopyala.

---

ADIM 6 — Claude Desktop Config (Otomatik)

Kullanıcı adını tespit et:

echo $HOME

macOS — config dosyasını oluştur:

cat > "$HOME/Library/Application Support/Claude/claude_desktop_config.json" << EOF
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "$HOME/google-ads-mcp/venv/bin/python",
      "args": ["-m", "ads_mcp.server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "DEVELOPER_TOKEN_BURAYA",
        "GOOGLE_CLOUD_PROJECT": "PROJECT_ID_BURAYA",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "MCC_ID_BURAYA"
      }
    }
  }
}
EOF

Windows — config dosyası yolu: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "C:\\Users\\KULLANICI\\google-ads-mcp\\venv\\Scripts\\python.exe",
      "args": ["-m", "ads_mcp.server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "DEVELOPER_TOKEN_BURAYA",
        "GOOGLE_CLOUD_PROJECT": "PROJECT_ID_BURAYA",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "MCC_ID_BURAYA"
      }
    }
  }
}

---

ADIM 7 — Test (Otomatik Rehberlik)

1. Claude Desktop'ı tamamen kapat (sağ tık → Quit)
2. Yeniden aç
3. MCP ikonuna tıkla → google-ads-mcp listede görünmeli ve toggle mavi olmalı

Hesap erişim testi:

List all Google Ads accounts I have access to

Hesap numarası ve adı geliyorsa kurulum tamamdır.

Performans testi:

Son 30 günde hangi kampanyalar en iyi performansı gösterdi?

---

Yaygın Hatalar ve Çözümleri

Hata	Neden	Çözüm
No module named ads_mcp.auth	Auth modülü yok	pip install -e . ile yeniden kur
API Center yalnızca yönetici hesapları için	Normal hesap kullanılıyor	MCC aç, asıl hesabı bağla
Erişim engellendi: access_denied	Test kullanıcısı eklenmemiş	OAuth Consent Screen → Audience → Test Users
login-customer-id hatası	MCC ID eksik veya yanlış	.env'e ve config'e GOOGLE_ADS_LOGIN_CUSTOMER_ID ekle
The developer token is only approved for test accounts	Token production'a yükseltilmemiş	API Center'dan "Standard Access" talep et (1-2 iş günü)
MCP ikonunda google-ads-mcp görünmüyor	Config yanlış yazılmış	cat ile config dosyasını doğrula, Claude Desktop'ı yeniden başlat

---

Hızlı Test Sorguları

Kurulum tamamlandıktan sonra müşteriye verebileceğin başlangıç sorguları:

# Hesap genel bakış
List all Google Ads accounts I have access to

# Kampanya performansı (son 30 gün)
Son 30 günde hangi kampanyalar en iyi performansı gösterdi?

# Haftalık performans
Son bir haftada hangi kampanyalar en iyi performansı gösterdi?

# Anahtar kelime kalitesi
Which keywords have the lowest quality scores in account [ID]?

# Bütçe kırılımı
What is my total spend this month broken down by campaign?

# Dönüşüm takibi kontrolü
Check if conversion tracking is set up in account [ID]

# Arama terimleri raporu
Show search terms report for [Kampanya Adı] campaign, last 30 days

---

Önemli Notlar

• Mutations (değişiklik yapma) kapalı gelir. Kampanya düzenlenmeyecekse bu yeterli. Değişiklik isteniyorsa .env'e ADS_MCP_ENABLE_MUTATIONS=true ekle ve kullanıcıyı uyar.
• Developer Token yeni alındıysa sadece test hesaplarında çalışır. Production hesapları için API Center'dan "Standard Access" talep edilmesi gerekir.
• Her müşteri için ayrı kurulum gerekir. Aynı bilgisayarda birden fazla hesap için ayrı klasör ve ayrı config bloğu oluştur.
• Kurulum tamamlandıktan sonraki raporlama akışı için google-ads-performans-raporu skill'ini kullan.