Conectar o BarbeiroApp à sua IA (MCP / OAuth)

O BarbeiroApp expõe um servidor MCP (Model Context Protocol) que permite a qualquer IA compatível — Claude Desktop, ChatGPT (via custom GPT), n8n, agentes próprios — consultar e operar o seu negócio de forma segura.

O que dá pra fazer

Depois de conectar, a IA pode:

• Listar os agendamentos de hoje, amanhã, da semana
• Ver suas comissões, vendas, clientes inativos, aniversariantes
• Verificar disponibilidade de horários
• Criar, cancelar e reagendar agendamentos
• Listar profissionais, serviços, produtos
• Consultar reviews, status do caixa, estoque baixo

A lista completa de ferramentas vive no código (lib/ai/tools/) e cresce a cada release.

Assim que conecta, a IA já sabe qual negócio ela está operando — o nome e o fuso horário do estabelecimento são informados automaticamente, então ela interpreta e responde horários no fuso certo sem você precisar explicar.

Atalhos prontos

Em clientes que suportam (como o Claude Desktop), o BarbeiroApp oferece atalhos de um clique — você escolhe num menu em vez de digitar o pedido:

• Resumo do dia — agenda, faturamento previsto e destaques de hoje
• Clientes inativos — quem não volta há mais de 60 dias, com sugestão de reengajamento
• Fechamento de caixa — vendas por forma de pagamento e valor esperado em caixa
• Buracos na agenda — horários vagos de hoje por profissional

Cada atalho só aparece se a conexão tiver as permissões necessárias. Em clientes que não suportam atalhos, é só pedir a mesma coisa por texto.

Como funciona a segurança

• OAuth 2.1 com PKCE. Nenhuma chave de API estática — sempre consentimento explícito do dono.
• O endereço define o negócio. Conectar em sua-barbearia.barbeiro.app prende o acesso àquela barbearia; conectar em admin.barbeiro.app deixa você escolher qual. Cada conexão concede acesso a UM negócio, e um token de uma barbearia não funciona no endereço de outra.
• Permissões por área. O acesso é agrupado em áreas — agenda, catálogo, equipe, clientes, financeiro, marketing, configurações e relatórios — cada uma com (ver) e (mudar). A tela de consentimento separa o que a IA pode do que pode (as escritas são o risco), e você vê tudo antes de aprovar.