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.

Como funciona a segurança

• OAuth 2.1 com PKCE. Nenhuma chave de API estática — sempre consentimento explícito do dono.
• Por estabelecimento. Cada conexão concede acesso a UM negócio. Se você opera duas barbearias e quer conectar as duas, faz dois consentimentos.
• Escopos granulares. O app pede acesso a bookings:read, commissions:read etc. — você vê a lista antes de aprovar.
• Token revogável a qualquer momento em Configurações → Aplicativos conectados.

URL do servidor MCP

https://www.barbeiro.app/api/mcp

A discovery automática (RFC 8414/9728) está em:

https://www.barbeiro.app/.well-known/oauth-authorization-server
https://www.barbeiro.app/.well-known/oauth-protected-resource

Clientes MCP modernos (incluindo Claude Desktop) leem esses endpoints sozinhos, então normalmente basta apontar para https://www.barbeiro.app/api/mcp.

Passo a passo

1. No app cliente (ex: Claude Desktop), adicione um servidor MCP apontando para https://www.barbeiro.app/api/mcp.
2. O cliente vai te redirecionar para o BarbeiroApp para fazer login (se ainda não estiver).
3. Você verá uma tela de consentimento com o nome do app, o estabelecimento que ele vai acessar e a lista de permissões. Confirme.
4. Pronto — o app já consegue chamar as ferramentas. Faça uma pergunta como "quantos agendamentos eu tenho amanhã?" e veja a resposta vir do BarbeiroApp.