Conectar o Claude Desktop à plataforma

Requisitos

Claude Desktop versão 1.6 ou superior (suporta MCP remoto via OAuth)
Você logado na plataforma 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 o endereço do negócio que você quer conectar — o endereço decide qual barbearia a IA acessa:

Campo	Valor
Name	`Minha barbearia` (o nome que você quiser)
URL	`https://sua-barbearia.barbeiro.app/api/mcp`

Troque sua-barbearia pelo subdomínio da sua barbearia (o mesmo que aparece no endereço do seu painel). Tem domínio próprio? Use https://seudominio.com.br/api/mcp.

Prefere escolher a barbearia na hora do consentimento? Use https://admin.barbeiro.app/api/mcp — se você tiver mais de uma, a tela de autorização mostra um seletor.

Passo 3 — Autorizar

O Claude vai abrir uma aba do seu navegador na tela de autorização da plataforma (no mesmo endereço que você configurou). 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 (ou um seletor, se você usou admin.barbeiro.app e tem mais de uma barbearia)
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ã?

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

O Claude vai chamar as ferramentas da plataforma 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:

No Claude, adicione outro connector com nome diferente (ex: Unidade Centro).
Aponte para o subdomínio da outra barbearia (https://outra-barbearia.barbeiro.app/api/mcp) — o endereço já fixa qual negócio. (Se preferir, use admin.barbeiro.app/api/mcp e escolha no seletor.)
Os dois ficam ativos lado a lado.

Revogar

Em Configurações → Aplicativos conectados na plataforma você vê todas as conexões e corta o acesso com um clique, em Cortar acesso. 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 /help.

"O Claude diz que não tem acesso a uma ferramenta": o token foi emitido com escopos limitados. O cartão da conexão em Aplicativos conectados mostra exatamente o que ele lê, o que ele muda e o que ele não pode fazer. Corte o acesso ali e refaça o consentimento marcando todas as permissões.