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

ไคลเอนต์ที่รองรับ MCP (Model Context Protocol) เช่น Claude สามารถใช้งานยอดขาย สินค้า คำสั่งซื้อ สต็อก การจอง และโซเชียลมีเดียของ ReceiptRoller ได้ เครื่องมือจะเรียก API ในนามของผู้ใช้ที่เชื่อมต่อ ภายในสโคปที่ผู้ใช้อนุมัติ

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

เอนด์พอยต์
https://mcp.receiptroller.io/mcp
รูปแบบการสื่อสาร
HTTP POST (JSON-RPC 2.0) โปรโตคอลเวอร์ชัน 2025-03-26
การยืนยันตัวตน
OAuth 2.0 แบบ authorization code พร้อม PKCE (S256) รองรับการลงทะเบียนไคลเอนต์แบบไดนามิก (RFC 7591) จึงไม่ต้องออก client ID ล่วงหน้า
เมทาดาทา
https://mcp.receiptroller.io/.well-known/oauth-protected-resource
https://mcp.receiptroller.io/.well-known/oauth-authorization-server

สโคป

สโคปที่ไคลเอนต์ขอได้ เครื่องมือเรียก API ด้วยโทเค็นของผู้ใช้ การดำเนินการที่ต้องใช้สโคปที่ไม่ได้รับอนุมัติจะได้ 403

sns.content.read sns.content.write sns.audience.read analytics.read sales.read store.products.read store.products.write store.orders.read store.orders.write store.inventory.read store.inventory.write store.reservations.read store.memberships.read store.passes.read

เครื่องมือ

tools/list จะคืนรายการล่าสุดพร้อม input schema

บัญชี

แสดงบัญชีธุรกิจและร้านค้า เพื่อหา organizationId และ storeId ที่เครื่องมืออื่นใช้

  • list_my_organizations
  • list_my_stores

วิเคราะห์ยอดขาย

KPI แนวโน้ม การพยากรณ์ สินค้าขายดี การวิเคราะห์ผู้มาเยือน ความเสี่ยงการเลิกใช้ การเปรียบเทียบร้าน และคำแนะนำ

  • sales_get_kpis
  • sales_get_trend
  • sales_get_forecast
  • sales_get_top_products
  • sales_get_visitor_analysis
  • sales_get_churn_risk
  • sales_get_customer_recommendations
  • sales_compare_stores
  • sales_get_advice

โซเชียลมีเดีย

สร้าง ตั้งเวลา และเผยแพร่โพสต์บนบัญชีที่เชื่อมต่อ รวมถึงการวิเคราะห์และความคิดเห็น

  • sns_list_accounts
  • sns_get_account
  • sns_list_recent_posts
  • sns_get_post
  • sns_create_post
  • sns_update_post
  • sns_attach_media_from_url
  • sns_schedule_post
  • sns_publish_post
  • sns_delete_post
  • sns_get_analytics
  • sns_list_comments

สินค้า

แสดง อ่าน สร้าง และอัปเดตสินค้า

  • pim_list_products
  • pim_get_product
  • pim_create_product
  • pim_update_product

คำสั่งซื้อ

แสดงและอ่านคำสั่งซื้อ เปลี่ยนสถานะ และจัดส่ง

  • oms_list_orders
  • oms_get_order
  • oms_transition_order
  • oms_ship_order

สต็อก

ตำแหน่งจัดเก็บ ระดับสต็อก ประวัติการเคลื่อนไหว และการปรับสต็อก

  • wms_list_locations
  • wms_get_stock
  • wms_list_movements
  • wms_adjust_stock

การจองและสมาชิก

การจอง ช่วงเวลา สถิติ สมาชิก และผู้ถือบัตรแบบนับครั้ง อ่านอย่างเดียว

  • reservation_list
  • reservation_list_slots
  • reservation_get_stats
  • reservation_get_analytics
  • membership_list_members
  • pass_list_holders

สำหรับเจ้าของร้าน ภาพรวมและขั้นตอนการเชื่อมต่ออยู่ที่ หน้าการเชื่อมต่อ AI เอเจนต์