Conectar o Claude Desktop ao BarbeiroApp

Passo a passo para usar o Claude Desktop como interface conversacional para o seu BarbeiroApp.

Requisitos

• Claude Desktop versão 1.6 ou superior (suporta MCP remoto via OAuth)
• Você logado no BarbeiroApp como administrador do negócio que quer conectar

Passo 1 — Abrir as configurações do Claude

No menu Claude → Settings → Connectors.

Passo 2 — Adicionar o servidor MCP

Clique em Add custom connector e use:

| Campo | Valor | | --- | --- | | Name | BarbeiroApp | | URL | https://www.barbeiro.app/api/mcp |

Passo 3 — Autorizar

O Claude vai abrir uma aba do seu navegador apontando para https://www.barbeiro.app/oauth/authorize. Se você ainda não estiver logado, faça login normalmente. Em seguida, você verá:

• O nome do app (Claude Desktop ou similar)
• Qual estabelecimento será conectado
• A lista de permissões pedidas

Clique em Permitir. A aba vai fechar e o Claude já está conectado.

Passo 4 — Testar

No Claude, pergunte algo como:

Quantos agendamentos eu tenho amanhã?

ou

Mostra os clientes que não vêm há mais de 60 dias.

O Claude vai chamar as ferramentas do BarbeiroApp e responder com os dados reais do seu negócio.

Múltiplos estabelecimentos

Cada conexão é por estabelecimento. Para conectar uma segunda barbearia ao mesmo Claude:

1. No Claude, adicione outro connector com nome diferente (ex: BarbeiroApp - Unidade Centro).
2. Use a mesma URL — o Claude vai abrir o consentimento de novo, e nessa hora você escolhe o outro negócio.
3. Os dois ficam ativos lado a lado.

Revogar

Em Configurações → Aplicativos conectados no BarbeiroApp você vê todas as conexões e pode revogar com um clique. O Claude vai parar de funcionar com aquele negócio na próxima requisição.

Problemas comuns

"O cliente não me redirecionou": verifique se o Claude Desktop está atualizado. Versões antigas não suportam OAuth remoto.

"Recebi uma tela de erro 'redirect_uri não autorizado'": o Claude está usando uma URL de retorno diferente da registrada. Em geral isso resolve com uma atualização do Claude. Se persistir, abra um chamado em .