GotCashback MCP Sunucusu

Claude, ChatGPT ve MCP uyumlu diğer yapay zeka asistanlarını doğrudan GotCashback'in güncel cashback oranlarına (çevrimiçi ve mağazada, tüm cashback portallarında), portal karşılaştırmalarına ve ödeme koşullarına, mağaza verilerine ve hediye kartı fırsatlarına bağlayın — günde birkaç kez güncellenir.

tr.Gotcashback.com, dünya genelinde 42 ülkedeki 113 cashback portalının cashback oranlarını karşılaştırır; Türkiye'deki 2 portal ve 131 mağaza dahil. 2020 yılında kuruldu; MNP Enterprises, LLC tarafından işletilmektedir.

MCP nedir?

Model Context Protocol (MCP), yapay zeka asistanlarının bir sohbet sırasında harici araçları çağırmasına ve güncel verileri çekmesine olanak tanıyan açık bir standarttır. Yapay zeka, cashback oranlarını güncelliğini yitirmiş eğitim verilerinden tahmin etmek yerine doğrudan GotCashback sunucusuna sorabilir ve bugünün rakamlarını alabilir.

Kurulum talimatları

Claude (claude.ai / Claude Desktop)

1. Ayarlar → Bağlayıcılar bölümünü açın (Claude Desktop'ta: Ayarlar → Bağlayıcılar; claude.ai'de: sohbetteki bağlayıcılar simgesi).
2. "Özel bağlayıcı ekle" seçeneğine tıklayın.
3. URL'yi girin: https://mcp.gotcashback.com
4. Bir ad verin (örn. "GotCashback") ve kaydedin.
5. Cashback sorguları istediğiniz her konuşmada bağlayıcıyı etkinleştirin — Claude, uygun olduğunda araçları otomatik olarak çağıracaktır.

Claude Code (terminal)

Sunucuyu tek komutla ekleyin:

claude mcp add --transport http gotcashback https://mcp.gotcashback.com

Bağlantıyı kontrol etmek ve hesap araçlarını istediğinizde oturum açmak için Claude Code içinde /mcp komutunu çalıştırın.

ChatGPT

1. Ayarlar → Bağlayıcılar bölümünü açın (özel/geliştirici bağlayıcılarını destekleyen planlarda mevcuttur).
2. Özel bağlayıcı ekleme seçeneğini seçin ve sunucu URL'sini girin: https://mcp.gotcashback.com
3. Yetkilendirmek ve sohbette veya özel bir GPT yapılandırmasında kullanmak üzere etkinleştirmek için yönergeleri izleyin.

VS Code (GitHub Copilot ajan modu)

Komut paletinden "MCP: Add Server" komutunu çalıştırın veya şunu .vscode/mcp.json dosyasına ekleyin:

