TheAdX DSP — MCP Sunucusu Kurulumu

Bu sayfa: https://api.theadx.com/doc/mcp.html — REST API dokümanı: https://api.theadx.com/doc/dsp.html

TheAdX DSP MCP sunucusu, MCP (Model Context Protocol) destekleyen herhangi bir yapay zekâ istemcisinden — Claude (web, masaüstü, mobil, Claude Code), ChatGPT, Gemini CLI, Cursor, VS Code ve benzerleri — kampanyalarınızı listelemenizi, istatistik ve site performansı almanızı, bütçe/CPM güncellemenizi ve optimizasyon önerileri istemenizi sağlar.

Sunucu adresi (uzak, Streamable HTTP): https://api.theadx.com/theadx-mcp/mcp

Gereksinimler

• Uzak MCP sunucusu (Streamable HTTP) ekleyebilen bir istemci — aşağıdaki listeden biri ya da eşdeğeri
• TheAdX DSP hesabı (panele girdiğiniz e-posta ve şifre)

Bilgisayarınıza bir şey kurmanız gerekmez; token kopyalamak da gerekmez. Giriş sohbet içinde yapılır (bkz. "Sohbette giriş yapın").

1. Sunucuyu istemcinize ekleyin

Aşağıdan kullandığınız istemciyi seçin. Hepsinde ad TheAdX DSP, adres yukarıdaki URL'dir.

Claude — web (claude.ai), masaüstü ve mobil

Bağlayıcılar hesabınıza bağlıdır: web ya da masaüstünden bir kez eklediğinizde iOS/Android uygulamasında da görünür.

claude.ai ya da Claude Desktop → Settings → Connectors → Add custom connector

• Name: TheAdX DSP
• URL: https://api.theadx.com/theadx-mcp/mcp

Eklemeyi dosyadan yapmayı tercih ederseniz (yalnız Claude Desktop) claude_desktop_config.json içine:

{
  "mcpServers": {
    "theadx-dsp": {
      "url": "https://api.theadx.com/theadx-mcp/mcp",
      "transport": "streamable-http"
    }
  }
}

Dosya konumu: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json. Dosyayı düzenledikten sonra Claude Desktop'ı tamamen kapatıp açın.

Claude Code (terminal)

claude mcp add --transport http theadx-dsp https://api.theadx.com/theadx-mcp/mcp

claude mcp list ile bağlantıyı doğrulayın. Projeye özel tutmak için --scope project ekleyin (.mcp.json dosyasına yazılır).

ChatGPT

ChatGPT → Settings → Connectors → Advanced → Developer mode açın, sonra Create ile:

