Kirah Local Services

官方

探索Kirah商家,瀏覽已發布的服務,並透過安全、唯讀的MCP伺服器查看目前可用狀態。

你可以用 Kirah Local Services MCP 做什麼?

  • 探索本地服務 — 請您的助理透過公開的 plugin 端點,尋找提供特定服務(例如哥倫布地區的按摩椅服務)的商家,並取得真實價格與可用時段。
  • 查看目前空檔 — 使用具備預約功能的 MCP 端點,請求某項服務的目前可用時段,確認商家是否有符合您行程的安排。
  • 預約服務 — 請您的助理透過 MCP 端點預約服務;當商家使用「先核准」模式時,系統會等待業主批准。
  • 檢視商家政策 — 在確認預約前,詢問伺服器對特定商家所執行的訂金、取消規則或速率限制等相關政策。

文件

讓客戶透過 AI 找到您的服務

為什麼需要這個功能

人們越來越常詢問他們的 AI 助理,而不是搜尋列。需要在今天下午 2 點到 4 點之間進行深層組織按摩的客戶,不應該點擊五個畫面才發現時間不行——而正好有那個空檔的治療師,也不應該在客戶的提問中隱形。Kirah 就是連結:讓客戶詢問零負擔,讓治療師被找到零負擔。完整故事 →

對客戶來說這是什麼樣子

在 ChatGPT 中: 客戶詢問哥倫布市的座椅按摩,看到參與商家的真實服務、價格和營業時間。客戶隨後在 ChatGPT 之外預約,因為公開外掛程式不會建立預約。

在 Claude 或 Grok 中: 客戶詢問同樣的問題,看到服務、價格和真實營業時間,然後請求預約。如果商家使用 Approve first,業主核准請求,客戶便會收到確認。

運作方式

給開發者和代理建構者

公開 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\)和分層速率限制,絕不會將格式錯誤的請求計入預約額度。

每個商家的 manifest: /.well-known/kirah.json\ 位於租戶網域,Link: rel="service-desc"\ 標頭位於路徑託管的租戶——因此即使是沒有 JavaScript 的原始 curl\ 也能找到 manifest。

對業主重要的部分

選擇加入,每個商家各自決定

AI 代理的探索功能在您開啟之前是關閉的。您的商家預設絕不會暴露給代理。

核准模式適用於具備預約能力的代理

來自 Claude 或 Grok 的預約請求會等待您的同意,就像來自您自己網站的請求一樣。當 Approve first 開啟時,沒有您的確認,任何事都不會成立。

規則由伺服器執行

訂金、政策和速率限制在模型無法覆寫的地方執行。稽核日誌僅能附加。

私人資料保持在租戶範圍內

公開服務目錄保持可探索,而私人預約資料和能力權杖則限定在單一商家範圍內。伺服器拒絕不符合資格的預約和規避規則的行為。