SOP MCP：用你的AI處理預約

讓老闆、教練與櫃台用自己的AI（例如Claude、ChatGPT）查看與處理這家店的預約。

這頁寫給三種人：店家（老闆、教練、櫃台）、幫店家接系統的SI工程師，以及審查連接器的人員。

SOP MCP是什麼

SOP MCP是SOP提供給店家的MCP伺服器。MCP（Model Context Protocol）是讓AI連到外部工具的開放標準。連上之後，老闆、教練或櫃台可以直接請自己的AI查看今天的預約、確認或婉拒等待店家確認的預約，或替來電的客人代客預約。

這是設計給支援遠端MCP連接器的AI使用的，例如Claude與ChatGPT；操作畫面與選單名稱依各家AI與版本而不同。一次登入只開得到一家店，AI能看到與處理的，只有這家店的預約。

這頁說的是店家那一側。客人的AI怎麼找到你的店、預約並付款，見代理商務文件。

怎麼連

MCP網址是https://sellers.carboneasy.ai/mcp。傳輸方式是Streamable HTTP，店家登入用OAuth（支援動態客戶端註冊與PKCE）。

在你的AI裡找到新增「自訂連接器」的地方。各家AI的名稱與位置不同，請依該AI的說明操作。
貼上MCP網址https://sellers.carboneasy.ai/mcp，名稱可以自取，例如「SOP」。
第一次使用時，AI會把你帶到SOP的登入頁。輸入店家代號與店家通行碼，按「登入並授權」。這兩項和SOP確認頁用的相同。
回到AI，就可以請它查看與處理預約，例如：「看一下今天晚上的預約」。

登入頁會顯示要連接的應用程式名稱，以及登入後會回到哪個網站。請確認那是你剛剛操作的AI，再授權；不想授權就按「不授權」。

你可以隨時在AI那邊移除這個連接器，移除後那個AI就不會再呼叫SOP。店家通行碼更換後，這家店所有已登入的AI會立即失效，需要重新連接。

11個工具

下面11個工具，就是店家登入後能用的全部工具。每個工具都只作用在你登入的這家店，不收店家代號。時間一律是台北時間（Asia/Taipei）。最後一欄是「否」，代表只讀取、不改變預約。

工具	做什麼	會改資料嗎
`get_store_settings`	取得這家店的資料與規則：城市、地址、營業時間、聯絡方式、常見問題；上架中的服務、價格、時長、每週時段與付款方式（到店或線上）；預約規則（自動成立與人數上限、取消截止時間、待確認預約保留多久）；也會說明人工確認模式是否開著、開到何時。	否
`get_availability`	查某項服務未來1至14天的空檔與剩餘名額，可指定老師或教練。	否
`list_bookings`	列出某段日期內的預約，依時間由早到晚（從指定日期起算1至14天，預設7天，最多回傳100筆），可依狀態篩選。每筆有狀態、服務、時段、人數、客人姓名、遮蔽後的電話與Email、需要你確認的原因、付款狀態與到場標記。	否
`get_booking`	查一筆預約的完整內容：狀態與需要確認的原因、服務、時段、人數、客人姓名、備註、付款與退款資訊、到場標記。電話與Email同樣是遮蔽後的。	否
`reveal_customer_contact`	取得一筆預約客人的完整電話與Email。每次呼叫都會寫進這家店的稽核紀錄。	否（會留下稽核紀錄）
`confirm_booking`	確認一筆等店家確認的預約。若確認後會超過該時段的名額，或讓老師的時間重複，會失敗；還在等線上付款的預約不能確認。不會傳訊息給客人。	是
`decline_booking`	婉拒一筆等待中的預約（含等線上付款的），並釋出名額。無法復原。客人已線上付款的會立即全額退款，結果會說明退款完成或仍在處理。不會傳訊息給客人。	是
`cancel_booking_by_store`	由店家取消一筆已確認的預約，並釋出名額。無法復原。待確認的預約請改用`decline_booking`。已線上付款的會全額退款。不會傳訊息給客人。	是
`mark_attendance`	時段開始後，標記客人「到場」或「未到」。每筆預約只能標記一次。	是
`book_for_customer`	替客人代客預約，例如客人來電或到櫃台。預約會立即成立、到店付款，即使這項服務在客人自己請AI預約時需要線上付款。仍會檢查名額與老師的時間。客人姓名、電話與選填的Email由店家保存。可帶`idempotency_key`讓重試安全；同一組聯絡資料、服務與時段重複預約會被拒絕。	是
`set_manual_mode`	開啟或關閉人工確認模式。開啟期間，這家店所有新預約（包括客人自己的AI預約的）都改成等你確認，到你指定的日期（台北時間當天23:59，最多90天內）自動結束；也可以隨時關閉。已經成立的預約不受影響。	是（只影響之後的新預約）

