Máy chủ MCP GotCashback

Kết nối trực tiếp Claude, ChatGPT và các trợ lý AI tương thích MCP khác với tỷ lệ hoàn tiền hiện tại của GotCashback (trực tuyến và tại cửa hàng, trên các cổng hoàn tiền), so sánh cổng và điều khoản thanh toán, dữ liệu cửa hàng và ưu đãi thẻ quà tặng — làm mới nhiều lần mỗi ngày.

vn.GotCashback.com so sánh tỷ lệ hoàn tiền trên 98 cổng hoàn tiền tại 41 quốc gia trên toàn thế giới, bao gồm 2 cổng và 47 cửa hàng tại Việt Nam. Thành lập năm 2020; vận hành bởi MNP Enterprises, LLC.

MCP là gì?

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép trợ lý AI gọi các công cụ bên ngoài và lấy dữ liệu hiện tại trong quá trình trò chuyện. Thay vì AI đoán tỷ lệ hoàn tiền từ dữ liệu huấn luyện lỗi thời, nó có thể truy vấn trực tiếp máy chủ của GotCashback và nhận số liệu của ngày hôm nay.

Hướng dẫn cài đặt

Claude (claude.ai / Claude Desktop)

1. Mở Cài đặt → Connectors (trong Claude Desktop: Settings → Connectors; trên claude.ai: biểu tượng connectors trong cuộc trò chuyện).
2. Nhấp "Add custom connector".
3. Nhập URL: https://mcp.gotcashback.com
4. Đặt tên (ví dụ: "GotCashback") và lưu.
5. Bật connector trong bất kỳ cuộc trò chuyện nào bạn muốn tra cứu hoàn tiền — Claude sẽ tự động gọi các công cụ khi phù hợp.

Claude Code (terminal)

Thêm máy chủ bằng một lệnh:

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

Chạy /mcp trong Claude Code để kiểm tra kết nối và đăng nhập khi bạn muốn dùng các công cụ tài khoản.

ChatGPT

1. Mở Settings → Connectors (có trên các gói hỗ trợ connector tùy chỉnh/nhà phát triển).
2. Chọn thêm connector tùy chỉnh và nhập URL máy chủ: https://mcp.gotcashback.com
3. Làm theo hướng dẫn để ủy quyền và bật nó để dùng trong trò chuyện hoặc trong cấu hình của một GPT tùy chỉnh.

VS Code (chế độ agent của GitHub Copilot)

Chạy "MCP: Add Server" từ bảng lệnh, hoặc thêm đoạn sau vào .vscode/mcp.json:

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

Các ứng dụng tương thích MCP khác (Cursor, Windsurf, v.v.)

Hầu hết ứng dụng MCP chấp nhận cấu hình JSON trỏ đến máy chủ từ xa. Một mục điển hình trông như sau:

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

Hãy xem tài liệu của ứng dụng cụ thể để biết tệp cấu hình này nằm ở đâu (ví dụ: ~/.cursor/mcp.json cho Cursor) — URL và cấu trúc ở trên giống nhau trên hầu hết ứng dụng vì chúng tuân theo cùng đặc tả MCP.

Ví dụ câu hỏi sau khi kết nối

• "Tỷ lệ hoàn tiền tốt nhất cho Best Buy hiện nay là bao nhiêu?"
• "Có thẻ quà tặng Target nào đang giảm giá không?"
• "Tỷ lệ hoàn tiền tốt nhất cho Walmart tại Canada là bao nhiêu?"
• "So sánh mức giảm giá thẻ quà tặng cho Home Depot."
• "Những cổng hoàn tiền nào có tại Vương quốc Anh?"
• "Tôi có thể mua sản phẩm Adidas ở đâu với hoàn tiền tốt nhất?"
• "Tôi có thể mua thức ăn cho chó ở đâu với mức giảm giá lớn nhất?"
• "Những cổng hoàn tiền nào ở Vương quốc Anh thanh toán qua PayPal, và cổng nào có mức rút tối thiểu thấp nhất?"
• "TopCashback có thưởng đăng ký không, và bao lâu thanh toán một lần?"
• "Báo cho tôi khi tỷ lệ hoàn tiền của Nike đạt 10%."
• "Thêm Best Buy vào các cửa hàng yêu thích của tôi."

