นักพัฒนา

เริ่มพัฒนาด้วย SanDeals

เชื่อมต่อเอเจนต์ AI หรือแอปของคุณกับแคตตาล็อกดีลของ SanDeals หน้านี้อธิบายการตั้งค่าผ่าน MCP, REST API และ ChatGPT Actions ตามด้วยข้อมูลอ้างอิงฉบับเต็ม

claude mcp add --transport http sandeals https://www.sandeals.net/mcp

URL เซิร์ฟเวอร์

https://www.sandeals.net/mcp

Streamable HTTP
Auth: None
อ่านอย่างเดียว

ใช้ได้กับClaude Code ChatGPT Cursor

การเชื่อมต่อ

เลือกวิธีเชื่อมต่อ

เลือกอินเทอร์เฟซที่เหมาะกับไคลเอนต์ของคุณ ทั้งสามแบบอ่านจากแคตตาล็อกเดียวกัน

MCP

สำหรับผู้ช่วย AI และเอเจนต์ เชื่อมต่อครั้งเดียว โมเดลของคุณจะเรียก search_deals และ list_deals เป็นเครื่องมือ

เริ่มต้นอย่างรวดเร็ว
ข้อมูลอ้างอิง
เซิร์ฟเวอร์ MCP

REST API

สำหรับแอป สคริปต์ และแบ็กเอนด์ ส่งคำขอ HTTP หนึ่งครั้งแล้วรับ JSON แบบมีโครงสร้าง

ChatGPT Actions

สำหรับ GPT แบบกำหนดเอง นำเข้าสเปก OpenAPI แล้วเรียกการดำเนินการ searchDeals

การตั้งค่า
สเปก OpenAPI

เริ่มต้นใช้งาน

เริ่มต้นอย่างรวดเร็ว

คู่มือนี้จะเชื่อมต่อ SanDeals กับ Claude Code และรันการค้นหาครั้งแรกของคุณ ขั้นตอนสำหรับ ChatGPT, Cursor และไคลเอนต์อื่นอยู่ถัดไป

สิ่งที่ต้องมี

ไคลเอนต์ MCP เช่น Claude Code, ChatGPT หรือ Cursor
หรือไคลเอนต์ HTTP ใดก็ได้ เช่น curl สำหรับ REST API
ไม่ต้องมีบัญชีหรือคีย์ API: เซิร์ฟเวอร์เป็นสาธารณะและอ่านอย่างเดียว

Claude Code

เพิ่มเซิร์ฟเวอร์
รันคำสั่งนี้ในเทอร์มินัลของคุณ คำสั่งจะลงทะเบียน SanDeals เป็นเซิร์ฟเวอร์ Streamable HTTP ชื่อ sandeals
Terminal
```
claude mcp add --transport http sandeals https://www.sandeals.net/mcp
```
ตรวจสอบการเชื่อมต่อ
แสดงรายการเซิร์ฟเวอร์ของคุณ หากเชื่อมต่อสำเร็จจะเห็น ✓ Connected ข้าง sandeals หากเห็น Failed to connect ให้ตรวจสอบเครือข่ายแล้วรันคำสั่งเพิ่มเซิร์ฟเวอร์อีกครั้ง ภายในเซสชัน Claude คำสั่ง /mcp จะแสดงสถานะเดียวกัน
Terminal
```
claude mcp list
```
ผลลัพธ์
```
Checking MCP server health...

sandeals: https://www.sandeals.net/mcp (HTTP) - ✓ Connected
```

ค้นหาดีล

ถามด้วยภาษาธรรมดา Claude จะเรียก search_deals และตอบกลับด้วยชื่อและลิงก์จากแคตตาล็อก

Claude Code

ใช้ SanDeals ค้นหาดีลกาแฟ แล้วส่งชื่อและลิงก์ของแต่ละดีลกลับมา

ผลลัพธ์

นี่คือดีลกาแฟจาก SanDeals:

1. กาแฟคั่วบด 500 กรัม — https://slink.sandeals.net/AbC123
2. กาแฟสำเร็จรูป 3in1 20 ซอง — https://slink.sandeals.net/XyZ789

โปรดตรวจสอบเงื่อนไขบนเว็บไซต์ของร้านค้าก่อนซื้อ

หากต้องการแชร์เซิร์ฟเวอร์กับทีม ให้เพิ่ม --scope project แล้ว Claude Code จะบันทึกไว้ใน .mcp.json ของรีโพซิทอรี

claude mcp add --scope project --transport http sandeals https://www.sandeals.net/mcp

ChatGPT

ใน ChatGPT Connectors ให้เพิ่ม custom MCP server
วาง URL เซิร์ฟเวอร์แล้วเลือก No authentication
URL เซิร์ฟเวอร์
```
https://www.sandeals.net/mcp
```
ติดตั้งเซิร์ฟเวอร์ จากนั้นในแชทใหม่ พิมพ์ @ แล้วเลือก SanDeals

การใช้งานขึ้นอยู่กับสิทธิ์ของเวิร์กสเปซของคุณ ส่วน ChatGPT Actions ด้านล่างเป็นการเชื่อมต่อ REST แยกต่างหาก

Cursor และไคลเอนต์อื่น

ไคลเอนต์ใดก็ตามที่รองรับ MCP ระยะไกลผ่าน Streamable HTTP สามารถเชื่อมต่อด้วย URL เซิร์ฟเวอร์ได้ ใน Cursor ให้เพิ่มลงใน mcp.json:

~/.cursor/mcp.json

{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}

ChatGPT Actions

