HeysubHeysubPlayground
Dashboard ↗

เชื่อม Heysub กับ AI agent ด้วย MCP

MCP (Model Context Protocol) ให้ AI agent เรียกใช้ Heysub ได้ด้วยภาษาคน — สั่งว่า "สร้างลิงก์เก็บเงิน 199 บาทให้ลูกค้าคนนี้" แล้ว agent เรียก tool ให้เอง

Tools ที่ได้
create_customer
สร้างลูกค้า
create_checkout
ลิงก์จ่ายครั้งเดียว
create_subscription_checkout
subscription รายเดือน/ปี
get_balance
ยอดคงเหลือร้าน
list_payments
รายการชำระเงินล่าสุด
get_entitlements
สิทธิ์/เครดิตลูกค้า
verify_licence
ตรวจ licence key
1

ติดตั้ง MCP server (ตัวอย่างในโปรเจกต์)

ห่อ Heysub REST เป็น MCP tools · รันในเครื่อง (stdio) · โค้ดอยู่ที่ examples/mcp-server/

shell
cd examples/mcp-server
npm install
2

เพิ่มเข้า AI client

แก้ /ABS/PATH/examples/mcp-server/server.mjs เป็น path จริงในเครื่อง และใส่ sk_test_ ของคุณ · key อยู่ใน env ของ config เท่านั้น (โมเดลไม่เห็นเป็นข้อความ)

Claude Desktop / Cursor

วางใน claude_desktop_config.json หรือ .cursor/mcp.json

json
{
  "mcpServers": {
    "heysub": {
      "command": "node",
      "args": ["/ABS/PATH/examples/mcp-server/server.mjs"],
      "env": {
        "HEYSUB_API_KEY": "sk_test_xxx",
        "HEYSUB_BASE_URL": "https://bvvdfgjrkprdqnymcbpl.supabase.co/functions/v1/api"
      }
    }
  }
}

Claude Code (CLI)

shell
claude mcp add heysub \
  -e HEYSUB_API_KEY=sk_test_xxx \
  -e HEYSUB_BASE_URL=https://bvvdfgjrkprdqnymcbpl.supabase.co/functions/v1/api \
  -- node /ABS/PATH/examples/mcp-server/server.mjs
3

ลองสั่งงาน

รีสตาร์ท client แล้วพิมพ์คำสั่งภาษาคน เช่น:

"สร้างลิงก์เก็บเงิน 199 บาท ให้ a@b.com หน่อย"
"ยอดเงินในร้านตอนนี้เท่าไหร่"
"ทำ subscription รายเดือน 490 บาท ให้ลูกค้าคนนี้"

หมายเหตุ: Heysub มี MCP endpoint ของตัวเองที่ https://bvvdfgjrkprdqnymcbpl.supabase.co/functions/v1/mcp แต่ยังเป็น scaffold (tools กำลังจะมาใน BLG-28) — ตัวอย่างนี้ห่อ REST API ให้ใช้ได้เลยตอนนี้ · ดูโค้ดเต็ม + วิธีทดสอบที่ examples/mcp-server/README.md