{
  "servers": {
    "gotcashback": {
      "type": "http",
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Diğer MCP uyumlu istemciler (Cursor, Windsurf vb.)

Çoğu MCP istemcisi, uzak bir sunucuyu işaret eden bir JSON yapılandırması kabul eder. Tipik bir girdi şöyle görünür:

{
  "mcpServers": {
    "gotcashback": {
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Bu yapılandırma dosyasının nerede bulunduğunu istemcinizin belgelerinden kontrol edin (örn. Cursor için ~/.cursor/mcp.json) — yukarıdaki URL ve yapı, aynı MCP spesifikasyonunu izledikleri için çoğu istemcide aynıdır.

Bağlandıktan sonra örnek istemler

• "Best Buy için şu anda en iyi cashback oranı nedir?"
• "Target için indirimli hediye kartı var mı?"
• "What's the best cashback rate for Walmart in Canada?"
• "Compare gift card discounts for Home Depot."
• "Birleşik Krallık'ta hangi cashback portalları mevcut?"
• "Adidas ürünlerini en iyi cashback ile nereden satın alabilirim?"
• "Köpek mamasını en büyük indirimle nereden satın alabilirim?"
• "Birleşik Krallık'taki hangi cashback portalları PayPal ile ödeme yapıyor ve hangisinin minimum ödeme tutarı en düşük?"
• "TopCashback kayıt bonusu sunuyor mu ve ne sıklıkla ödeme yapıyor?"
• "Nike'ın cashback oranı %10'a ulaştığında beni uyar."
• "Best Buy'ı favori mağazalarıma ekle."

Son ikisi isteğe bağlı hesap araçlarını kullanır ve GotCashback hesabınızla oturum açmanızı isteyecektir.

Bunun yerine Telegram'da sohbet etmeyi mi tercih edersiniz? GotCashback Telegram botunu deneyin

GotCashback MCP sunucusu ne yapar

Bağlantı kurulduktan sonra bir yapay zeka asistanı, bir mağazanın güncel çevrimiçi ve mağaza içi cashback oranlarını portallar arasında karşılaştırabilir, indirimli hediye kartları bulabilir, bir markayı veya alışveriş kategorisini satan mağazaları en iyi fırsata göre sıralayabilir, mağazalara ülkeye göre göz atabilir ve her portalın ödeme koşullarını (kayıt bonusu, minimum ödeme, ödeme sıklığı, ödeme yöntemleri) öğrenebilir. Sunucu, asistana hangi aracın hangi tür soruyu yanıtladığını söyler; böylece "best cashback for Walmart" gibi sade bir soru doğrudan doğru sorguya gider. Oranlar günde birkaç kez güncellenir.

Bir asistan aracı nasıl seçer

Sunucu, bağlı asistanlara hangi aracın hangi soruyu yanıtladığını söyler; bu yüzden doğal bir şekilde sorabilirsiniz:

• Belirli bir mağaza için cashback ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
• Belirli bir mağaza için indirimli hediye kartları ("best Gap gift card discount") → get_gift_cards_by_store_name
• Bir markanın ürünlerini en çok tasarrufla nereden alabileceğiniz ("best cashback on Adidas products") → get_best_deals_by_brand
• Bir ürün türünü en çok tasarrufla nereden alabileceğiniz ("cheapest dog food with cashback") → get_best_deals_by_category
• Bir portalın kayıt bonusu, minimum ödemesi, ödeme takvimi veya ödeme yöntemleri → get_portals_by_name / get_portals
• Bir ülkede hangi mağazaların cashback sunduğu → get_stores_by_country

Önemli olduğunda bir ülke belirtin ("in Canada", "UK cashback"): asistan us, ca, gb (Birleşik Krallık) veya de gibi küçük harfli bir ülke kodu iletir; belirtmezseniz desteklenen tüm ülkelerde arar.

Asistanlar doğrudan bu araçlara gider — önce ülkeleri, mağazaları veya portalları listelemeleri asla gerekmez.

Kullanılabilir araçlar

country_code, us, ca, gb (Birleşik Krallık) veya de gibi küçük harfli bir ISO kodudur; zorunlu olarak belirtilmedikçe isteğe bağlıdır. store_id, portal_id ve benzeri kimlikler önceki bir sonuçtan gelir.

Sonuçlardaki izlenen bağlantılar

Bir sonuçtaki her mağaza, cashback oranı, hediye kartı ve portal kayıt bonusu, izlenen bir GotCashback bağlantısı (url ve ilgili durumlarda gift_cards_url) taşır. Cashback yalnızca bu bağlantılara tıkladığınızda hesabınıza yansır, hediye kartı indirimleri yalnızca bu şekilde uygulanır ve kayıt bonusları yalnızca bu şekilde verilir. Sunucu, yapay zeka istemcilerine bu bağlantıları her zaman göstermelerini söyler — bir asistan bağlantı vermeden bir oran aktarırsa, ondan bağlantıyı isteyin.

Hesap araçları (isteğe bağlı oturum açma)

GotCashback hesabınızla oturum açmak (OAuth 2.1 — yapay zeka istemciniz bunu otomatik olarak önerecektir) kullanıcıya özel ek araçların kilidini açar. Yukarıdaki tüm karşılaştırma araçları oturum açmadan da çalışmaya devam eder.

Uyarılar, web sitesinde Hesap → Uyarılar altında yönettiğiniz uyarılarla aynıdır: alert_type cashback veya gift_card olabilir, threshold_percent 1 ile 100 arasındadır, mevcut bir uyarıyı yeniden kaydetmek eşiğini günceller ve uyarıyı yeniden etkinleştirir, her hesapta en fazla 10 etkin uyarı bulunabilir.

Oturum açma nasıl çalışır

1. Bir hesap aracını ilk kez kullandığınızda sunucu bir yetkilendirme isteğiyle yanıt verir ve yapay zeka istemciniz tarayıcınızda GotCashback oturum açma sayfasını açar — web sitesindekiyle aynı sosyal giriş. Kayıt veya API anahtarı gerekmez.
2. İstenen izinleri (kapsamları) onaylayın ve istemcinize dönün. Araç çağrısı tamamlanır ve bağlantı oturum açık kalır — offline_access isteyen istemciler yenileme belirteçleri (refresh token) aldığından bir daha sorulmazsınız.
3. Bağlantıyı kesmek için bağlayıcıyı yapay zeka istemcinizden kaldırın. Bir araç daha sonra eksik bir kapsam bildirirse, istemcinin yetkilendirmeyi yeniden istemesi için bağlayıcıyı kaldırıp yeniden ekleyin.

Sunucu uç noktası

https://mcp.gotcashback.com

Bu, uzak bir MCP sunucusudur (Streamable HTTP aktarımı). Hiçbir şey kurmanız veya barındırmanız gerekmez — uyumlu bir yapay zeka asistanını yukarıdaki URL'ye yönlendirmeniz yeterlidir.

Geliştiriciler ve yapay zeka ajanları için

Sunucu (sürüm 1.1.1) yalnızca araçlar sunar (kaynak veya istem yok). Her aracın bir başlığı, ne zaman kullanılacağını söyleyen bir açıklaması, salt okunur ek açıklamaları ve — karşılaştırma araçları için — yayımlanmış bir çıktı şeması vardır. Bu uç noktalar, bir aracının veya entegrasyonun bu sayfayı okumadan sunucuyu keşfetmesine ve bağlanmasına olanak tanır:

Karşılaştırma araçları ham API JSON'unu metin olarak ve çıktı şemalarına uyan türlendirilmiş yapılandırılmış içerikle birlikte döndürür; böylece entegrasyonlar mağaza, portal, oran, "en fazla" ve çevrimiçi/mağaza içi alanlarını tahmin etmeden okuyabilir. Bilinmeyen kimlikler ve API kesintileri protokol hatası olarak değil, araç hatası olarak döner.

• https://mcp.gotcashback.com — MCP uç noktası — Streamable HTTP, POST üzerinden JSON-RPC, durumsuz (oturum yapışkanlığı gerekmez)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — Sunucuyu, aktarımı ve kimlik doğrulamayı açıklayan MCP sunucu kartı (bu sitede de sunulur)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — OAuth korumalı kaynak meta verileri: desteklenen kapsamlar ve yetkilendirme sunucusu
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Yetkilendirme sunucusu meta verileri — PKCE ile yetkilendirme kodu akışı, dinamik istemci kaydı (genel ve gizli istemciler), yenileme belirteçleri
• https://www.gotcashback.com/auth.md — Ajan kimlik doğrulama politikası
• https://www.gotcashback.com/llms.txt — Ajanların okuyabileceği site dizini
• https://api.gotcashback.com/swagger/ — Araçların arkasındaki ücretsiz REST API (OpenAPI spesifikasyonu, anahtar gerekmez)
• https://mcp.gotcashback.com/health — Sağlık kontrolü

CORS tüm kaynaklara açıktır, bu nedenle tarayıcı tabanlı ajanlar doğrudan bağlanabilir; Mcp-Session-Id ve WWW-Authenticate yanıt başlıkları açığa çıkarılır.

Sorularınız veya sorunlarınız mı var?

Bağlantı kurulamıyorsa veya bir araç çağrısı hata veriyorsa, URL'nin sonunda ek bir yol olmadan tam olarak https://mcp.gotcashback.com şeklinde girildiğini kontrol edin. Bir hesap aracı sürekli oturum açmanızı istiyorsa, bağlayıcıyı kaldırıp yeniden ekleyin. Daha fazla yardım için GotCashback destek ekibiyle iletişime geçin.