ใน ChatGPT ให้สร้าง GPT แบบกำหนดเอง เปิด Actions แล้วเลือก Import from URL วาง URL ด้านล่าง ตั้งค่า Authentication เป็น None แล้ว GPT จะเรียกการดำเนินการ searchDeals

OpenAPI

https://www.sandeals.net/openapi.json

พรอมต์สำหรับเอเจนต์

ชี้เอเจนต์ไปที่ www.sandeals.net/for-agents.md หรือใช้พรอมต์นี้:

พรอมต์สำหรับเอเจนต์

เชื่อมต่อกับ https://www.sandeals.net/mcp เรียก search_deals แล้วส่ง title และลิงก์ของแต่ละดีลจากการตอบกลับกลับมา

ข้อมูลอ้างอิง

เซิร์ฟเวอร์ MCP

เซิร์ฟเวอร์ MCP ใช้ Streamable HTTP และไม่เก็บสถานะเซสชันระหว่างคำขอ URL ของเซิร์ฟเวอร์คือ www.sandeals.net/mcp.

Endpoint	POST `/mcp`
Alias	POST `/api/mcp`
Auth	None
Transport	Streamable HTTP · JSON-RPC 2.0
Protocol	2025-03-26 · 2025-06-18 · 2025-11-25
Methods	initialize · tools/list · tools/call

เครื่องมือ

search_dealsอ่านอย่างเดียว

ค้นหาดีลตามคำค้น แต่ละผลลัพธ์มีชื่อ ลิงก์ และหมวดหมู่

ฟิลด์	ชนิด	หมายเหตุ
`query`จำเป็น	string	1–512 chars
`limit`	integer	1–50 · default 10

list_dealsอ่านอย่างเดียว

แสดงรายการในแคตตาล็อก กรองตามหมวดหมู่หรือคำค้นได้

ฟิลด์	ชนิด	หมายเหตุ
`category`	enum	all · food · travel · shopping · tech · books · lifestyle · education
`search`	string	≤ 512 chars
`limit`	integer	1–100 · default 20

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_deals",
    "arguments": {
      "query": "coffee",
      "limit": 5
    }
  }
}

REST API

REST API ใช้การค้นหาแบบเดียวกับเครื่องมือ MCP search_deals ส่งคำค้นผ่าน q ส่วน limit เป็นตัวเลือก ค่าเริ่มต้น 10 และสูงสุด 50 สำหรับคำขอ POST ให้ส่ง mode: "agent" เพื่อรับ JSON แบบมีโครงสร้าง

GETPOST/api/search-advanced

curl "https://www.sandeals.net/api/search-advanced?q=coffee&limit=5"

แคตตาล็อก: GET /api/deals แสดงรายการในแคตตาล็อก กรองได้ด้วย category, search (หรือชื่อแทน q) และ limit
HTML สำรอง: GET /search?q=coffee ส่งคืนหน้าผลลัพธ์ HTML ที่ใช้งานได้โดยไม่ต้องมี JavaScript ใช้เฉพาะเมื่อไคลเอนต์ของคุณอ่าน JSON ไม่ได้

การตอบกลับ

แต่ละผลลัพธ์มี title และ href

response.json

{
  "ok": true,
  "query": "coffee",
  "total": 1,
  "results": [
    {
      "title": "Example Cafe",
      "href": "https://slink.sandeals.net/example",
      "category": "food",
      "summary": "Example cafe — coffee and tea.",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deal for \"coffee\": 1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "matched": true
  }
}

ฟิลด์	ชนิด	หมายเหตุ
`results[].title`	string	ชื่อร้านค้าหรือดีล
`results[].href`	string	URL ของดีล
`results[].category`	string	food (อาหาร), travel (ท่องเที่ยว), shopping (ช้อปปิ้ง), tech (เทคโนโลยี), books (หนังสือ), lifestyle (ไลฟ์สไตล์)
`meta.matched`	boolean	false หมายถึงคำแนะนำสำรอง

พาธ	รูปแบบ
/llms.txt	Markdown
/for-agents.md	Markdown
/api/llms	JSON
/.well-known/ai.txt	Text
/openapi.json	OpenAPI 3
GET /mcp	JSON

ขั้นตอนถัดไป

คุณเชื่อมต่อ SanDeals แล้ว ต่อไป ดูข้อมูลอ้างอิงฉบับเต็มและวิธีเชื่อมต่อแบบอื่น

ข้อมูลอ้างอิง APIเอนด์พอยต์ พารามิเตอร์ และสคีมาการตอบกลับทั้งหมด เซิร์ฟเวอร์ MCPรายละเอียดเซิร์ฟเวอร์ เครื่องมือ และขั้นตอนเชื่อมต่อในหน้าเดียว สเปก OpenAPIนำเข้าสู่ ChatGPT Actions หรือสร้างไคลเอนต์คู่มือสำหรับเอเจนต์เอกสารในรูปแบบ Markdown สำหรับเอเจนต์เขียนโค้ดและโปรแกรมรวบรวมข้อมูล

เริ่มพัฒนาด้วย SanDeals

เลือกวิธีเชื่อมต่อ

เริ่มต้นอย่างรวดเร็ว

Claude Code

ChatGPT

Cursor และไคลเอนต์อื่น

ChatGPT Actions

พรอมต์สำหรับเอเจนต์

เซิร์ฟเวอร์ MCP

เครื่องมือ

REST API

การตอบกลับ

ข้อจำกัด

ทดลอง

ดัชนี

ขั้นตอนถัดไป