# Conectar o Claude Desktop à plataforma

Fonte: https://docs.barbeiro.app/business-admin/integrations/mcp-connect-claude-desktop
Perfil: Administrador
Verificado em: 2026-08-25

Passo a passo para usar o **Claude Desktop** como interface conversacional para o seu negócio.

## 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ã?

ou

> 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:

1. No Claude, adicione outro connector com nome diferente (ex: `Unidade Centro`).
2. 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.)
3. Os dois ficam ativos lado a lado.

## Revogar

Em [Configurações → Aplicativos conectados](/settings/apps) 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](/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.

## Leia também

- [Conectar a plataforma à sua IA (MCP / OAuth)](https://docs.barbeiro.app/business-admin/integrations/mcp-overview)