Hai câu cuối dùng các công cụ tài khoản tùy chọn và sẽ yêu cầu bạn đăng nhập bằng tài khoản GotCashback.

Muốn trò chuyện trên Telegram thay vào đó? Thử bot Telegram GotCashback

Máy chủ MCP GotCashback làm được gì

Sau khi kết nối, trợ lý AI có thể so sánh tỷ lệ hoàn tiền trực tuyến và tại cửa hàng hiện tại trên các cổng cho một cửa hàng nhất định, tìm thẻ quà tặng giảm giá, xếp hạng các cửa hàng bán một thương hiệu hoặc ngành hàng mua sắm theo ưu đãi tốt nhất, duyệt cửa hàng theo quốc gia và tra cứu điều khoản thanh toán của từng cổng (thưởng đăng ký, mức rút tối thiểu, tần suất thanh toán, phương thức thanh toán). Máy chủ cho trợ lý biết công cụ nào trả lời loại câu hỏi nào, nên một câu hỏi đơn giản như "hoàn tiền tốt nhất cho Walmart" sẽ đi thẳng đến tra cứu phù hợp. Tỷ lệ được làm mới nhiều lần mỗi ngày.

Trợ lý chọn công cụ như thế nào

Máy chủ cho các trợ lý đã kết nối biết công cụ nào trả lời câu hỏi nào, nên bạn có thể hỏi tự nhiên:

• Hoàn tiền cho một cửa hàng cụ thể ("hoàn tiền tốt nhất cho Walmart", "hoàn tiền tại cửa hàng Best Buy", "so sánh các cổng hoàn tiền Expedia") → get_cashback_rates_by_store_name
• Thẻ quà tặng giảm giá cho một cửa hàng cụ thể ("giảm giá thẻ quà tặng Gap tốt nhất") → get_gift_cards_by_store_name
• Mua sản phẩm của một thương hiệu ở đâu để tiết kiệm nhất ("hoàn tiền tốt nhất cho sản phẩm Adidas") → get_best_deals_by_brand
• Mua một loại sản phẩm ở đâu để tiết kiệm nhất ("thức ăn cho chó rẻ nhất có hoàn tiền") → get_best_deals_by_category
• Thưởng đăng ký, mức rút tối thiểu, lịch thanh toán hoặc phương thức thanh toán của một cổng → get_portals_by_name / get_portals
• Những cửa hàng nào có hoàn tiền tại một quốc gia → get_stores_by_country

Hãy nhắc đến quốc gia khi cần ("tại Canada", "hoàn tiền ở Anh"): trợ lý sẽ truyền mã quốc gia viết thường như us, ca, gb (Vương quốc Anh) hoặc de, và tìm trên mọi quốc gia được hỗ trợ khi bạn không nhắc đến.

Trợ lý đi thẳng đến các công cụ này — không bao giờ cần liệt kê quốc gia, cửa hàng hay cổng trước.

Các công cụ có sẵn

country_code là mã ISO viết thường như us, ca, gb (Vương quốc Anh) hoặc de; nó là tùy chọn trừ khi được ghi là bắt buộc. store_id, portal_id và các ID tương tự lấy từ kết quả trước đó.

Liên kết theo dõi trong kết quả

Mỗi cửa hàng, tỷ lệ hoàn tiền, thẻ quà tặng và thưởng đăng ký cổng trong kết quả đều kèm liên kết theo dõi của GotCashback (url, cùng gift_cards_url khi phù hợp). Hoàn tiền chỉ được ghi nhận, giảm giá thẻ quà tặng chỉ áp dụng và thưởng đăng ký chỉ được cấp khi bạn nhấp qua các liên kết đó. Máy chủ hướng dẫn các ứng dụng AI luôn hiển thị chúng — nếu trợ lý trích dẫn tỷ lệ mà không có liên kết, hãy yêu cầu nó cung cấp liên kết.

Công cụ tài khoản (đăng nhập tùy chọn)

Đăng nhập bằng tài khoản GotCashback của bạn (OAuth 2.1 — ứng dụng AI của bạn sẽ tự động đề xuất) sẽ mở khóa thêm các công cụ theo từng người dùng. Tất cả công cụ so sánh ở trên vẫn hoạt động mà không cần đăng nhập.

