API ve yapay zeka asistanları/Yapay zeka asistanı bağlama

Yapay zeka asistanı bağlama

Salt okunur MCP bağlayıcısı aracılığıyla claude.ai, ChatGPT, Claude Code, Cursor, VS Code veya Claude Desktop'a Gloriads hesabınızla ilgili sorular sorun.

Gloriads'e bir yapay zeka asistanı bağlayın ve hesabınızla ilgili sorularınızı gündelik bir dille sorun.

Asistan, Gloriads API'sinin gördüğünün tam olarak aynısını görür ve hesabınızda hiçbir şeyi değiştirmez.

Asistanın görebildikleri

  • API'nin gördüğü her şeyi, başka hiçbir şeyi.
  • Değiştirebileceği hiçbir şey yok: ne ayarlar ne faturalandırma.
  • Verileriniz Gloriads'in dışına çıkar. Yalnızca güvendiğiniz bir asistanı bağlayın: asistan hesabınızı okuduktan sonra bağlantısını kesmek (Ayarlar → API → Bağlı uygulamalar) yeni okumaları durdurur, ancak zaten okuduklarını geri alamaz.

Neler sorabilirsiniz

  • “Reklamlarım geçen ay nasıl gitti ve en çok hangi pazaryerinde harcadım?”
  • “ACOS değerim bir önceki aya göre daha iyi mi?”
  • “Son 30 günde ACOS değeri en kötü olan ürünler hangileri?”
  • “Bu ayki harcamamı gün gün göster.”
  • “Almanya'daki duraklatılmış kampanyalarımı listele.”
  • “Bu kampanya hangi anahtar kelimeleri hedefliyor?”
  • “Kurallarım bu hafta neleri değiştirdi, teklif teklif?”

Asistan, panelinizdeki rakamların aynısını okur: okuyabildiklerinin listesi API'nin okuduğu veriler sayfasındadır.

Adres ve her asistanın ihtiyacı

Tüm asistanlar için aynı olan tek bir adres:

https://gloriads.com/api/mcp
Asistanİhtiyacı olan
claude.ai, Claude DesktopGiriş yapar ve İzin ver düğmesine tıklarsınız. Kopyalanacak anahtar yok.
ChatGPTAynı giriş, ancak geliştirici modunda ve ücretli bir planda.
Claude Code, Cursor, VS CodeAyarlar → API sayfasından API anahtarlarınızdan biri.

Özel MCP sunucularını destekleyen diğer araçlar da aynı adresi kullanabilir.

Her şey uygulamada tek bir sayfadadır, Ayarlar → API: adres, hazır komutlar ve anahtarlarınız. Her bloğun bir Kopyala düğmesi vardır.

claude.ai

  1. claude.ai'de sol menüden Customize (Özelleştir) sayfasını açın.

  2. Connectors (Bağlayıcılar) sekmesini açın.

  3. Add (Ekle), ardından Add custom connector (Özel bağlayıcı ekle) düğmesine tıklayın.

  4. Adını Gloriads olarak girin, https://gloriads.com/api/mcp adresini yapıştırın, ardından Continue (Devam) düğmesine tıklayın.

  5. Sonraki sayfada hiçbir şeyi değiştirmeyin: claude.ai, girişi Gloriads'in yaptığını ve Gloriads'in kendi kimliğini yayımladığını algıladı. Add (Ekle) düğmesine tıklayın.

  6. Connect (Bağlan) düğmesine tıklayın.

  7. İstenirse Gloriads'e giriş yapın.

  8. Erişim isteyen uygulamayı kontrol edin, ardından İzin ver düğmesine tıklayın.

  9. claude.ai'ye geri yönlendirilirsiniz. Bağlayıcı sayfasında, Tool permissions (Araç izinleri) altında Always allow (Her zaman izin ver) seçeneğini seçin: Claude bundan sonra rakamlarınızı her seferinde sormadan okur; bu bağlayıcı başka hiçbir şey yapamaz.

Bir sohbette, uygulama isterse bağlayıcıyı açın, ardından sorunuzu sorun.

Haiku'ya sorun. En hızlı ve en ucuz Claude modelidir; rakamlarınızı okumak ondan daha fazlasını gerektirmez. Sohbetinizin model menüsünden seçin.

Ücretsiz bir Claude hesabı bir özel bağlayıcı ekleyebilir.

Bağlantıyı kesmek için Gloriads'te Ayarlar → API → Bağlı uygulamalar sayfasını açın ve Bağlantıyı kes seçeneğini seçin. Asistan rakamlarınızı okumayı hemen bırakır.

Claude Desktop

Claude Desktop, claude.ai ile aynı bağlayıcıları kullanır; bu yüzden başka bir şey yüklemeniz gerekmez: bağlayıcıyı ikisinden birinden ekleyin, giriş yapın ve İzin ver düğmesine tıklayın. Bağlayıcı ardından her ikisinde de çalışır.

ChatGPT