成功的寫入動作，以及reveal_customer_contact的每次呼叫，都會在這家店的稽核紀錄留下一筆。稽核紀錄只記是哪一次登入或哪一張憑證、做了什麼、哪一筆預約、何時，不記客人姓名、電話、Email與備註。

隱私與安全

客人的電話與Email預設遮蔽：電話只留最後3碼，Email只留網域。list_bookings、get_booking與book_for_customer的回應都不含完整的電話與Email。
要看完整聯絡資料，只能用reveal_customer_contact，一次一筆預約，每次都記在稽核紀錄；記不下來時就不給。
預約過一段時間後，客人的聯絡資料會由系統清除，之後那些欄位是空的。
工具回傳的內容會經過你使用的AI服務（例如Claude或ChatGPT），適用該服務自己的條款與隱私規定；這也是客人聯絡資料預設遮蔽的原因。
一次登入或一張憑證只開得到一家店。工具不收店家代號，AI沒有辦法指定別家的店。
確認、婉拒、取消與標到場，是你請AI代勞的日常操作。伺服器給AI的使用說明要求它只照你的要求、對你指定的那一筆預約動作，但仍請你留意AI做了什麼：婉拒與取消無法復原，請在請AI執行前先確認是哪一筆。
正式設定（服務、價格、課表、取消規則）：目前沒有任何工具能修改，get_store_settings只能讀取。這類設定的變更若需要核准，核准只能由你在SOP確認頁操作（SOP的LINE通知會帶你連到確認頁），AI不能自己核准。
代客預約的備註欄請不要填健康或醫療資訊。

限流

代客預約：book_for_customer成功的預約，每家店（前台代理則是每張憑證）每小時最多60筆，每家店每天最多200筆。超過會回rate_limited，請一小時後再試。
登入：同一家店、同一個網路位置，15分鐘內輸入錯誤10次會暫時不能登入；同一個網路位置不分店家，15分鐘內累計錯誤50次也一樣。請15分鐘後再試。

給SI與前台系統

幫店家接系統的SI，或店家自己的前台系統（例如LINE上的AI客服、店家主機上的AI），不用走店家登入，改用「前台代理憑證」連到同一個MCP網址。

憑證由SOP核發。一張憑證只對應一家店，每個前台一張，可以撤銷。憑證只在核發時顯示一次，請妥善保存；遺失請聯絡我們撤銷並重發。
連線時在HTTP標頭帶Authorization: Bearer sopk_…，憑證以sopk_開頭。憑證寫錯或已撤銷，一律回401。
前台代理只看得到5個工具：get_store_settings、get_availability、list_bookings、get_booking、book_for_customer。
客人電話與Email同樣遮蔽，而且前台代理沒有reveal_customer_contact，看不到完整聯絡資料。
前台代理不能確認、婉拒或取消預約，也不能標到場或開關人工確認模式；這些只有店家本人登入後才有。
代客預約依這家店的規則：可能立即成立（confirmed），或等店家確認（pending，例如客人第一次預約、有備註、人數超過自動成立上限，或服務設為人工確認）；線上付款的服務會回awaiting_payment，並附付款連結給客人。

要申請前台代理憑證，請用聯絡表單，寫明店家名稱與要連接的前台系統。

官方MCP Registry

SOP MCP在官方MCP Registry的名稱是tw.srct.sellers/sop，目前登記中。登記期間與登記完成後，都可以直接用上面的MCP網址連線。

支援

連線、登入、工具行為或前台代理憑證的問題，請用聯絡表單。