--- title: "Conectar a BeeFood ao Claude" description: "Conecte seu restaurante BeeFood ao Claude e consulte pedidos, cardápio e clientes com os acessos que você liberar." url: "https://developer.beefood.com.br/docs/mcp/claude" group: "Referência" lang: "pt" --- # 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](https://claude.ai). 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: | Campo | Valor | |---|---| | Nome | `BeeFood` | | URL | `https://docs.beefood.app/mcp` | ## Passo a passo ### 1. Abra a Personalização No Claude, clique em **Personalização** no menu lateral. ![Menu Personalização no Claude](/__l5e/assets-v1/530bc3aa-64c1-4e2e-886d-1f55d2f48060/claude-01-menu-personalizacao.png) ### 2. Adicione um conector personalizado Abra a aba **Conectores**, clique em **Adicionar**, no canto superior direito, e escolha **Adicionar conector personalizado**. ![Adicionar conector personalizado](/__l5e/assets-v1/67a75716-045a-4d73-9f55-87d813ddc5db/claude-02-adicionar-conector.png) ### 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**. ![Nome e URL do conector](/__l5e/assets-v1/617e4036-6c37-42e4-ba78-ac1ff610e583/claude-03-nome-url.png) ### 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**. ![Opções de autenticação](/__l5e/assets-v1/99e50002-d403-4d2a-8c3a-8ee0cdf993d4/claude-04-autenticacao.png) ### 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**. ![Botão Vincular](/__l5e/assets-v1/f8c15ee6-4189-49f6-adf1-c01bb2a5b532/claude-05-vincular.png) ### 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. ![Login da BeeFood](/__l5e/assets-v1/f849bf6f-5e98-44a1-9641-257f83cb787e/claude-06-login-beefood.png) ### 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. | Permissão | O que o Claude consegue ver ou alterar | |---|---| | Restaurante | Dados do restaurante | | Pedidos | Pedidos e seus status | | Catálogo | Cardápio: grupos, produtos e complementos | | Clientes | Cadastro de clientes | | Cupons | Cupons de desconto | | Avaliações | Avaliações dos clientes | | Entregadores | Em breve | | Estoque | Em breve | ![Tela de permissões da BeeFood](/__l5e/assets-v1/a3e18921-4791-406a-9dce-aeefa8f2f0e5/claude-07-permissoes.png) ### 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**. ![Permissões das ferramentas no Claude](/__l5e/assets-v1/138057f5-fba1-4f37-8763-732f76a33f4f/claude-08-permissoes-ferramentas.png) ### 9. Faça a primeira pergunta Pergunte algo sobre o seu restaurante. Por exemplo: > Liste os últimos 5 pedidos realizados em meu restaurante ![Primeira pergunta no Claude](/__l5e/assets-v1/ab42a924-8fe2-4e95-a093-28c35572d5ce/claude-09-primeira-pergunta.png) ### 10. Pronto O Claude consulta a BeeFood e responde com os dados do seu restaurante. ![Resposta com os pedidos](/__l5e/assets-v1/a61009a2-9395-4e2b-a487-aeb4a3cc0776/claude-10-resposta-pedidos.png) ## 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.