ChatGPT, Claude gibi bağlanmaz: özel sunucuları geliştirici modunun (developer mode) arkasındadır ve bu mod yalnızca ChatGPT'nin ücretli planlarında sunulur. İzlenecek yolun tamamı şöyle:

  1. ChatGPT'nin ayarlarında geliştirici modunu açın.

  2. Plugins (Eklentiler), ardından New plugin (Yeni eklenti) bölümünü açın.

  3. Name (Ad): Gloriads yazın. Simge ve açıklama isteğe bağlıdır.

  4. Connection (Bağlantı): Server URL (Sunucu URL'si) seçeneğini koruyun ve https://gloriads.com/api/mcp adresini yapıştırın.

  5. Authentication (Kimlik doğrulama): OAuth seçeneğini seçin. Altında doldurulacak bir şey yoktur: Gloriads ayarlarını bu adreste yayımlar ve ChatGPT bunları okur.

  6. I understand and want to continue (Anlıyorum ve devam etmek istiyorum) kutusunu işaretleyin (ChatGPT bu uyarıyı bizimki dahil her özel sunucu için gösterir), ardından Create (Oluştur) düğmesine tıklayın.

  7. ChatGPT Gloriads'i açar: istenirse giriş yapın, erişim isteyen uygulamanın ChatGPT olduğunu kontrol edin, ardından İzin ver düğmesine tıklayın.

  8. Bir sohbette, ilk sorunuzu sormadan önce eklentiyi açın.

  9. ChatGPT'nin kendi başına ne kadarını yapabileceğini Settings → Plugins → Gloriads → Permissions (Ayarlar → Eklentiler → Gloriads → İzinler) bölümünden seçin. Allow read actions (Okuma işlemlerine izin ver) yeterlidir: bu bağlayıcı yalnızca okuyabilir. Allow all actions (Tüm işlemlere izin ver) yüksek riskli olarak işaretlidir ve burada size hiçbir şey kazandırmaz.

Bağlantıyı kesmek için Gloriads'te Ayarlar → API → Bağlı uygulamalar sayfasını açın ve Bağlantıyı kes seçeneğini seçin; claude.ai ile tamamen aynı.

Claude Code

Ayarlar → API → Anahtar oluştur ile bir anahtar oluşturun, adını “Claude Code” koyun ve kopyalayın. Anahtar yalnızca bir kez gösterilir.

Ardından bir terminalde, YOUR_API_KEY yerine kendi anahtarınızı yazarak şunu çalıştırın:

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
  • claude mcp list ile ya da Claude Code içinde /mcp ile kontrol edin.
  • Sunucu geçerli projeye eklenir. Her yerde kullanmak için --scope user ekleyin.
  • Kaldırmak için: claude mcp remove gloriads.

Cursor

Anahtarınızı GLORIADS_API_KEY ortam değişkenine koyun, ardından şunu ~/.cursor/mcp.json (tüm projeleriniz) ya da .cursor/mcp.json (tek bir proje) dosyasına yapıştırın:

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

Cursor anahtarı bu değişkenden okur; böylece dosya anahtarı asla içermez. Değişkeni Cursor'ı açmadan önce ayarlayın.

VS Code

Komut Paleti'nden MCP: Open User Configuration komutunu açın (tüm projeleriniz) ya da bir projede .vscode/mcp.json dosyasını oluşturun ve şunu ekleyin:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

VS Code, sunucu ilk kez başladığında anahtarı sorar ve hatırlar; böylece dosya anahtarı asla içermez.

Kullandığı araçlar

Asistan, sorunuz için doğru aracı seçer. Her araç API'nin bir bölümünü okur.

AraçOkuduğuÖrnek soru
get_accountAboneliğiniz, Amazon Ads'in bağlı olup olmadığı, rakamların hangi güne kadar geldiği“Aboneliğim etkin mi?”
list_marketplacesBağlı pazaryerleriniz ve her birinde kaç kampanya yayında olduğu“Hangi pazaryerleri bağlı?”
get_summaryBir dönemin toplamları, pazaryerine ve reklam türüne göre; isterseniz daha önceki bir dönemle karşılaştırmalı“Geçen ay ne kadar harcadım ve bir önceki aya göre ne değişti?”
get_timelineAynı rakamlar gün gün veya ay ay“Bu ayki satışlarımı gün gün göster.”
get_products_reportHer ürünün bir dönemdeki rakamları“ACOS değeri en kötü olan ürün hangisi?”
get_streaming_tv_reportBir pazaryerinin Streaming TV kampanyaları ve rakamları“TV reklamlarım bu ay ABD'de nasıl gitti?”
list_campaignsBir pazaryerinin kampanyaları“Almanya'daki duraklatılmış kampanyalarımı listele.”
list_ad_groupsBir pazaryerinin reklam grupları“Bu kampanyanın reklam gruplarının varsayılan teklifi ne?”
list_targetsBir kampanyanın anahtar kelimeleri ve diğer hedefleri“Bu kampanya hangi anahtar kelimeleri hedefliyor ve hangi teklifle?”
list_adsBir kampanyanın reklamları“Bu kampanya hangi ürünlerin reklamını yapıyor?”
list_rulesKurallarınız“Hangi kurallarım açık?”
list_rule_runsBir kuralın son çalıştırmaları“Bu kural son çalıştırmasında neyi değiştirdi?”
list_activityGloriads'in Amazon'da yaptığı her şey“Gloriads bu hafta neleri değiştirdi?”
get_activityTek bir işlem“O kopyalama işlemi bitti mi?”
list_activity_linesBir işlemin değiştirdikleri, satır satır“O kural hangi teklifleri ne kadar düşürdü?”

Bilinmesi gerekenler

  • Uygulamadakiyle aynı rakamlar. Her yanıt hangi dönemi ve para birimini kullandığını söyler; bir rakam eksik olduğunda bunu da belirtir.
  • Bir anahtar hesabınızın tamamını okur. Anahtarı paylaşılan dosyalardan uzak tutun ve asistanı kullanmayı bıraktığınız gün Ayarlar → API sayfasından iptal edin.
  • Sınırlar API ile ortaktır: hesabınız için dakikada 60 ve günde 10.000 istek. Tek bir soru birkaç isteğe mal olabilir. Bkz. Sınırlar ve hatalar.
  • Hesap olmadan deneyin: bir geliştirici aracında, API referansındaki herkese açık demo anahtarı burada da çalışır ve demo hesabının sentetik rakamlarını okur.