Kirah Local Services

официальный

Откройте для себя бизнесы Kirah, просматривайте опубликованные услуги и проверяйте текущую доступность через безопасный MCP-сервер только для чтения.

Что можно делать с Kirah Local Services MCP?

  • Поиск локальных услуг — Попросите ассистента найти компанию, предлагающую конкретную услугу, например массаж в кресле в Колумбусе, с реальной ценой и доступностью через публичную конечную точку плагина.
  • Проверка текущих окон — Запросите текущую доступность услуги и узнайте, есть ли у компании свободное окно, подходящее вашему графику, используя конечную точку MCP с поддержкой бронирования.
  • Запрос на запись — Попросите ассистента забронировать услугу через конечную точку MCP, которая может ожидать одобрения владельца, если компания использует режим «Сначала подтверждение».
  • Изучение политик компании — Уточните информацию о депозитах, правилах отмены или лимитах запросов, которые сервер применяет для конкретной компании, прежде чем совершать бронирование.

Документация

Помогите клиентам находить ваши услуги с помощью ИИ

Зачем это существует

Люди всё чаще обращаются к своему ассистенту, а не к поисковой строке. Клиенту, которому нужен глубокий массаж сегодня с 14 до 16, не нужно пролистывать пять экранов, чтобы узнать, что время не подходит — а специалист с именно таким свободным окном не должен оставаться невидимым для этого вопроса. Kirah — это связующее звено: клиенту легко спросить, специалисту легко быть найденным. Полная история →

Как это выглядит для клиента

В ChatGPT: Клиент просит массаж в кресле в Колумбусе и видит реальную услугу, цену и свободное окно участвующего бизнеса. Затем клиент записывается вне ChatGPT, потому что публичный плагин не создаёт записи.

В Claude или Grok: Клиент задаёт тот же вопрос, видит услугу, цену и реальное свободное окно, затем запрашивает запись. Если бизнес использует режим Approve first, владелец одобряет запрос, и клиент получает подтверждение.

Как это работает

Для разработчиков и создателей агентов

Публичный плагин ChatGPT: https://kirah.ai/api/mcp-directory-v1\ — информационная поверхность, ограниченная поиском бизнеса и услуг, а также текущей доступностью. Он не собирает данные для записи и не изменяет записи.

MCP-эндпоинт с возможностью записи: https://kirah.ai/api/mcp\ — stateless 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"\ для арендаторов, размещённых по пути — так что даже сырой curl\ без JavaScript найдёт манифест.

Что важно для владельцев

Опционально, для каждого бизнеса

Поиск ИИ-агентами отключён, пока вы его не включите. Ваш бизнес по умолчанию не виден агентам.

Режим одобрения применяется к агентам с возможностью записи

Запрос на запись от Claude или Grok ожидает вашего «да» точно так же, как запрос с вашего собственного сайта. Ничто не подтверждается без вас, когда включён режим Approve first.

Правила применяются сервером

Депозиты, политики и лимиты применяются там, где модель не может их переопределить. Журнал аудита доступен только для добавления.

Приватные данные остаются в пределах арендатора

Публичные каталоги услуг остаются доступными для поиска, а приватные данные о записях и токены возможностей ограничены одним бизнесом. Сервер отклоняет неподходящие записи и попытки обойти правила.