AI 工作協作 / 8 分鐘閱讀

用 MCP 連接 Claude、ChatGPT 與 Cursor 管理預約:權限、流程與安全設定

逐步拆解如何透過 OAuth 2.1 MCP 將 Claude、ChatGPT 或 Cursor 安全接駁至預約日曆,比較唯讀查詢、預約寫入權限上限與 CRM Approval Guard 審批機制。

工作室前台電腦連接即時預約日曆與 AI 助理流程

重點摘要: 透過 MCP(Model Context Protocol)預約伺服器,美容院、物理治療診所、健身教練、導師工作室與預約場地可以讓 Claude、ChatGPT 或 Cursor 經 OAuth 2.1 授權直接查詢真實空檔、每日預約名單及執行改期,毋須匯出 Excel 逐日貼上對話框,亦不必將系統最高管理金鑰交給外部應用。

對香港服務業團隊來說,真正省時間的用法好直接:早上開舖前在 Claude 問一句 「列出現有香港時間未來七日嘅瑜伽同單對單訓練預約」,又或者客人在 WhatsApp 要求轉時段時叫助理先查 「陳姑娘星期五下晝兩點半之後有冇 60 分鐘空檔」。不過,將 AI 連上生產環境日曆之前,必須分清**唯讀查詢、預約直接寫入、同 CRM 人工審批(Approval Guard)**三層權限界線。本文一次講清楚 AI 預約 MCP 架構與權限上限、實際工具調用順序、以及如何在兩分鐘內接好 Claude 或 Cursor。

點解單靠 iCal 日曆連結或通用 API Key 唔夠安全?

不少工作室在接駁 AI 助理之前,常試過兩種權宜之計,但只要每日開始多單預約就會出事:

  • 公開 iCal / Google Calendar 只睇到忙碌方塊,睇唔到業務規則。 靜態日曆只顯示某段時間被佔用,並不包含服務時長、轉場緩衝、房間或導師配對條件、以及客人是否已繳訂金。叫 AI 睇純忙碌時間搵空檔,好容易建議出撞房或唔夠鐘的時段。
  • 萬能 API Key 權限過大,出事半徑難以控制。 將包含發票、客戶整表匯出、群發推廣與職員設定的通用金鑰貼入本地桌面工具,一旦提示詞出錯或設備遺失,風險範圍遠超預約日曆本身。
  • 螢幕點擊機械人脆性高。 依賴網頁畫面點擊的自動化腳本無法進行交易級空檔校驗,只要日曆檢視或時區切換改版便隨時斷線。

使用建基於 OAuth 2.1 Scoped MCP 的專用預約端點後,AI 客戶端會先經標準瀏覽器 OAuth 2.1 + PKCE(S256)取得工作區權杖,再透過 tools/list 動態讀取目前帳戶真正獲准使用的工具清單。

三個 MCP 端點,三道清晰信任邊界

唔同工作崗位需要唔同權限。個人教練用於早晨查看課表的助理,唔應該同後勤 CRM 優惠批核或 WhatsApp 群發混為一談。FavCRM 在 https://api.favcrm.io 將端點按權限資源明確拆開:

端點網址 (Resource URL) 包含權限範圍 適用方案 執行模式與安全邊界
https://api.favcrm.io/mcp/oauth/view bookings:read、contacts:read Starter(US$0)、Simply Booking(HK$180/月)、FavCRM Pro(HK$580/月) 嚴格唯讀。 只暴露預約、可用時段、服務、職員與現有客戶查詢工具;此端點上完全不存在寫入工具。
https://api.favcrm.io/mcp/oauth/manage bookings:read、contacts:read,加配 bookings:write 上限 Simply Booking(HK$180/月)、FavCRM Pro(HK$580/月) 預約專區上限。 工作區擁有者或管理員可在 OAuth 同意畫面取消勾選寫入,降級為唯讀;保留寫入時指令會即時落實而無伺服器審批隊列,且永遠觸及唔到 WhatsApp 發訊或推廣活動。
https://api.favcrm.io/mcp/oauth/crm(或範圍化 /mcp) 聯絡人、交易階段、任務、WhatsApp 草擬及 190+ 模組工具 FavCRM Pro(HK$580/月) 完整工作區 CRM。 對外發送 WhatsApp、折扣、退款與敏感 CRM 欄位更新受可設定 Approval Guard 人工審批保護。

在授權 /mcp/oauth/manage 之前,有兩項治理細節一定要留意:

  1. 網址係「權限上限」,唔係強制全開。 OAuth 2.1 授權畫面只會列出該登入用戶作為有效擁有人或管理員的工作區(單憑平台管理員身份並不能代管租戶工作區)。批准之前,你可以直接在同意畫面剔除 bookings:write(寫入預約),令 /manage 連接實際只餘唯讀能力。
  2. 預約寫入屬於即時操作,並無獨立伺服器審批隊列。 只要最終權杖帶有 bookings:write(涵蓋 create_booking、confirm_booking、reschedule_booking、complete_booking、mark_no_show、cancel_booking),呼叫工具便會直接寫入日曆並套用正常時段、分店與退款規則——特別留意 使用 cancel_booking 取消已付款預約有可能即時觸發退款。

