Para equipe ilarika
Super Admin › Conectar IA: o Claude (ou outra IA) no Super Admin
- Super AdminConectar IA
- Tela "… quer acessar o Super Admin" (aberta pela IA)
Quem é do Time iLarika pode ligar a própria IA (Claude, ChatGPT, Claude Code…) ao Super Admin. A IA consulta e age como no painel: lojas, planos, assinaturas, afiliados, suporte, entregadores, aplicativos e o resto. Ela age com o seu acesso: só aparecem as ferramentas das áreas que você vê, no nível que você tem (veja Time iLarika). Tudo fica registrado em seu nome.
É outro conector, separado do das lojas. Uma IA ligada a uma loja não abre o Super Admin, e a do Super Admin não abre loja nenhuma pelo conector da loja.
Conectar
- Super Admin › Conectar IA: toque em Copiar no Endereço do
conector. Ele termina em
/mcp/plataforma. - Na sua IA, adicione um conector personalizado com esse endereço:
- Claude: Configurações → Conectores → Adicionar conector personalizado → cole o endereço.
- ChatGPT (planos pagos): Configurações → Apps → Avançado → modo desenvolvedor → Criar → cole o endereço, autenticação OAuth.
- Claude Code: no terminal,
claude mcp add --transport http ilarika-super-admin <endereço>. Depois,/mcppara autorizar.
- A IA abre a tela “… quer acessar o Super Admin”. Se pedir, entre no Super Admin como de costume.
- Confira o nome da IA e o seu acesso, digite o código do autenticador de agora (o mesmo do login) e toque em Autorizar. A tela volta para a IA, e pronto.
O código é pedido de novo aqui, mesmo com você já logado, porque a conexão dura dias. Uma sessão do navegador esquecida aberta não basta para conectar uma IA.
Só conectam o Claude, o ChatGPT e IAs que rodam no próprio computador (como o Claude Code). Um link de “conectar” que outra pessoa mande, voltando para outro endereço, é recusado antes de pedir o código.
IA que roda em outro lugar (uma sessão na nuvem)
Algumas IAs não estão no seu navegador nem no seu computador, como uma sessão do Claude rodando na nuvem. Elas não recebem a volta da tela de autorização. Nesse caso, a IA conecta por link:
- A IA manda o link na conversa.
- Você abre o link. Ele pede o login do Super Admin, se for preciso, e mostra “… quer acessar o Super Admin”.
- Digite o código do autenticador e toque em Autorizar.
- A tela diz “Pronto, conectada”. Pode fechar e voltar para a conversa: a IA já está conectada, sem copiar nada.
O link vale 10 minutos e uma vez. Só autorize se foi você que acabou de pedir: ninguém da iLarika manda um link destes. Se você não pediu, toque em Recusar.
O que a IA faz, e o que pede o seu código
A IA vê uma ferramenta para cada ação do Super Admin que o seu acesso alcança. Quem só vê uma área tem as consultas dela; quem vê e muda, as ações também. Se a IA tentar algo fora do seu acesso, a resposta diz o que falta. O servidor confere de novo em toda ação, como no painel.
As ações perigosas pedem o código do autenticador, uma a uma:
- apagar ou limpar uma loja, e abrir o acesso assistido numa loja;
- adicionar ou mudar alguém do Time iLarika;
- trocar ou remover as chaves do Asaas, do Pagar.me e do Mercado Pago;
- o que mexe com dinheiro: marcar fatura paga, anular, cobrar, reembolsar, conceder dias, trocar o plano de uma assinatura, ligar a cobrança automática, rodar a régua, criar ou mudar produtos, preços e cupons;
- aprovar comissões e gerar ou pagar lotes de afiliados;
- emitir ou cancelar nota fiscal, ligar a nota fiscal automática e o Pix Automático;
- provedores, créditos e chaves de IA, e fechar o excedente de IA do mês;
- chaves de recursos (feature flags);
- criar uma loja, adicionar alguém ou trocar a senha de alguém numa loja;
- publicar os documentos jurídicos, mudar a versão mínima dos apps e desconectar o WhatsApp do suporte.
Nesses casos, a IA primeiro conta o que vai fazer e pede o código. Você confere, abre o autenticador e passa os 6 dígitos de agora. Cada código vale uma vez: para outra ação, espere o próximo (eles mudam a cada 30 segundos).
Ficam de fora da IA: entrar e renovar a sessão, o próprio conector (autorizar e desconectar), e o que é arquivo (planilha de comissões, foto de documento de entregador, anexo de chamado). Esses continuam só na tela.
Dentro de uma loja
Com a área Entrar na loja, a IA também consulta e age dentro de uma loja da rede: pedidos, cardápio, conversas, caixa, equipe e o resto do painel da loja. São as mesmas ferramentas do conector da loja, usadas como o dono dela, o mesmo que o acesso assistido faz no painel.
- Ver dá as consultas; ver e mudar dá as ações também.
- Toda chamada leva um motivo (ex.: “chamado 123: a loja pediu para pausar a pizza”). Ele vai para a auditoria da loja, com quem do Time agiu e por qual IA.
- As ações grandes da loja pedem o seu código do autenticador: apagar, mexer em muita coisa de uma vez e o que é só do dono. O código de confirmação do dono não entra: o dono não é incomodado.
- Ficam de fora a chave do Mercado Pago, as senhas e o que o dono digita na tela dele. Para isso, use o acesso assistido no painel.
- Os interruptores de IA / MCP (desligar o acesso por IA, só leitura) valem aqui também.
Peça em palavras, como “veja os pedidos de hoje da BomBar” ou “pausa a pizza
de calabresa na Pizza Code, a pedido do dono no chamado 45”. A IA acha a
ferramenta (listar_ferramentas_da_loja) e usa (usar_ferramenta_da_loja).
O registro
- Conectar IA › O que a IA fez: as últimas consultas e ações, com o resultado (feito, negado, erro, pediu o código) e os dados com segredo mascarado. O código do autenticador nunca é guardado.
- Auditoria: cada ação feita pela IA entra em seu nome, com o nome da IA e da ferramenta. A ação em si também registra o de sempre (ex.: “loja apagada”). Dentro de uma loja, entra também cada consulta, com o motivo, na auditoria daquela loja.
- Chamados, nomes e mensagens de lojistas, clientes e entregadores vão para a IA marcados como dado, não como instrução.
Desconectar
- Conectar IA › IAs conectadas › Desconectar corta na hora. Cada pessoa vê e desconecta as próprias; o superadmin vê e desconecta as de todo o Time.
- A conexão cai sozinha quando o superadmin dá uma senha temporária nova, usa Trocar autenticador ou desativa a pessoa (ver Time iLarika). Também cai depois de 14 dias sem uso: aí é só autorizar de novo.
- O endereço do conector fica no endereço público da API, fora do login do Cloudflare que protege o Super Admin, porque os servidores da IA chamam direto. Ele só responde com o token que o Super Admin emite (Cloudflare, senha e autenticador), e um token de loja não abre o Super Admin.
Se der errado
- “O seu acesso no Super Admin não inclui mudar Planos e recursos”: a ação é de uma área que você só vê, ou nem vê. Peça ao superadmin em Time iLarika.
- “Código 2FA já usado; aguarde o próximo”: aquele código já valeu (no login ou noutra ação). Passe o próximo.
- “Código 2FA inválido ou expirado”: confira a hora do celular e passe o código que está na tela agora.
- “Este pedido é do conector das lojas, não do Super Admin”: a IA foi
ligada com o endereço das lojas. Use o que termina em
/mcp/plataforma. - “Token inválido ou vencido” na IA: a conexão caiu (desconectada, senha ou autenticador trocados). Conecte de novo.
- “Só o Claude, o ChatGPT e IAs no próprio computador conectam ao Super Admin”: o pedido volta para um endereço que não é de uma IA conhecida. Não autorize; se foi você, conecte pelo Claude ou pelo ChatGPT.
