GotCashback MCP Server

Kösse össze a Claude-ot, a ChatGPT-t és más MCP-kompatibilis AI-asszisztenseket közvetlenül a GotCashback aktuális cashback-arányaival (online és üzletben, az összes cashback-portálon), a portál-összehasonlításokkal és kifizetési feltételekkel, az üzletadatokkal és az ajándékkártya-ajánlatokkal — naponta többször frissítve.

A hu.Gotcashback.com 113 cashback-portál visszatérítési arányait hasonlítja össze világszerte 42 országban, köztük 4 portált és 1 036 üzletet Magyarországon. Alapítva: 2020; üzemelteti: MNP Enterprises, LLC.

Mi az MCP?

A Model Context Protocol (MCP) egy nyílt szabvány, amely lehetővé teszi, hogy az AI-asszisztensek beszélgetés közben külső eszközöket hívjanak és aktuális adatokat kérjenek le. Ahelyett, hogy az AI elavult tanítóadatokból találgatná a cashback-arányokat, közvetlenül a GotCashback szerverét kérdezheti meg, és a mai számokat kapja.

Telepítési útmutató

Claude (claude.ai / Claude Desktop)

1. Nyissa meg a Beállítások → Konnektorok menüpontot (Claude Desktopban: Beállítások → Konnektorok; a claude.ai oldalon: a konnektorok ikonja egy beszélgetésben).
2. Kattintson az "Egyéni konnektor hozzáadása" lehetőségre.
3. Adja meg az URL-t: https://mcp.gotcashback.com
4. Adjon neki nevet (pl. "GotCashback"), és mentse el.
5. Engedélyezze a konnektort minden olyan beszélgetésben, ahol cashback-lekérdezéseket szeretne — a Claude automatikusan meghívja az eszközöket, amikor az releváns.

Claude Code (terminál)

Adja hozzá a szervert egyetlen paranccsal:

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

Futtassa a /mcp parancsot a Claude Code-ban a kapcsolat ellenőrzéséhez, illetve a bejelentkezéshez, ha a fiókeszközöket szeretné használni.

ChatGPT

1. Nyissa meg a Beállítások → Konnektorok menüpontot (azoknál a csomagoknál érhető el, amelyek támogatják az egyéni/fejlesztői konnektorokat).
2. Válassza az egyéni konnektor hozzáadását, és adja meg a szerver URL-jét: https://mcp.gotcashback.com
3. Kövesse az utasításokat az engedélyezéshez, majd kapcsolja be a használatát a csevegésben vagy egy egyéni GPT beállításaiban.

VS Code (GitHub Copilot ügynök mód)

Futtassa az "MCP: Add Server" parancsot a parancspalettából, vagy adja hozzá ezt a .vscode/mcp.json fájlhoz:

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

Egyéb MCP-kompatibilis kliensek (Cursor, Windsurf stb.)

A legtöbb MCP-kliens elfogad egy távoli szerverre mutató JSON-konfigurációt. Egy tipikus bejegyzés így néz ki:

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

Hogy hol található ez a konfigurációs fájl, azt az adott kliens dokumentációjában nézze meg (pl. ~/.cursor/mcp.json a Cursor esetén) — a fenti URL és szerkezet a legtöbb kliensnél azonos, mert ugyanazt az MCP-specifikációt követik.

Példakérdések a csatlakozás után

• "Mi most a legjobb cashback-mérték a Best Buy üzletnél?"
• "Vannak kedvezményes ajándékkártyák a Target üzlethez?"
• "What's the best cashback rate for Walmart in Canada?"
• "Compare gift card discounts for Home Depot."
• "Mely cashback portálok érhetők el az Egyesült Királyságban?"
• "Hol vásárolhatok Adidas termékeket a legjobb cashbackkel?"
• "Hol vásárolhatok kutyaeledelt a legnagyobb kedvezménnyel?"
• "Mely egyesült királyságbeli cashback portálok fizetnek PayPalon keresztül, és melyiknél a legalacsonyabb a minimális kifizetés?"
• "Ad a TopCashback regisztrációs bónuszt, és milyen gyakran fizet ki?"
• "Figyelmeztessen, ha a Nike cashback-mértéke eléri a 10%-ot."
• "Adja hozzá a Best Buy üzletet a kedvenc üzleteimhez."

