Kirah Local Services

官方

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

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

  • 按描述查找本地服务 — 让您的助手根据您的需求定位美容或健康服务,例如深层组织按摩,并查看真实列表。
  • 查看服务详情和价格 — 在决定预订地点之前,先查询特定服务的当前价格、时长和商家链接。
  • 核实实时可用性 — 询问服务提供者是否在特定时间有空,例如今天下午2点到4点之间。
  • 通过AI请求预约 — 让您的助手提交预订请求,当商家使用“先批准”模式时,该请求会等待店主批准。
  • 通过UCP发现商家 — 查询出现在公共目录中的参与本地商家,除非他们已选择退出发现功能。

文档

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

为什么需要这个功能

如今,人们越来越多地直接询问他们的 AI 助手,而不是使用搜索栏。一位今天下午 2 点到 4 点之间需要深层组织按摩的客户,不应该为了得知该时段不可用而点击五个页面——而恰好有该空档的服务提供者,也不应该对这个问题不可见。Kirah 就是这座桥梁:客户提问毫无负担,服务提供者被发现也毫不费力。完整故事 →

实用指南:AI 助手如何找到美容或健康养生商家 →

这对客户来说是什么体验

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

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

工作原理

将 Gemini CLI 连接到公共服务目录

安装本地 Kirah 目录客户端 →

这两个工具会搜索服务目录并重新核对服务的详细信息,返回列出的价格、时长和商家链接。它们不会检查可用性、进行预约或支付。这需要在 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 的预约请求会像来自你自己网站的请求一样等待你的确认。当“先批准”模式开启时,未经你的确认不会确认任何内容。

规则由服务器强制执行

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

私有数据保持租户隔离

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