Kirah Local Services
官方探索Kirah商家,瀏覽已發布的服務,並透過安全、唯讀的MCP伺服器查看目前可用狀態。
你可以用 Kirah Local Services MCP 做什麼?
- 依描述尋找本地服務 — 請您的助理搜尋符合需求的美容或養生服務,例如深層組織按摩,並查看真實的商家列表。
- 查看服務詳情與價格 — 在決定預約地點前,先索取特定服務的目前價格、時長及商家連結。
- 確認即時空檔 — 詢問服務提供者是否在特定時間有空檔,例如今天下午 2 點到 4 點之間。
- 透過 AI 請求預約 — 當商家使用「先核准後預約」模式時,請您的助理提交預約請求,並等待商家核准。
- 透過 UCP 探索商家 — 查詢出現在公開目錄中的參與本地商家,除非他們已選擇退出被探索。
文件
讓客戶透過 AI 找到您的服務
為什麼需要這個功能
人們越來越常詢問他們的 AI 助理,而不是搜尋列。需要在今天下午 2 點到 4 點之間進行深層組織按摩的客戶,不應該點擊五個畫面才發現時間不行——而正好有那個空檔的治療師,也不應該在客戶的提問中隱形。Kirah 就是連結:讓客戶詢問無痛,讓治療師被找到無痛。完整故事 →
這對客戶來說是什麼樣子
在 ChatGPT 中: 客戶詢問哥倫布市的座椅按摩,看到參與商家的真實服務、價格和營業時間。客戶隨後在 ChatGPT 之外預約,因為公開外掛程式不會建立預約。
在 Claude 或 Grok 中: 客戶詢問同樣的問題,看到服務、價格和真實營業時間,然後請求預約。如果商家使用 Approve first,業主批准請求後,客戶就會收到確認。
運作方式
將 Gemini CLI 連接到公開服務目錄
這兩個工具會搜尋服務目錄並重新檢查服務的詳細資料,回傳列出的價格、時長和商家連結。它們不會檢查可用性、預約或付款。這需要在 Gemini CLI 或其他 stdio MCP 主機中明確安裝;這不是消費級 Gemini 整合或自動網際網路探索。示範標籤必須保持可見;未標記為示範並不代表已驗證或認證。
給開發人員和代理建構者
公開 ChatGPT 外掛程式: https://kirah.ai/api/mcp-directory-v1\ — 一個僅限於商家和服務探索以及目前可用性的資訊型介面。它不會收集預約詳細資料或變更預約。
具備預約能力的 MCP 端點: https://kirah.ai/api/mcp\ — 用於相容連線的無狀態 Streamable HTTP,工具涵蓋從探索到安全取消。即時內省位於 /api/mcp-info\。Claude 使用其專用連接器,文件位於 /claude-connector.html\。
OpenAPI 契約: /.well-known/kirah-gateway.openapi.json\ — 有版本管理,具有總回應封套(每個回應都帶有 outcome\)和分層速率限制,絕不會將格式錯誤的請求計入預約額度。
每個商家的清單: /.well-known/kirah.json\ 位於租戶網域上,路徑託管租戶帶有 Link: rel="service-desc"\ 標頭——因此即使是沒有 JavaScript 的原始 curl\ 也能找到清單。
對業主重要的部分
預設啟用 UCP 探索,可選擇退出
符合資格的公開目錄參與 UCP 探索,除非業主選擇退出或適用安全限制。這不會啟用代理預約。現有的託管 MCP 連線保留其各自的同意規則。
核准模式適用於具備預約能力的代理
來自 Claude 或 Grok 的預約請求會等待您的同意,就像來自您自己網站的請求一樣。當 Approve first 開啟時,沒有您的確認就不會確認任何事項。
規則由伺服器執行
訂金、政策和速率限制在模型無法覆寫的地方執行。稽核日誌僅能附加。
私人資料保持在租戶範圍內
公開服務目錄保持可探索,而私人預約資料和功能權杖則限定在單一商家範圍內。伺服器會拒絕不符合資格的預約和規避規則的行為。