Az utolsó kettő az opcionális fiókeszközöket használja, és bejelentkezést kér a GotCashback-fiókjával.

Inkább Telegramon csevegne? Próbálja ki a GotCashback Telegram botot

Mit tud a GotCashback MCP szerver

Csatlakozás után az AI-asszisztens összehasonlíthatja egy üzlet aktuális online és üzletbeli cashback-arányait a portálok között, kedvezményes ajándékkártyákat kereshet, a legjobb ajánlat szerint rangsorolhatja a márkát vagy vásárlási kategóriát kínáló üzleteket, országonként böngészheti az üzleteket, és megnézheti az egyes portálok kifizetési feltételeit (regisztrációs bónusz, minimális kifizetés, kifizetési gyakoriság, fizetési módok). A szerver megmondja az asszisztensnek, melyik eszköz melyik kérdéstípusra válaszol, így egy egyszerű kérdés, például "best cashback for Walmart", egyből a megfelelő lekérdezéshez jut. Az arányok naponta többször frissülnek.

Hogyan választ eszközt az asszisztens

A szerver megmondja a csatlakoztatott asszisztenseknek, melyik eszköz melyik kérdésre válaszol, így természetes módon kérdezhet:

• Cashback egy adott üzlethez ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
• Kedvezményes ajándékkártyák egy adott üzlethez ("best Gap gift card discount") → get_gift_cards_by_store_name
• Hol vásárolhatók meg egy márka termékei a legnagyobb megtakarítással ("best cashback on Adidas products") → get_best_deals_by_brand
• Hol vásárolható meg egy terméktípus a legnagyobb megtakarítással ("cheapest dog food with cashback") → get_best_deals_by_category
• Egy portál regisztrációs bónusza, minimális kifizetése, kifizetési ütemezése vagy fizetési módjai → get_portals_by_name / get_portals
• Mely üzletek kínálnak cashbacket egy országban → get_stores_by_country

Említse meg az országot, ha számít ("in Canada", "UK cashback"): az asszisztens kisbetűs országkódot ad át, például us, ca, gb (Egyesült Királyság) vagy de, egyébként pedig az összes támogatott országban keres.

Az asszisztensek közvetlenül ezekhez az eszközökhöz nyúlnak — soha nem kell előbb országokat, üzleteket vagy portálokat felsorolniuk.

Elérhető eszközök

A country_code kisbetűs ISO-kód, például us, ca, gb (Egyesült Királyság) vagy de; opcionális, hacsak nincs kötelezőként jelölve. A store_id, portal_id és hasonló azonosítók egy korábbi eredményből származnak.

Követett linkek az eredményekben

Az eredményekben minden üzlet, cashback-mérték, ajándékkártya és portál-regisztrációs bónusz követett GotCashback-linket tartalmaz (url, illetve ahol releváns, gift_cards_url). A cashbacket csak akkor írják jóvá, az ajándékkártya-kedvezmény csak akkor érvényes, és a regisztrációs bónuszt csak akkor adják meg, ha ezeken a linkeken keresztül kattint át. A szerver arra utasítja az AI-klienseket, hogy mindig jelenítsék meg őket — ha egy asszisztens link nélkül idéz egy mértéket, kérje el tőle a linket.

Fiókeszközök (opcionális bejelentkezés)

A GotCashback-fiókkal való bejelentkezés (OAuth 2.1 — az AI-kliense automatikusan felajánlja) további, felhasználóhoz kötött eszközöket old fel. A fenti összehasonlító eszközök bejelentkezés nélkül is működnek.

