Probar los correos de autenticación en apps que creas con Claude Code

Dónde encaja el correo en un flujo de trabajo con Claude Code

Claude Code es el agente de programación de Anthropic. Funciona en tu terminal, tu editor y el navegador, lee tu código y hace cambios en todo él. Pide “registro con correo y contraseña con verificación” y obtendrás los formularios, las llamadas de API y las plantillas, conectados a lo que uses: Supabase Auth, Clerk, Auth.js, Firebase o tu propio backend.

Lo que no puede hacer fácilmente es recibir el correo. Las pruebas unitarias simulan el remitente y las pruebas de extremo a extremo suelen omitir la verificación. Así que el primer correo de confirmación real a menudo se envía al primer usuario real.

¿Qué inicio de sesión creará?

El que pidas. La mayoría de las apps terminan usando Supabase Auth, Clerk, Firebase Authentication, Auth.js o Better Auth, y cada uno envía correos distintos: Clerk envía un código por defecto, Firebase un enlace y Auth.js solo enlaces mágicos, a menos que construyas el resto. Dile a Claude Code los métodos que quieres, como “correo y contraseña con un código de confirmación, más Google”, y luego prueba cada correo que envíe. Qué correos envía cada servicio de inicio de sesión.

Una comprobación de extremo a extremo en cinco minutos

1. Crea una dirección en Proxy Mail QA. Crea varias a la vez si quieres una por escenario, como usuario nuevo, usuario invitado y restablecimiento.
2. Ejecuta tu app (npm run dev o similar) y regístrate con la dirección.
3. Mira llegar el código o el enlace. Aparece en la fila de la dirección en segundos, con un botón Copiar para un código o botones Abrir enlace y Copiar enlace para un enlace.
4. Termina el flujo. Pega el código en tu app o haz clic en el enlace. Si el enlace apunta a localhost:3000, lo marcamos. Es lo esperado mientras desarrollas en local: elige Este es mi entorno de desarrollo y no se volverá a marcar en ese proyecto.
5. Repite en staging antes de publicar. Ahí un enlace a localhost es un error real, y el más común en el código de autenticación generado. Así se corrige.

Deja que Claude Code revise el correo por sí mismo

El plugin de Proxy Mail QA añade el MCP server y ocho skills que guían a Claude Code en el trabajo, desde probar un registro de principio a fin hasta averiguar por qué no llegó un correo. En Claude Code, ejecuta estos dos comandos, uno a la vez:

/plugin marketplace add aaquib90/proxymail-qa-plugin
/plugin install proxymail-qa@proxymail-qa

Luego escribe /mcp, elige proxymail-qa y Authenticate. Tu navegador se abre para iniciar sesión en Proxy Mail QA y elegir el proyecto que Claude Code puede usar, sin ninguna clave de API que copiar. Para usar solo el MCP server, ejecuta claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp en una terminal y autentícate de la misma forma; para usar una clave de API, consulta la configuración de MCP server.

Luego pídelo con palabras sencillas: “Regístrate en localhost:3000 con una nueva dirección de Proxy Mail QA y confirma el correo”. Claude Code crea la dirección, completa tu formulario, espera el código o enlace y termina el registro. Solo recibe el código o enlace, nunca el texto del correo.

Dale las pruebas a Claude Code

Cuando algo no está bien, pega lo que viste directamente en tu sesión. Lo específico es mejor que lo vago:

• “El correo de confirmación en staging enlaza a http://localhost:3000/auth/confirm. Construye la URL de redirección a partir de una variable de entorno y configúrala para cada entorno”.
• “El correo de restablecimiento dice que el enlace dura 60 minutos, pero deja de funcionar a los 5. Encuentra dónde se define la caducidad”.
• “Llegan dos correos de verificación por un solo registro. Encuentra el envío duplicado”.

La vista de la bandeja de entrada muestra el remitente, el asunto, el contenido completo y todos los enlaces de cada correo, que suele ser todo lo que el agente necesita.

Antes de una versión, pide un inventario de todo lo que envía la app:

List every email this app sends: sign-up confirmation, magic link, password reset, invite and email change. For each, tell me what triggers it, which URL its link points to, and how long its link or code stays valid. Flag anything that uses localhost.

Consejos

• Etiqueta tus ejecuciones. El correo a k3f9q2m8x7aa+run2@mailclub.dev llega a la misma bandeja de entrada con la etiqueta run2 visible, así las ejecuciones repetidas se distinguen.
• Guarda la contraseña con la cuenta. Guarda en la dirección la contraseña con la que te registraste, o usa Generar una contraseña de prueba para obtener una que cumpla las reglas habituales.
• Agrupa por proyecto. Un proyecto por cada app que construyes, con su URL de staging vinculada y un prefijo opcional para reconocer fácilmente sus direcciones.