Conectar a BeeFood ao Claude

Com a BeeFood conectada, você pergunta ao Claude sobre o seu restaurante em linguagem natural: pedidos do dia, cardápio, clientes, cupons e avaliações. O Claude consulta os dados reais do restaurante, apenas com os acessos que você liberar.

A conexão leva cerca de 3 minutos e é feita uma única vez.

Antes de começar

Você vai precisar de:

• Uma conta no Claude. O plano gratuito funciona, mas permite apenas um conector personalizado.
• O login e a senha do painel BeeFood do seu restaurante.

Deixe estes dados à mão, você vai copiá-los no passo 3:

Passo a passo

1. Abra a Personalização

No Claude, clique em Personalização no menu lateral.

2. Adicione um conector personalizado

Abra a aba Conectores, clique em Adicionar, no canto superior direito, e escolha Adicionar conector personalizado.

3. Informe o nome e a URL

1. No primeiro campo, digite BeeFood.
2. No segundo campo, cole https://docs.beefood.app/mcp.
3. Clique em Continuar.

4. Escolha a autenticação

1. Em Autenticação, marque Entrar agora.

   O Claude pode sugerir Sem login com a etiqueta Detectado. Não use essa opção: o Claude precisa do login para acessar os dados do seu restaurante.

2. Em Cliente OAuth, mantenha Usar a identidade publicada do Claude.

3. Clique em Adicionar.

5. Vincule a sua conta

O Claude abre o site da BeeFood para você entrar. Se a janela não abrir, ou se você a fechou antes de terminar, a página do conector mostra Você começou a se conectar a BeeFood, mas não concluiu. Clique em Vincular.

6. Entre com a sua conta BeeFood

Digite o login e a senha do painel do seu restaurante e clique em Entrar.

Se você já estiver logado no painel BeeFood nesse navegador, esta tela não aparece e você vai direto para o passo 7.

7. Escolha o que o Claude pode acessar

Na tela Conectar com BeeFood:

1. Confira se a tela diz Claude está pedindo acesso ao seu restaurante.
2. Confira em Autorizando como se o restaurante está correto. Se você tem mais de um restaurante, troque pela lista logo abaixo do nome.
3. Marque as permissões que deseja liberar nas colunas Leitura e Escrita. O botão Permitir só fica ativo depois que você marca pelo menos uma.
4. Clique em Permitir.

O que cada coluna libera:

• Leitura: o Claude pode consultar os dados. Exemplo: listar pedidos.
• Escrita: o Claude também pode alterar os dados. Exemplo: mudar o status de um pedido ou criar um cupom.

Se preferir, marque só Leitura e libere Escrita depois, quando precisar.

8. Ajuste as permissões das ferramentas

Depois de clicar em Permitir, você volta para o Claude, na página do conector BeeFood. Ela lista as ferramentas da BeeFood em dois grupos:

• Ferramentas somente leitura: consultam a documentação da BeeFood. Já vêm como Sempre permitir.
• Ferramentas de gravação/exclusão: acessam os dados do seu restaurante. Vêm como Requer aprovação.

Para o Claude não pedir a sua autorização a cada pergunta, mude Ferramentas de gravação/exclusão para Sempre permitir. Em seguida, clique em Novo no menu lateral.

A ferramenta Authenticate and execute BeeFood request é a mesma para consultar e para alterar dados. Com Sempre permitir, o Claude também deixa de pedir confirmação antes de alterações, como mudar o status de um pedido. Se preferir confirmar cada uso, mantenha Requer aprovação: a cada consulta, o Claude vai perguntar se você quer Permitir uma vez, Sempre permitir ou Negar.

9. Faça a primeira pergunta

Pergunte algo sobre o seu restaurante. Por exemplo:

Liste os últimos 5 pedidos realizados em meu restaurante

10. Pronto

O Claude consulta a BeeFood e responde com os dados do seu restaurante.

Exemplos de perguntas

• Quanto vendi hoje?
• Liste os produtos do meu cardápio.
• Quais pedidos ainda estão em aberto?
• Liste os cupons ativos.
• Mostre as últimas avaliações dos clientes.

Segurança

• O Claude acessa os dados reais do seu restaurante, apenas com as permissões que você marcou no passo 7.
• A sua senha da BeeFood é digitada no site da BeeFood e nunca é compartilhada com o Claude.
• Você pode cancelar o acesso a qualquer momento.

Como desconectar

Você pode cancelar o acesso por qualquer um dos dois lados:

• No painel BeeFood: no menu de API, revogue o acesso do Claude.
• No Claude: em Personalização → Conectores, abra o BeeFood e clique em Desvincular.

Problemas comuns

Não consigo adicionar o conector no plano gratuito. O plano gratuito do Claude permite apenas um conector personalizado. Remova o conector que você já tem em Personalização → Conectores e adicione o BeeFood.

O Claude não consegue acessar os dados do restaurante. Confira se a autenticação ficou como Entrar agora no passo 4. Se ficou como Sem login, remova o conector e adicione de novo, marcando Entrar agora.

O botão "Permitir" não fica ativo. Marque pelo menos uma permissão na tabela do passo 7.

O Claude diz que não tem permissão para ver ou alterar algo. A permissão necessária não foi marcada no passo 7. Clique em Desvincular, depois em Vincular, e marque o acesso que falta. Por exemplo, para perguntas sobre pedidos, marque Pedidos.

Demorei para fazer o login e a conexão deu erro. O link de autorização expira em poucos minutos. Abra o BeeFood em Personalização → Conectores e clique em Vincular de novo.