亦因此,FavCRM 明確區分 Booking MCP(Booking Lite 輕量專區,由 Agent 守則負責寫入前先向人確認)與 FavCRM Pro 的 CRM + Approval Guard(涉及官方 WhatsApp 外發訊息、特別折扣、退款決策與敏感客戶資料修改時,伺服器會先行攔截進入人手審批隊列)。

真實前台流程拆解:由查空檔到安全改期

一套可靠的 MCP 預約整合,重點在於先讀取、後核對、最後先執行變更。Booking 專區提供 6 個讀取工具與 6 個寫入工具:

  • 讀取工具(/view 與 /manage): list_services、list_staff、get_available_slots、search_members、list_bookings、get_booking_detail。
  • 寫入工具(僅限批准 bookings:write 後的 /manage): create_booking、confirm_booking、reschedule_booking、complete_booking、mark_no_show、cancel_booking。

在香港美容、診所及教練團隊的日常運作入面,三個技術細節決定了 AI 助理會唔會「幫倒忙」:

1. 留意 list_bookings 預設 20 筆上限與香港時區

list_bookings 接受包含首尾日期的 dateFrom 與 dateTo 參數,但每次預設回傳最多 20 筆紀錄(連同 items 與 total 總數,且沒有 page 分頁參數)。設計良好的 AI 助理會比較 items.length 與 total:如果旺季一星期總共有 48 筆預約,助理必須自動收窄 dateFrom/dateTo 逐日或分段查齊,而唔好睇漏週末後半段日程;同時所有時間篩選必須以工作區設定的本地時區(例如 Asia/Hong_Kong)為準,而非主機電腦的 UTC 時鐘。

2. 建立新預約前,先查現有客戶、服務與員工

助理幫熟客改時間或開新單前,應該先用 search_members 確認現有客戶檔案(避免產生重複電話紀錄),再以 list_services 與 list_staff 核對服務時長與合資格人手,最後呼叫 get_available_slots 取得已計算緩衝時間的可約時段。

3. 配合公開 SKILL.md 合約規範 Agent 行為

既然 /mcp/oauth/manage 保留寫入時會直接生效,FavCRM 亦公開了機器可讀的操作守則 https://favcrm.io/.well-known/agent-skills/favcrm-booking/SKILL.md(索引見 /.well-known/agent-skills/index.json)。支援 Agent Skills 的 AI 工具讀入該規範後,會嚴格遵守幾條安全紀律:絕不在對話中要求用戶貼上密碼或金鑰、呼叫任何寫入工具前先於對話中複述「客人姓名、服務項目、負責同事與本地日期時間」讓商戶點頭確認,並且必須先執行一次驗證讀取確認成功,先至向商戶匯報已連線。

兩分鐘設定:Claude 自訂連接器與 Cursor 設定

目前支援遠端 OAuth 2.1 + PKCE 的 MCP 客戶端都可以透過授權中繼資料自動探索路徑(/.well-known/oauth-authorization-server/oauth/mcp)即時連接。(註:各大 AI 平台嘅公開精選市集目錄上架仍需配合相關平台審核排程;自訂 MCP 連接器與本地開發工具今日已經可以直接使用。)

方法 A:Claude 自訂連接器(Custom Connector)

  1. 初次測試建議由唯讀開始:先用 https://api.favcrm.io/mcp/oauth/view 試查日程,熟習流程後再切換至 https://api.favcrm.io/mcp/oauth/manage。
  2. 打開 Claude 進入 Customize → Connectors → Add custom connector(如屬 Team 或 Enterprise 帳戶,可能需先由機構管理員開啟自訂連接器權限)。
  3. 輸入容易辨識的名稱(例如 FavCRM Booking),並貼上你選定的 FavCRM MCP OAuth 網址。
  4. 按連接並以工作區擁有人或管理員身分登入 FavCRM,挑選目標公司工作區;核對請求權限(想先唯讀測試可取消勾選 bookings:write)後按批准。

方法 B:Cursor(.cursor/mcp.json)

在 Cursor 專案的 .cursor/mcp.json 或全域 ~/.cursor/mcp.json 中,將以下項目合併進現有的 mcpServers 物件內(切勿覆蓋原有其他工具設定):

{
  "mcpServers": {
    "favcrm-booking": {
      "url": "https://api.favcrm.io/mcp/oauth/manage"
    }
  }
}

之後在 Cursor 的 MCP 設定介面啟動登入驗證,於瀏覽器完成 OAuth 2.1 + PKCE 授權即可。切勿將存取權杖、授權碼或 Booking Lite 進階設定中的連接金鑰(Connection key)寫入 Git 紀錄或貼上聊天視窗。

