Kirah Local Services

oficial

Descubra negócios Kirah, navegue pelos serviços publicados e verifique a disponibilidade atual por meio de um servidor MCP seguro e somente leitura.

O que você pode fazer com Kirah Local Services MCP?

  • Encontre serviços locais por descrição — Peça ao seu assistente para localizar um serviço de beleza ou bem-estar que atenda às suas necessidades, como massagem de tecidos profundos, e veja listagens reais.
  • Verifique detalhes do serviço e preços — Solicite o preço atual, a duração e o link do comerciante para um serviço específico antes de decidir onde agendar.
  • Confirme a disponibilidade em tempo real — Pergunte se um profissional tem um horário livre em um momento específico, como entre 14h e 16h hoje.
  • Solicite um agendamento via IA — Peça ao seu assistente para enviar uma solicitação de reserva que aguarda a aprovação do proprietário quando a empresa usa o modo Aprovar primeiro.
  • Descubra empresas pelo UCP — Pergunte sobre empresas locais participantes que aparecem em catálogos públicos, a menos que tenham optado por não ser descobertas.

Documentação

Deixe os clientes encontrarem seus serviços com IA

Por que isso existe

As pessoas cada vez mais perguntam ao seu assistente, não a uma barra de busca. O cliente que precisa de massagem profunda hoje entre 14h e 16h não deveria navegar por cinco telas para descobrir que o horário não funciona—e o profissional com exatamente essa vaga não deveria ficar invisível para a pergunta. Kirah é a conexão: sem esforço para o cliente perguntar, sem esforço para o profissional ser encontrado. A história completa →

Guia prático: como assistentes de IA encontram um negócio de beleza ou bem-estar →

Como isso funciona para um cliente

No ChatGPT: Um cliente pede massagem de cadeira em Columbus e vê o serviço real, o preço e o horário de funcionamento de um negócio participante. O cliente então agenda fora do ChatGPT porque o plugin público não cria compromissos.

No Claude ou Grok: Um cliente faz a mesma pergunta, vê o serviço, o preço e o horário real, e então solicita o agendamento. Se o negócio usa o modo Aprovar primeiro, o proprietário aprova a solicitação e o cliente recebe a confirmação.

Como funciona

Conecte o Gemini CLI a catálogos de serviços públicos

Instale o cliente de catálogo Kirah local →

As duas ferramentas pesquisam catálogos de serviços e verificam novamente os detalhes de um serviço, retornando preços listados, durações e links do comerciante. Elas não verificam disponibilidade, não agendam nem pagam. Isso exige instalação explícita no Gemini CLI ou em outro host MCP stdio; não é uma integração de consumidor Gemini nem descoberta automática pela internet. Os rótulos de demonstração devem permanecer visíveis; não marcado como demonstração não significa verificado ou certificado.

Para desenvolvedores e criadores de agentes

Plugin público do ChatGPT: https://kirah.ai/api/mcp-directory-v1\ — uma superfície informativa limitada à descoberta de negócios e serviços, além da disponibilidade atual. Não coleta detalhes de agendamento nem altera compromissos.

Endpoint MCP com capacidade de agendamento: https://kirah.ai/api/mcp\ — HTTP Streamable sem estado para conexões compatíveis, com ferramentas que cobrem da descoberta ao cancelamento seguro. Introspecção ao vivo em /api/mcp-info\. O Claude usa seu conector dedicado documentado em /claude-connector.html\.

Contrato OpenAPI: /.well-known/kirah-gateway.openapi.json\ — versionado, com um envelope de resposta total (cada resposta carrega um outcome\) e limites de taxa em camadas que nunca cobram uma solicitação malformada contra um orçamento de agendamento.

Manifestos por negócio: /.well-known/kirah.json\ em domínios de tenant, com cabeçalhos Link: rel="service-desc"\ em tenants hospedados por caminho—para que até mesmo um curl\ bruto sem JavaScript encontre o manifesto.

A parte que importa para os proprietários

Descoberta UCP por padrão, com opção de exclusão

Catálogos públicos elegíveis participam da descoberta UCP, a menos que o proprietário opte por sair ou uma restrição de segurança se aplique. Isso não habilita agendamento por agentes. Conexões MCP hospedadas existentes mantêm suas regras de consentimento separadas.

O modo de aprovação se aplica a agentes com capacidade de agendamento

Uma solicitação de agendamento do Claude ou Grok aguarda seu sim exatamente como uma solicitação do seu próprio site. Nada é confirmado sem você quando o modo Aprovar primeiro está ativado.

As regras são aplicadas pelo servidor

Depósitos, políticas e limites de taxa são aplicados onde o modelo não pode sobrescrevê-los. O log de auditoria é somente de acréscimo.

Dados privados permanecem no escopo do tenant

Catálogos de serviços públicos permanecem descobríveis, enquanto dados privados de agendamento e tokens de capacidade são limitados a um negócio. O servidor rejeita agendamentos inelegíveis e tentativas de burlar regras.