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 negócio a IA acessa:

Campo	Valor
Name	`Meu negócio` (o nome que você quiser)
URL	`https://seunegocio.barbeiro.app/api/mcp`

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

Prefere escolher o negócio na hora do consentimento? Use https://mcp.barbeiro.app/api/mcp (o endereço https://admin.barbeiro.app/api/mcp também funciona) — se você tiver mais de um, 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 que está pedindo acesso (Claude ou similar) e o endereço dele
Em Negócio, qual estabelecimento será conectado (ou um seletor, se você usou mcp.barbeiro.app e tem mais de um negócio)
As permissões em dois quadros: Poderá ver e Poderá alterar. Quando a lista é longa, o quadro vem fechado: clique nele para ver cada permissão. Fechado, o Poderá alterar já mostra as áreas que o app vai poder mudar (agenda, clientes, financeiro…)
No rodapé, com qual conta você entrou. Se não for a sua, clique em Não é você? para sair e entrar com a conta certa

Clique em Permitir acesso. 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 um segundo negócio ao mesmo Claude:

No Claude, adicione outro connector com nome diferente (ex: Unidade Centro).
Aponte para o subdomínio do outro negócio (https://outronegocio.barbeiro.app/api/mcp) — o endereço já fixa qual negócio. (Se preferir, use mcp.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.

"Apareceu a tela 'Não foi possível conectar'": o Claude mandou um pedido que a plataforma não reconheceu. Feche a aba e comece a conexão de novo pelo Claude; em geral uma atualização do Claude resolve. Se persistir, abra um chamado em /help e copie o texto de Detalhes para quem desenvolve o aplicativo, que aparece na mesma tela.

"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.