Cảnh báo chính là những cảnh báo bạn quản lý trong Tài khoản → Cảnh báo trên trang web: alert_type là cashback hoặc gift_card, threshold_percent nằm trong khoảng 1 đến 100, lưu lại một cảnh báo đã có sẽ cập nhật ngưỡng và kích hoạt lại nó, và mỗi tài khoản có tối đa 10 cảnh báo đang hoạt động.

Đăng nhập hoạt động như thế nào

1. Lần đầu bạn dùng một công cụ tài khoản, máy chủ sẽ trả về yêu cầu ủy quyền và ứng dụng AI của bạn mở trang đăng nhập GotCashback trong trình duyệt — cùng cách đăng nhập mạng xã hội như trên trang web. Không cần đăng ký hay khóa API.
2. Chấp thuận các quyền được yêu cầu (scope) và quay lại ứng dụng của bạn. Lệnh gọi công cụ hoàn tất và kết nối vẫn duy trì đăng nhập — các ứng dụng yêu cầu offline_access sẽ nhận refresh token, nên bạn sẽ không bị hỏi lại.
3. Để ngắt kết nối, hãy xóa connector khỏi ứng dụng AI của bạn. Nếu sau này một công cụ báo thiếu scope, hãy xóa rồi thêm lại connector để ứng dụng yêu cầu ủy quyền lại từ đầu.

Điểm cuối máy chủ

https://mcp.gotcashback.com

Đây là máy chủ MCP từ xa (giao thức truyền tải Streamable HTTP). Bạn không cần cài đặt hay lưu trữ gì — chỉ cần trỏ một trợ lý AI tương thích đến URL ở trên.

Dành cho nhà phát triển và tác nhân AI

Máy chủ (phiên bản 1.1.0) chỉ cung cấp các công cụ (không có resource hay prompt). Mỗi công cụ có tiêu đề, mô tả cho biết khi nào nên dùng, chú thích chỉ đọc và — với các công cụ so sánh — lược đồ đầu ra được công bố. Các điểm cuối này cho phép tác nhân hoặc tích hợp khám phá và kết nối mà không cần đọc trang này:

Các công cụ so sánh trả về JSON thô của API dưới dạng văn bản cùng nội dung có cấu trúc kiểu khớp với lược đồ đầu ra của chúng, nên các tích hợp có thể đọc các trường cửa hàng, cổng, tỷ lệ, "tối đa" và trực tuyến/tại cửa hàng mà không cần đoán. ID không xác định và sự cố API được trả về dưới dạng lỗi công cụ thay vì lỗi giao thức.

• https://mcp.gotcashback.com — Điểm cuối MCP — Streamable HTTP, JSON-RPC qua POST, không trạng thái (không cần ràng buộc phiên)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — Thẻ máy chủ MCP mô tả máy chủ, giao thức truyền tải và xác thực (cũng được phục vụ trên trang web này)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — Siêu dữ liệu tài nguyên được bảo vệ OAuth: các scope được hỗ trợ và máy chủ ủy quyền
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Siêu dữ liệu máy chủ ủy quyền — luồng authorization code với PKCE, đăng ký ứng dụng động (ứng dụng công khai và bảo mật), refresh token
• https://www.gotcashback.com/auth.md — Chính sách xác thực tác nhân
• https://www.gotcashback.com/llms.txt — Danh mục trang web dành cho tác nhân AI
• https://api.gotcashback.com/swagger/ — REST API miễn phí đằng sau các công cụ (đặc tả OpenAPI, không cần khóa)
• https://mcp.gotcashback.com/health — Kiểm tra tình trạng

CORS mở cho mọi nguồn gốc, nên các tác nhân chạy trên trình duyệt có thể kết nối trực tiếp; các header phản hồi Mcp-Session-Id và WWW-Authenticate được công khai.

Câu hỏi hoặc sự cố?

Nếu kết nối thất bại hoặc lệnh gọi công cụ báo lỗi, hãy kiểm tra kỹ URL được nhập chính xác là https://mcp.gotcashback.com và không có đường dẫn phía sau. Nếu một công cụ tài khoản liên tục yêu cầu đăng nhập, hãy xóa rồi thêm lại connector. Để được hỗ trợ thêm, hãy liên hệ bộ phận hỗ trợ GotCashback.