首次連線驗證提示與一按即時撤銷

完成授權後,建議立即在對話框貼入以下唯讀驗證提示:

「請以工作區本地時區列出未來 7 日的已確認預約,顯示回傳筆數同 total 總數,切勿新增或修改任何預約。」

如果你見到助理正確列出未來一週預約、同時在工具列表內完全看不到 WhatsApp 群發或公司財務工具,即代表預約沙盒權限邊界已經生效。

日後如有同事離職、更換電腦或想即時收回寫入授權:

  • 於 FavCRM 商戶後台打開 設定 → 已連接應用(Booking Lite 工作區亦可於 設定 → AI 助理 → 進階設定 → 已登入的 AI 應用程式),一按撤銷即會於下一個 MCP 請求即時生效。
  • 如果你在重新授權同一應用時剔除部分權限,系統亦會自動令舊有較高權限的權杖失效,強制原有會話重新登入核實。

需要 ChatGPT 開發者模式、獨立 MCP SDK 客戶端或作用域金鑰細節?可進一步查閱 Claude、ChatGPT 與 Cursor 連接 FavCRM MCP 指南 或 Simply Booking MCP 技術規格文檔。

香港服務業工作室如何選擇起步方案?

因為 FavCRM 由 Starter 到 Pro 全部建基於同一份客戶紀錄架構,團隊隨時可以原地加裝模組,完全毋須經歷「轉會匯出再匯入」的陣痛:

  • Starter 核心版(US$0 免費版,見英文官網方案): 適合希望先將散落聯絡人與跟進待辦集中,再用 /mcp/oauth/view 做每日唯讀匯報的個人工作者。
  • Simply Booking 輕量預約版(HK$180/月 或年繳 HK$1,800/年,首個曆月免費試用、註冊毋須信用卡): 專為個人工作室與 3 人以下小團隊設計,包含品牌專屬預約頁(客人免開戶直接揀時間)、最多 3 個員工帳戶及 10 項服務、現金/FPS/PayMe 到場收款記錄(亦可另選連接 Stripe 線上收款,FavCRM 0% 平台抽佣),並隨附 /mcp/oauth/view 與 /mcp/oauth/manage 預約 MCP 連接能力。
  • FavCRM Pro 專業成長版(HK$580/月 或年繳 HK$5,800/年,最多 5 人): 當預約需要連通 會員儲值與預付套票自動扣堂、FPS 及 Stripe 網上鎖位訂金、官方 WhatsApp Business API 團隊共用收件箱,以及透過 /mcp/oauth/crm 配合伺服器級 Approval Guard 把關對外訊息與敏感操作時,FavCRM Pro 就能一次接手全流程。

想先檢查 AI 預約系統由時段緩衝、例外處理到審批日誌嘅採購準則?推薦閱讀 AI 預約系統是甚麼?香港服務業選購指南、了解會議如何自動整理跟進的 AI 會議記錄:由逐字稿到客戶跟進,或直接對比各級 FavCRM 香港收費方案。

常見問題

MCP 預約伺服器實際上幫服務業團隊做到啲乜? MCP(Model Context Protocol)為 Claude、ChatGPT 或 Cursor 等 AI 助理提供具明確權限邊界的標準化工具,可以直接讀取真實可預約時段、每日日程、現有客戶紀錄及執行預約改期,而唔使將完整管理員金鑰貼入對話或用瀏覽器機械人硬㩒介面。

/mcp/oauth/view、/mcp/oauth/manage 同 /mcp/oauth/crm 三個端點有咩分別? /mcp/oauth/view 嚴格唯讀(bookings:read、contacts:read),只可查日程、空檔及客戶資料;/mcp/oauth/manage 係預約專區上限(加配 bookings:write 寫入權限),擁有者可在 OAuth 同意畫面取消勾選寫入,令授權變回唯讀;/mcp/oauth/crm 則屬 FavCRM Pro 全工作區 CRM 與官方 WhatsApp 端點,配備可設定嘅 Approval Guard 審批隊列。

經 /mcp/oauth/manage 改動或取消預約,伺服器會唔會先停低等審批? 唔會。只要你在同意畫面保留 bookings:write 權限,create_booking、reschedule_booking 或 cancel_booking 等寫入指令會即時改動真實預約(取消已付款預約亦可能觸發退款)。事前向團隊確認服務、治療師/教練同時間屬於 Agent 流程守則(載於 favcrm-booking SKILL.md),而非伺服器審批隊列。

如果職員離職或者轉用另一部電腦,點樣即時取消 AI 助理嘅預約日曆權限? 登入商戶後台「設定 → 已連接應用」(Booking Lite 工作區亦可於「設定 → AI 助理 → 進階設定 → 已登入的 AI 應用程式」)一按撤銷授權,下一個 MCP 請求即刻失效;如重新授權時剔除寫入權限,舊有較高權限權杖亦會自動作廢。

NEXT / 延伸閱讀