Ezek ugyanazok a figyelmeztetések, amelyeket a webhelyen a Fiók → Figyelmeztetések menüpontban kezel: az alert_type értéke cashback vagy gift_card, a threshold_percent 1 és 100 közötti, egy meglévő figyelmeztetés újbóli mentése frissíti a küszöbértékét és újra élesíti, és fiókonként legfeljebb 10 aktív figyelmeztetés lehet.

Hogyan működik a bejelentkezés

1. Amikor először használ egy fiókeszközt, a szerver engedélyezési kihívással válaszol, és az AI-kliense megnyitja a böngészőben a GotCashback bejelentkezési oldalát — ugyanazzal a közösségi bejelentkezéssel, mint a webhelyen. Nincs szükség regisztrációra vagy API-kulcsra.
2. Hagyja jóvá a kért engedélyeket (hatóköröket), és térjen vissza a klienséhez. Az eszközhívás befejeződik, és a kapcsolat bejelentkezve marad — az offline_access hatókört kérő kliensek frissítési tokeneket kapnak, így nem kell újra bejelentkeznie.
3. A leválasztáshoz távolítsa el a konnektort az AI-klienséből. Ha egy eszköz később hiányzó hatókört jelez, távolítsa el, majd adja hozzá újra a konnektort, hogy a kliens újból engedélyezést kérjen.

A szerver végpontja

https://mcp.gotcashback.com

Ez egy távoli MCP szerver (Streamable HTTP transzport). Semmit sem kell telepítenie vagy üzemeltetnie — csak irányítson egy kompatibilis AI-asszisztenst a fenti URL-re.

Fejlesztőknek és AI-ügynököknek

A szerver (1.1.0-s verzió) kizárólag eszközöket kínál (erőforrásokat és promptokat nem). Minden eszköznek van címe, leírása arról, mikor kell használni, csak olvasható annotációi és — az összehasonlító eszközöknél — közzétett kimeneti sémája. Ezek a végpontok lehetővé teszik, hogy egy ügynök vagy integráció felfedezze a szervert és csatlakozzon hozzá az oldal elolvasása nélkül:

Az összehasonlító eszközök a nyers API-JSON-t szövegként, valamint a kimeneti sémájuknak megfelelő típusos strukturált tartalmat adják vissza, így az integrációk találgatás nélkül olvashatják az üzletet, a portált, az arányt, az „akár" jelölést és az online/üzletbeli mezőket. Az ismeretlen azonosítók és az API-kiesések eszközhibaként térnek vissza, nem protokollhibaként.

• https://mcp.gotcashback.com — MCP végpont — Streamable HTTP, JSON-RPC POST-on keresztül, állapotmentes (nincs szükség munkamenet-affinitásra)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — MCP szerverkártya, amely leírja a szervert, a transzportot és a hitelesítést (ezen a webhelyen is elérhető)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — OAuth védett erőforrás metaadatai: támogatott hatókörök és az engedélyezési szerver
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Engedélyezési szerver metaadatai — authorization code flow PKCE-vel, dinamikus kliensregisztráció (nyilvános és bizalmas kliensek), frissítési tokenek
• https://www.gotcashback.com/auth.md — Ügynök-hitelesítési szabályzat
• https://www.gotcashback.com/llms.txt — Ügynökök által olvasható webhelyindex
• https://api.gotcashback.com/swagger/ — Az eszközök mögötti ingyenes REST API (OpenAPI-specifikáció, kulcs nem szükséges)
• https://mcp.gotcashback.com/health — Állapotellenőrzés

A CORS bármely origin számára nyitott, így a böngészőalapú ügynökök közvetlenül csatlakozhatnak; az Mcp-Session-Id és a WWW-Authenticate válaszfejlécek elérhetők.

Kérdése vagy problémája van?

Ha a kapcsolódás sikertelen, vagy egy eszközhívás hibára fut, ellenőrizze, hogy az URL pontosan https://mcp.gotcashback.com formában van megadva, útvonal nélkül. Ha egy fiókeszköz folyton bejelentkezést kér, távolítsa el, majd adja hozzá újra a konnektort. További segítségért forduljon a GotCashback ügyfélszolgálatához.