Geliştiriciler için · Claude ve Cursor desteklenir

MCP entegrasyon kılavuzu

Model Context Protocol ile Claude, Cursor veya kendi AI ajanınız DEXUN AdWhiz verilerinizi görüntüleyebilir: üç platformdaki bağlı reklam hesapları, AI önerileri ve son etkinlikler. Salt okunur.

MCP nedir?

MCP (Model Context Protocol), Anthropic'in 2024'te sunduğu ve AI uygulamalarının harici verilere ve araçlara nasıl güvenli şekilde erişeceğini tanımlayan açık bir standarttır. Bunu "AI için USB-C" gibi düşünebilirsiniz — herhangi bir MCP istemcisinin (Claude Desktop, Cursor, kendi ajanınız) herhangi bir MCP sunucusunu (DEXUN AdWhiz, Notion, GitHub vb.) çağırabildiği tek bir arayüz.

DEXUN AdWhiz MCP sunucusu salt okunur 5 araç sunar: bağlı reklam hesaplarınız, AI'ın açık önerileri, tasarruf özetiniz, son hesap etkinlikleri ve API kotanız. Reklam hesaplarınızda hiçbir şeyi değiştiremez, duraklatamaz veya oluşturamaz. Her çağrı API anahtarınızla doğrulanır ve REST API'mizle aynı, plana bağlı hız sınırlarına tabidir.

Hızlı başlangıç

Üç adım. Yaklaşık beş dakika sonra AI asistanınıza reklam hesaplarınızı sorabilirsiniz.

1

Claude Desktop'u yapılandırın

claude_desktop_config.json dosyasını düzenleyin (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) ve şunu ekleyin:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

Cursor'ı yapılandırın

Proje düzeyindeki .cursor/mcp.json veya genel yapılandırma üzerinden:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

Doğrulayın

Claude'u veya Cursor'ı yeniden başlatın, ardından bu istemi deneyin. AI'ın list_ad_accounts veya list_recommendations çağırdığını ve gerçek verilerinizi döndürdüğünü görürseniz bağlantı tamamdır.

Claude'a sorun:

“Bağlı reklam hesaplarımı listele ve AI'ın açık önerilerini özetle: hangi kampanyaların değiştirilmesini öneriyor ve neden?”

Araç kataloğu

MCP sunucusu 5 araç sunar ve hepsi salt okunurdur. Her aracın eksiksiz bir JSON Schema'sı vardır; böylece AI hangi aracı ne zaman çağıracağına kendisi karar verir.

list_ad_accounts

Salt okunur

Bağlı Google Ads, Meta Ads ve TikTok Ads hesaplarınız ve bağlantı durumları.

list_recommendations

Salt okunur

AI'ın açık optimizasyon önerileri (bütçe artırma, azaltma, duraklatma); her biri gerekçe, beklenen etki ve güven düzeyiyle.

get_savings_summary

Salt okunur

Tasarruf özetiniz: kontrol panelinizdeki tasarruf rakamlarına yönlendirir; planınızı da gösterir.

get_recent_activity

Salt okunur

Son hesap etkinlikleri: girişler, API anahtarı değişiklikleri, reklam hesabı bağlantıları ve abonelik değişiklikleri.

get_quota

Salt okunur

Mevcut API hız sınırınız: dakika başına istek sayısı, kalan istek ve pencerenin sıfırlanma zamanı.

AI istemciniz aynı araçları parametreleriyle birlikte standart MCP tools/list isteğiyle listeler.

Örnek oturum

Salt okunur erişimin nasıl göründüğünü gösteren örnek bir konuşma (örnek veriler):

AdWhiz'e hangi reklam hesaplarını bağladım?

Bağlı üç hesabınız var: Google Ads, Meta Ads ve TikTok Ads'te birer hesap. Üçü de bağlı görünüyor.

list_ad_accounts

AI şu anda ne öneriyor?

2 açık öneri var: ① “Lookalike 1%” adlı Meta kampanyasının günlük bütçesini azaltın — ROAS'ı geçen hafta boyunca hesap ortalamasının altında kaldı; ② bir TikTok Spark Ads kampanyasının bütçesini artırın. Her öneri gerekçe ve güven puanı içerir. Uygulamak isterseniz değişikliği reklam platformunuzda yapın — buradan hiçbir şeyi değiştiremem.

list_recommendations

Son zamanlarda hesabımda bir şey değişti mi?

Son 7 günde: 2 giriş, 1 yeni API anahtarı ve TikTok Ads hesabınızın yeniden bağlanması. Başka kayıt yok.

get_recent_activity

Güvenlik ve izinler

  • 5 aracın tamamı salt okunurdur: AI verilerinizi görüntüleyebilir, ancak bütçeleri değiştiremez, reklamları duraklatamaz veya kampanya oluşturamaz
  • MCP sunucusu yerel olarak çalışır — dxk_ API anahtarınız makinenizden çıkıp üçüncü taraflara gitmez
  • Çağrılar API anahtarınızla doğrulanır ve planınızın REST API hız sınırlarını paylaşır (get_quota ile kontrol edin)
  • Kampanyalarınızdaki değişiklikleri MCP üzerinden değil, kendiniz yaparsınız
  • MCP erişimini istediğiniz zaman kontrol paneli → Ayarlar → API Keys bölümünden iptal edin