• Name: TheAdX DSP
• MCP Server URL: https://api.theadx.com/theadx-mcp/mcp
• Authentication: No authentication (giriş sohbet içinde login tool'u ile yapılır)

Sohbette bağlayıcıyı seçili hale getirdikten sonra aşağıdaki giriş adımına geçin. Özel bağlayıcı ekleme ChatGPT'nin ücretli planlarında sunulur; menü yoksa plan ve iş yeri ayarlarınızı kontrol edin.

Gemini CLI

~/.gemini/settings.json içine:

{
  "mcpServers": {
    "theadx-dsp": {
      "httpUrl": "https://api.theadx.com/theadx-mcp/mcp"
    }
  }
}

CLI içinde /mcp komutu sunucuyu ve tool'larını listeler. Gemini web/mobil uygulaması bu yazı itibarıyla özel MCP sunucusu eklemeyi desteklemiyor; Gemini API ile kendi uygulamanızı yazıyorsanız GEMINI_INTEGRATION.md dosyasına bakın.

Cursor, VS Code (Copilot), Windsurf ve diğerleri

Bu istemciler mcp.json benzeri bir dosya kullanır; uzak sunucu girdisi şu biçimdedir:

{
  "mcpServers": {
    "theadx-dsp": {
      "url": "https://api.theadx.com/theadx-mcp/mcp"
    }
  }
}

Dosya adı ve konumu istemciye göre değişir (Cursor ~/.cursor/mcp.json, VS Code .vscode/mcp.json — VS Code'da anahtar servers ve "type": "http" alanı gerekir). İstemcinizin MCP dokümanındaki "remote / HTTP server" örneğini bu adresle kullanın.

2. Sohbette giriş yapın

Hangi istemciyi kullanırsanız kullanın giriş aynıdır. Yeni bir sohbette şunu yazın:

TheAdX DSP'ye giriş yap, e-postam: ornek@firma.com

Asistan login tool'unu çağırır ve şifrenizi sorar. Şifreyi verdiğinizde sunucu DSP API'den token alır ve sunucu tarafında, sizin oturumunuza bağlı tutar; token sohbete yazılmaz, ekrana gelmez.

• Oturum 24 saat geçerlidir. Süre dolunca tool'lar not authenticated - please call login tool first der; yeniden "giriş yap" demeniz yeterlidir.
• Art arda hatalı denemelerde too many login attempts, please wait a moment gelir; bir dakika bekleyin.

API anahtarları burada kullanılmaz. DSP panelinde Ayarlar → API Erişimi sekmesinden üretilen apikey/secretkey çiftleri yalnız REST API (/user/login) içindir. Bu anahtarlarla alınan token alındığı IP'ye bağlıdır; MCP sunucusu DSP API'ye kendi adresinden gittiği için böyle bir token MCP'de you cant use current auth token for this ip hatası verir. MCP'de her zaman e-posta + şifre kullanın.

3. Deneyin

• "kampanyalarımı listele"
• "aktif kampanyaların son 7 gün performansını göster"
• "kampanya #17554 için optimizasyon önerileri ver"
• "kampanya #17554'te en iyi siteyi ve o sitedeki en iyi banner'ı bul"

Alternatif: token'ı başlıkla vermek

Kendi MCP istemcinizi yazıyorsanız ve başlık gönderebiliyorsanız, REST API /user/login ile (e-posta + şifre) aldığınız accessToken'ı her istekte X-DSP-Token: <token> başlığıyla verebilirsiniz; o zaman login tool'una gerek kalmaz. Yalnız bu başlık okunur:

Claude ve ChatGPT'nin bağlayıcı ekranları özel başlık göndermez; onlarda 2. adımdaki sohbet içi giriş yolunu izleyin.

Alternatif: yerel çalıştırma (STDIO)

Sunucuyu kendi makinenizde çalıştırmak isterseniz:

cd mcp-server
go build -o theadx-dsp-mcp .
mv theadx-dsp-mcp /usr/local/bin/

STDIO destekleyen istemcilerde (Claude Desktop, Claude Code, Cursor, Gemini CLI vb.) sunucu girdisi:

{
  "mcpServers": {
    "theadx-dsp": {
      "command": "/usr/local/bin/theadx-dsp-mcp",
      "env": {
        "DSP_API_BASE_URL": "https://api.theadx.com",
        "DSP_API_EMAIL": "ornek@firma.com",
        "DSP_API_PASSWORD": "sifreniz"
      }
    }
  }
}

Bu modda giriş açılışta ortam değişkenleriyle otomatik yapılır. DSP_API_EMAIL/DSP_API_PASSWORD yerine hazır bir DSP_API_TOKEN da verilebilir (24 saat sonra elle yenilemeniz gerekir; bu yüzden e-posta + şifre tercih edin). Claude web/mobil ve ChatGPT yerel süreç çalıştıramaz; onlarda uzak sunucuyu kullanın.

Sorun giderme

Başlıca tool'lar

Sunucu 70'ten fazla tool sunar; en çok kullanılanlar:

Tam liste ve parametreler için istemcinizde tool listesini açın; her tool'un açıklaması kullanım kurallarını içerir.