
Qual o jeito mais simples de colocar login num app que eu fiz com IA
Login sem senha num app React feito com Claude Code, Cursor ou outro agente: um endereço de documentação para o agente ler, uma chave pública e o código de 8 caracteres no e-mail.
Nesta página · 8 seções
Você pediu um app ao Claude Code, ao Cursor ou a outro agente, e ele funciona. Agora precisa de login, e a primeira resposta do agente costuma ser montar tudo do zero: tabela de usuários, hash de senha, e-mail de confirmação, tela de "esqueci a senha". São muitas peças, e cada uma é um lugar onde um app feito às pressas deixa uma porta aberta. O jeito mais simples é não construir nenhuma delas: usar um serviço de login que o agente consiga integrar sozinho, lendo uma documentação feita para ele.
Por que login sem senha é o mais simples
Quase todo o trabalho de um login tradicional existe por causa da senha. Ela precisa ser guardada com hash, ter regra de tamanho e ser recuperável quando a pessoa esquece. E vira alvo de vazamento, ataque de força bruta e reaproveitamento de senha de outro site.
O Auth tira a senha do caminho. A pessoa entra de três jeitos:
Código no e-mail. Ela digita o e-mail, recebe um código de 8 caracteres e cola na tela. O e-mail traz um código, não um link, então não há endereço de retorno para configurar nem callback para alguém sequestrar.
Google. Quando o dono da aplicação liga as credenciais dele no painel.
Apple. Da mesma forma, com as credenciais do dono.
A conta nasce no primeiro código, já verificada. Não existe cadastro separado, link mágico, recuperação de senha nem verificação de e-mail à parte, porque não há senha para recuperar. Para o agente, isso significa menos tela para escrever e menos coisa para errar.
O caminho com o agente
1. Dar ao agente a documentação certa
O Auth tem um único arquivo com tudo o que um desenvolvedor ou um agente precisa: https://myinfrastructure.click/products/auth/llms.txt. Ele começa por um passo a passo de login num app React e tem uma seção do que não existe, que impede o agente de inventar funções como signUp ou forgotPassword.
Cole o endereço na conversa e peça a integração. Um agente que lê o arquivo antes de escrever código acerta os nomes do pacote e das rotas na primeira tentativa.
2. A chave pública
O frontend precisa de uma chave pública, que começa com pu_. Ela pode ir no bundle; não é segredo. Você a encontra no painel do Auth, em Chaves de API da aplicação, e ela vai no .env:
VITE_AUTH_PUBLIC_KEY=pu_...
Se você ainda não tem conta, o agente consegue criar conta, aplicação e chaves sozinho, pela mesma entrada por código que o usuário final usa. O único passo humano é ler o código no seu e-mail e informar a ele.
Se o app tem backend próprio, ele usa outra chave, a secreta, que começa com ak_ e fica só no servidor, numa variável de ambiente. Peça as duas de uma vez quando a integração tiver as duas pontas.
3. O que o agente escreve
Num app React com Vite, o agente:
Instala
@ciromaciel/auth-reacte as dependências de interface que o pacote usa.Envolve o app com
AuthProvider, passando a chave pública.Cria a rota
/auth/signincom o componenteSignIn.Protege as rotas logadas com
Protect, sempre comredirectTo="/auth/signin". O padrão do componente aponta para/login, que não existe, e esse é o erro mais comum.Opcionalmente, põe a página de perfil com
UserProfile.
No localhost, o primeiro login funciona sem liberar origem nenhuma. Em produção, o Auth aprende a origem da aplicação no primeiro acesso vindo de um domínio de verdade, ou você a define no painel. Endereços de preview, como *.vercel.app ou *.pages.dev, autenticam normalmente, mas nunca viram a origem oficial.
Quando o caminho é outro
Next.js sem React Router. Os componentes usam o React Router por dentro, então um projeto Next puro não os usa. Nesse caso, o agente integra pela API HTTP, que faz o mesmo fluxo de código por e-mail, ou monta a parte logada como app React com Vite.
Você quer senha. O Auth não tem senha nenhuma, por escolha. Se a senha for requisito do seu público, procure um serviço que a ofereça.
Permissões finas por usuário. O login entrega a identidade da pessoa, isolada por aplicação. Organizações e papéis existem no painel administrativo do Auth, mas não chegam ao app pelo SDK nem pelo token; a regra de quem pode o quê fica no seu app.
Administrar os usuários pelo agente
Depois que o login está no ar, o Auth tem um servidor MCP para administrar a aplicação: listar usuários, ver estatísticas, revogar sessões. O agente conecta pelo endereço da aplicação e você aprova no navegador, sem chave. Vale lembrar a diferença: o MCP administra, e o SDK é o que coloca o login dentro do app.
Perguntas frequentes
Por que o e-mail traz um código e não um link?
Um link precisaria de um endereço de retorno, e esse endereço é justamente o que um atacante tenta trocar. Com o código, não há destino para gravar nem callback para sequestrar. O único passo humano que sobra é ler o código, e é ele que prova que quem pediu o acesso alcança aquela caixa de e-mail.
Preciso escrever a tela de login?
Não. O componente SignIn já é a tela inteira, com o campo de e-mail, o campo de código e os botões de Google e Apple quando estão ligados. Dá para ajustar a cor ao tema do seu app.
O que acontece se a pessoa usar outro e-mail?
Nasce outra conta. A identidade é o e-mail: quem entra com o mesmo e-mail pelo código ou pelo Google cai na mesma conta.
Funciona com o Claude Code, o Cursor e o Codex?
Sim. A integração é código comum num projeto React, e qualquer agente que leia a documentação faz o mesmo caminho.
Para continuar lendo
Login sem senha com código no e-mail: como funciona e quando usar
Como um agente de IA faz login no seu app: OAuth 2.1 e o passo humano
Login sem construir login
O Auth dá ao seu app login sem senha, com código no e-mail, Google e Apple, e uma documentação que o agente lê inteira antes de integrar. Conhecer o Auth
Fontes
Quem escreveu
Continue lendo
Como um agente de IA faz login no seu app: OAuth 2.1 e o passo humanoMais sobre Auth · · 5 min
Login sem senha com código no e-mail: como funciona e quando usarMais sobre Auth · · 6 min
Como cobrar assinatura num app feito com IA e liberar acesso só para quem pagouAssunto parecido · · 5 min
Como mandar e-mail de confirmação e de senha pelo meu app sem configurar servidor de e-mailAssunto parecido · · 5 min
Como receber um aviso quando o meu site sair do ar, de graçaMais recente · · 5 min
Como publicar um site feito com o Claude Code sem configurar servidorMais recente · · 5 min