Claude Code, Gemini CLI, Cursor, VS Code e LM Studio: conectar por token

Ferramentas que rodam na sua máquina — o terminal do Claude Code e do Gemini CLI, os editores Cursor e VS Code, e o LM Studio, que roda modelos de IA localmente — não abrem uma tela de login. Elas se conectam com um token: uma chave que o painel gera uma vez e você cola num comando ou num arquivo. Como rodam no seu computador, sem a rede restrita de uma plataforma de nuvem, elas enviam as fotos dos produtos direto — é o caminho certo para fotos.

Gerar o token

1. No painel da loja, abra Configurações → Integrações → Assistente de IA.

2. Em Clientes externos (MCP), clique em Conectar um cliente externo e escolha Cole o token.

3. Dê um nome ao token — o computador ou a ferramenta em que ele vai viver, por exemplo.

4. Clique em gerar. O token aparece só agora: ao fechar, não dá para lê-lo de novo — só emitir outro.

5. O painel monta os comandos prontos para o Claude Code e o Gemini CLI, e o trecho Local — mcp.json (para o Cursor e o LM Studio), já com o endereço da loja e o token. Para o VS Code, copie o token e o endereço e use o trecho abaixo.

Por token, o endereço é o da loja

O token é de uma loja, e o endereço dos comandos termina com o código dela — outra loja é outro token e outro comando, com outro nome de servidor (agorafood-<nome-da-loja>). O endereço único, em que você escolhe as lojas e o assistente pergunta qual, é só para quem conecta por login — e fica em Meus negócios → Integrações da conta, fora de qualquer loja.

Um token vale por 90 dias e age em seu nome, com as suas permissões. A loja aceita até 5 ativos ao mesmo tempo.

Na ferramenta

Claude Code

Cole o comando do painel no terminal. Ele tem esta forma:

claude mcp add --transport http agorafood-<nome-da-loja> <endereço-da-loja> --header "Authorization: Bearer <token>"

Pronto: no Claude Code, a loja aparece como uma ferramenta chamada agorafood-<nome-da-loja>.

Gemini CLI

Cole o comando do painel no terminal:

gemini mcp add --transport http agorafood-<nome-da-loja> <endereço-da-loja> --header "Authorization: Bearer <token>"

Cursor

Cole o trecho Local — mcp.json do painel no arquivo .cursor/mcp.json do seu projeto:

{
  "mcpServers": {
    "agorafood-<nome-da-loja>": {
      "url": "<endereço-da-loja>",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

VS Code

No projeto, crie (ou edite) o arquivo .vscode/mcp.json com o endereço e o token da loja:

{
  "servers": {
    "agorafood-<nome-da-loja>": {
      "type": "http",
      "url": "<endereço-da-loja>",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

O VS Code mostra o servidor no painel do chat (modo agente); clique em Start se ele não subir sozinho. O nome agorafood-<nome-da-loja> é o que aparece na lista de ferramentas.

LM Studio

No LM Studio, abra a aba Program, clique em Install → Edit mcp.json e cole o trecho Local — mcp.json do painel:

{
  "mcpServers": {
    "agorafood-<nome-da-loja>": {
      "url": "<endereço-da-loja>",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Salve o arquivo: a loja aparece como ferramenta na conversa com o modelo local. O LM Studio pede confirmação antes de cada chamada que grava — é o comportamento dele, e vale manter. Guia oficial: lmstudio.ai/docs/app/mcp.

O token é uma senha

Quem tem o token age na sua loja como você. Não o cole em grupo, em e-mail nem em arquivo compartilhado. Se vazar, revogue no painel — o acesso cai na próxima chamada — e gere outro.

Colocar fotos nos produtos

Aqui o envio funciona sempre — a ferramenta roda na sua máquina, e é ela quem sobe o arquivo:

“Na pasta fotos/ há uma imagem por produto, com o nome do produto no arquivo. Coloque cada uma no produto certo, com um texto alternativo curto.”

A ferramenta lê a pasta, pede um bilhete de envio para cada foto, sobe o arquivo e confirma. Um produto tem uma galeria, na ordem que você pedir; para trocar uma foto, a ferramenta sobe a nova e apaga a antiga. Uma opção de complemento tem uma foto, e a nova substitui a anterior. O recomendado é o mesmo do painel: 4:3 para produto (de 320×240 a 1600×1200), quadrada para opção.

A alternativa, que vale para qualquer cliente: subir as fotos em lote em Cardápio → Fotos e pedir à ferramenta “vincule as fotos em espera” — ela lista o que subiu e grava o vínculo, sem tocar no arquivo. É o caminho dos assistentes na nuvem (claude.ai, ChatGPT, Gemini), onde o envio direto costuma ser bloqueado pela plataforma. Veja assistentes de conversa e Fotos em lote.

Revogar

No painel, em Clientes externos (MCP), clique em Revogar na linha do token. Na ferramenta, remova a conexão (claude mcp remove agorafood-<nome-da-loja>, por exemplo) para ela parar de tentar.