Kirah Local Services

官方

通过安全、只读的MCP服务器,发现Kirah商家、浏览已发布的服务,并查看当前可用性。

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

  • 发现本地服务 — 让您的助手通过公共插件端点查找提供特定服务(如哥伦布的按摩椅)的商家,并获取真实价格和可用性信息。
  • 查看当前空档 — 请求某项服务的当前可用性,查看商家是否有适合您日程的空档,使用支持预订的 MCP 端点。
  • 预约服务 — 让您的助手通过 MCP 端点预订服务,当商家使用“先批准”模式时,可等待业主批准。
  • 查看商家政策 — 在确认预订前,询问服务器针对特定商家执行的押金、取消规则或速率限制。

文档

让客户通过 AI 找到你的服务

为什么需要这个功能

人们越来越倾向于向他们的助手提问,而不是使用搜索栏。需要在今天下午 2 点到 4 点之间进行深层组织按摩的客户,不应该点击五个页面才发现时间不合适——而恰好有这个空档的理疗师,也不应该对这个问题不可见。Kirah 就是连接双方的桥梁:客户提问无痛,理疗师被发现也无痛。完整故事 →

这对客户来说是什么体验

在 ChatGPT 中: 客户询问哥伦布的座椅按摩,看到参与商家的真实服务、价格和营业时间。然后客户在 ChatGPT 之外进行预约,因为公共插件不会创建预约。

在 Claude 或 Grok 中: 客户提出同样的问题,看到服务、价格和真实营业时间,然后请求预约。如果商家启用了“先批准”模式,店主会批准请求,客户会收到确认。

工作原理

面向开发者和智能体构建者

公共 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\ 也能找到清单文件。

对店主最重要的部分

选择加入,按商家独立控制

AI 智能体的发现功能默认关闭,直到你主动开启。你的商家默认不会暴露给智能体。

批准模式适用于支持预约的智能体

来自 Claude 或 Grok 的预约请求会等待你的确认,就像来自你自己网站的请求一样。当“先批准”模式开启时,未经你的确认,任何预约都不会被确认。

规则由服务器强制执行

押金、政策和速率限制在模型无法覆盖的层面强制执行。审计日志仅支持追加。

私有数据保持租户隔离

公共服务目录保持可发现性,而私有预约数据和能力令牌仅限于单个商家。服务器会拒绝不符合条件的预约和规则绕过行为。