Tester les e-mails d'authentification des applications que vous créez avec Claude Code

La place de l’e-mail dans un workflow Claude Code

Claude Code est l’agent de codage de Anthropic. Il fonctionne dans votre terminal, votre éditeur et le navigateur, lit votre base de code et la modifie dans son ensemble. Demandez « une inscription par e-mail et mot de passe avec vérification » et vous obtiendrez les formulaires, les appels API et les modèles, reliés à ce que vous utilisez : Supabase Auth, Clerk, Auth.js, Firebase ou votre propre backend.

Ce qu’il ne peut pas faire facilement, c’est recevoir l’e-mail. Les tests unitaires simulent l’expéditeur et les tests de bout en bout sautent souvent la vérification. Le premier vrai e-mail de confirmation est donc souvent envoyé au premier vrai utilisateur.

Quelle connexion va-t-il créer ?

Celle que vous demandez. La plupart des applications finissent sur Supabase Auth, Clerk, Firebase Authentication, Auth.js ou Better Auth, et chacun envoie des e-mails différents : Clerk envoie un code par défaut, Firebase un lien, et Auth.js uniquement des liens magiques sauf si vous construisez le reste. Indiquez à Claude Code les méthodes voulues, par exemple « e-mail et mot de passe avec un code de confirmation, plus Google », puis testez chaque e-mail qu’il envoie. Les e-mails envoyés par chaque service de connexion.

Une vérification de bout en bout en cinq minutes

1. Créez une adresse dans Proxy Mail QA. Créez-en plusieurs à la fois si vous en voulez une par scénario, comme nouvel utilisateur, utilisateur invité et réinitialisation.
2. Lancez votre application (npm run dev ou équivalent) et inscrivez-vous avec l’adresse.
3. Regardez arriver le code ou le lien. Il apparaît sur la ligne de l’adresse en quelques secondes, avec un bouton Copy pour un code ou des boutons Open link et Copy link pour un lien.
4. Terminez le parcours. Collez le code dans votre application ou cliquez sur le lien. Si le lien pointe vers localhost:3000, nous le signalons. C’est normal tant que vous développez en local : choisissez This is my dev environment et il ne sera plus signalé dans ce projet.
5. Recommencez en préproduction avant de livrer. Là, un lien localhost est un vrai bug, et le plus courant dans le code d’authentification généré. Voici comment le corriger.

Laissez Claude Code vérifier l’e-mail lui-même

Le plugin Proxy Mail QA ajoute le MCP server et huit skills qui guident Claude Code tout au long de la tâche, du test complet d’une inscription à la recherche de la raison pour laquelle un e-mail n’est pas arrivé. Dans Claude Code, exécutez ces deux commandes, l’une après l’autre :

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

Tapez ensuite /mcp, choisissez proxymail-qa puis Authenticate. Votre navigateur s’ouvre pour vous connecter à Proxy Mail QA et choisir le projet que Claude Code peut utiliser, sans clé d’API à copier. Pour le MCP server seul, exécutez plutôt claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp dans un terminal et authentifiez-vous de la même façon ; pour utiliser une clé d’API, consultez Configuration de MCP server.

Demandez ensuite en langage courant : « Inscris-toi sur localhost:3000 avec une nouvelle adresse Proxy Mail QA et confirme l’e-mail. » Claude Code crée l’adresse, remplit votre formulaire, attend le code ou le lien et termine l’inscription. Il ne reçoit que le code ou le lien, jamais le texte de l’e-mail.

Donnez les preuves à Claude Code

Quand quelque chose cloche, collez ce que vous avez vu directement dans votre session. Le précis vaut mieux que le vague :

• « L’e-mail de confirmation en staging pointe vers http://localhost:3000/auth/confirm. Construis l’URL de redirection à partir d’une variable d’environnement et définis-la pour chaque environnement. »
• « L’e-mail de réinitialisation indique que le lien dure 60 minutes, mais il ne fonctionne plus après 5. Trouve où l’expiration est définie. »
• « Deux e-mails de vérification arrivent pour une seule inscription. Trouve l’envoi en double. »

La vue de la boîte de réception affiche l’expéditeur, l’objet, le contenu complet et tous les liens de chaque e-mail, ce qui suffit généralement à l’agent.

Avant une version, demandez l’inventaire de tout ce que l’application envoie :

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.

Conseils

• Étiquetez vos exécutions. Les e-mails envoyés à k3f9q2m8x7aa+run2@mailclub.dev arrivent dans la même boîte de réception avec l’étiquette run2 affichée, ce qui permet de distinguer les exécutions répétées.
• Gardez le mot de passe avec le compte. Enregistrez sur l’adresse le mot de passe utilisé à l’inscription, ou utilisez Générer un mot de passe de test pour en obtenir un conforme aux règles courantes.
• Regroupez par projet. Un projet par application que vous développez, avec son URL de staging associée et un préfixe facultatif pour repérer facilement ses adresses.