Passo a passo no claude.ai, no ChatGPT e no Gemini

Estes assistentes se conectam pela tela, com login, e abrem uma tela de consentimento em que você escolhe quais das suas lojas o assistente pode operar. Uma conexão só, para todas.

No claude.ai, o AgoraFood está no diretório de conectores: a instalação é um clique. No ChatGPT e no Gemini, você cola o endereço único do AgoraFood nas configurações deles.

Quem conecta por aqui

A tela de consentimento lista as lojas em que a sua conta é dona ou Suporte AgoraFood. Gerente, caixa, cozinha e auditor veem “Só o dono da loja ou o suporte da AgoraFood conecta o assistente pelo endereço único” — peça ao dono, ou entre com a conta dele. Os papéis estão em Equipe e permissões.

Antes de começar

1. No painel, abra Meus negócios e a aba Integrações da conta. Não é dentro de uma loja: a conexão é sua, e vale para todas — a aba só aparece para quem tem estabelecimento.

2. Para o ChatGPT e o Gemini, copie o endereço único que aparece em URL do servidor MCP. É o mesmo para todas as suas lojas — a escolha de qual operar acontece na tela de consentimento, e depois na conversa. Para o claude.ai você não precisa dele: o botão Instalar no claude.ai, na mesma aba, leva ao diretório.

No assistente

claude.ai e Claude Desktop

1. Abra o AgoraFood no diretório do claude.ai — é o botão Instalar no claude.ai da aba Integrações da conta — e clique em Instalar.

2. Entre com a sua conta do AgoraFood quando o claude.ai pedir: ele abre a tela de consentimento.

3. Marque as lojas que ele pode operar e clique em Autorizar.

Prefere adicionar à mão?

O caminho manual continua funcionando: em Personalizar → Conectores, clique em Adicionar conector personalizado, cole o endereço único como URL do servidor e, em Autenticação, mantenha Entrar agora. O consentimento é o mesmo.

ChatGPT

1. Em Configurações → Plugins → Modo de desenvolvedor, ative o modo desenvolvedor. Sem ele, o botão do passo seguinte não aparece.

2. Em Configurações → Plugins → Explorar plugins, clique no botão +.

3. Dê um nome (agorafood serve), cole o endereço único em URL do servidor, marque Entendi e quero continuar e clique em Criar.

4. Conclua as etapas: o ChatGPT abre a tela de consentimento do AgoraFood. Entre, marque as lojas e clique em Autorizar.

Gemini

1. Em gemini.google.com, abra Configurações → Inteligência Personalizada → Apps conectados → Adicionar app personalizado. Hoje isso está disponível em conta pessoal nos EUA ou no Gemini Enterprise Business.

2. Cole o endereço único e conclua o login na tela de consentimento do AgoraFood, marcando as lojas.

3. Se a opção não aparecer na sua conta, use o Gemini pelo terminal — o Gemini CLI, com token.

A tela de consentimento

Ela é do AgoraFood, e diz três coisas: quem pede (o assistente), para onde volta e em quais lojas ele vai poder agir — uma caixa por loja, com o nome e o endereço dela, todas marcadas de saída. Desmarque as que não quer conectar; ao menos uma precisa ficar. O pedido vale por dez minutos e serve uma vez — se expirar, comece de novo no assistente.

Depois de autorizar, a conexão aparece em Meus negócios → Integrações da conta, na seção Conexões multi-loja, com o tipo Login e o nome de cada loja que ela cobre.

Ligar uma loja nova, sem reconectar

Foi convidado para outra loja, como Dono ou Suporte AgoraFood? Não precisa refazer a conexão no assistente:

1. Em Meus negócios → Integrações da conta, na seção Conexões multi-loja, a loja nova aparece na linha da conexão, em Disponíveis.
2. Clique em Ligar ao lado dela. Na próxima pergunta, o assistente já a alcança.

Para tirar uma loja da conexão sem revogar as outras, clique em Desligar ao lado dela. Uma conexão pode ficar sem loja nenhuma e continuar valendo: o assistente avisa que não alcança nada e mostra onde ligar uma.

Só aparecem em Disponíveis as lojas em que você é Dono ou Suporte AgoraFood. Caixa, Atendente e os outros papéis não conectam o assistente.

Na conversa: o assistente pergunta a loja

Com mais de uma loja conectada, o assistente pergunta em qual delas agir antes de qualquer operação — pelo nome da loja, como aparece no painel. Responda pelo nome (“na Pinheiros”) e ele segue naquela loja até você mudar. Ele nunca escolhe sozinho, e ao confirmar uma operação diz em qual loja gravou.

Dica

Um endereço antigo, do tipo …/assistant/mcp/<código-da-loja>, continua funcionando por um tempo — ele conecta uma loja só, sem a pergunta. Para trocar, remova o conector antigo no assistente e conecte de novo pelo endereço único.

Já conectado: o que pedir

• “Aqui está a foto do meu cardápio. Cadastre tudo, com as seções e os preços.” (claude.ai lê a foto; a foto dos produtos, para a vitrine, depende do ambiente — veja abaixo.)
• “Esta planilha tem os meus produtos. Cadastre os que ainda não existem e atualize os preços dos que existem.”
• “Crie o grupo de complementos Adicionais com estes itens e aplique em toda a seção Lanches.”
• “Quais produtos estão sem descrição? Escreva uma para cada um e me mostre antes de salvar.”

O assistente vai pedir confirmação antes de gravar e antes de apagar — é ele quem pergunta, do lado de lá.

Fotos: você envia pelo painel, o assistente vincula

O claude.ai, o ChatGPT e o Gemini conseguem ler uma foto (do cardápio impresso, por exemplo), mas rodam num ambiente de nuvem que costuma bloquear o envio de arquivos para a loja. Por isso o caminho é o inverso: você sobe as fotos, e o assistente só diz de quem é cada uma.

1. No painel, vá em Cardápio → Fotos. Escolha o tipo (foto de produto, foto de opção ou destaque), indique o item se quiser, e envie até dez fotos de uma vez — cada uma passa pela tela de recorte. Veja Fotos em lote.

2. No assistente, peça: “vincule as fotos em espera”. Ele lista o que subiu, propõe cada vínculo pelo item que você indicou — ou olha a foto e pergunta, quando não há indicação — e grava depois que você confirmar.

Se você anexar uma foto direto na conversa e pedir “coloque no Açaí 500 ml”, o assistente ainda tenta enviar. Quando a plataforma bloqueia, ele responde com um aviso padrão — “Não deu para enviar a foto automaticamente” — e os passos acima. Os demais dados do produto já estão salvos.

Foto pela IA: depende de onde o assistente roda

O envio direto pelo assistente depende de o cliente MCP permitir conexões de saída. Em ambientes hospedados na nuvem, isso pode ser bloqueado pela plataforma de IA — e o caminho é o painel, com o assistente vinculando depois. O assistente nunca vincula sem a sua confirmação.

Dica

Pelo Claude Code, pelo Cursor, pelo VS Code ou pelo LM Studio o envio funciona sempre: o cliente roda na sua máquina, sem esse bloqueio — veja ferramentas locais.

Desconectar

Em Meus negócios → Integrações da conta, na seção Conexões multi-loja, clique em Revogar na linha da conexão. A conexão é sua, não de uma loja: revogar corta o acesso a todas as lojas dela de uma vez, na próxima chamada. Do lado do assistente, remova o conector para ele parar de tentar.