MCP 伺服器

可從 Claude 等支援 MCP（Model Context Protocol）的用戶端操作 ReceiptRoller 的營收、商品、訂單、庫存、預約與社群媒體。工具會以連線使用者的身分、在其核准的範圍內呼叫 API。

連線資訊

端點
https://mcp.receiptroller.io/mcp
傳輸方式
HTTP POST（JSON-RPC 2.0），協定版本 2025-03-26
驗證
OAuth 2.0 授權碼流程（PKCE S256）。支援動態用戶端註冊（RFC 7591），不需事先發行用戶端 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 取得包含輸入結構的最新清單。

帳戶

列出商業帳戶與店舖，查詢其他工具所需的 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 代理整合頁面