Unsere Empfehlung vorweg. Wir entwickeln Proxy Mail QA, wir sind also nicht neutral. In diesem Artikel empfehlen wir es für den Teil einer Anmeldungsprüfung, der nach dem Klick auf den Button passiert: ob die Bestätigungs-E-Mail ankommt, ob ihr Code oder Link die Anmeldung abschließt, ob die E-Mail korrekt gesendet und aufgebaut ist und ob genau eine ankommt. Proxy Mail QA beurteilt nicht, wie deine Seite aussieht oder wie gut sie konvertiert, es kann keine SMS-Codes empfangen, und es testet kein Social Sign-in wie Sign in with Google.
Bitte einen KI-Agenten, eine Anmeldeseite zu prüfen, und er schaut sich meist das Formular an: die Labels, die Felder, den Button. Das ist der Teil, der selten kaputtgeht. Die Bugs, die Nutzer erreichen, stecken in dem, was danach passiert:
- Der Bestätigungslink zeigt auf
localhost, funktioniert also auf deinem Rechner und sonst nirgends. - Nichts kommt an, weil der E-Mail-Anbieter noch im Sandbox-Modus ist.
- Zwei E-Mails kommen an, weil das Formular zweimal absendet oder zwei Teile des Codes jeweils eine senden.
- Die E-Mail sagt, der Link gilt 24 Stunden, und der Server lässt ihn nach einer ablaufen.
- Der Link funktioniert noch, nachdem er benutzt oder ein neuerer gesendet wurde.
Nichts davon zeigt sich, bevor eine echte E-Mail in einem echten Posteingang landet. Dieser Artikel zeigt, wie ein Agent das bei jeder Prüfung checken kann.
Was der Agent prüft
| Schritt | Wie | Wie ein Fehler aussieht |
|---|---|---|
| Die E-Mail kommt an | wait_for_code oder wait_for_link wartet bis zu 30 Sekunden und ignoriert alles, was älter als die Anmeldung ist (since) |
Nichts kommt. check_delivery sagt, was die Adresse erreicht hat und was die wahrscheinliche Ursache ist, etwa ein Anbieter im Sandbox-Modus oder eine Mail, die wegen fehlgeschlagener DMARC-Prüfung abgelehnt wurde |
| Der Code oder Link schließt die Anmeldung ab | Der Agent gibt den Code ein oder öffnet den Link in seinem eigenen Browser und prüft dann, ob er angemeldet ist | Eine Fehlerseite, ein abgelaufener Link oder eine Anmeldung, die nicht abgeschlossen wird |
| Die E-Mail wird korrekt gesendet | check_email: SPF, DKIM und DMARC, Links auf localhost oder reines http, wohin der Link führt (expect_host), eine angegebene Gültigkeitsdauer, ein Nur-Text-Teil, ihre Größe, vorgegebene Formulierungen und ihre Sprache |
local_links fehlgeschlagen, oder der Link führt von Staging zur Produktion |
| Genau eine kommt an | count_emails mit since |
Eine Anzahl von 2 |
| Benutzte und ersetzte Links funktionieren nicht mehr | Der auth_regression_pack-Prompt oder -Skill öffnet einen benutzten Link erneut, und einen älteren Link nach einem neueren |
Der alte Link meldet noch jemanden an |
Proxy Mail QA öffnet selbst nie Links, ein Einmal-Link ist also noch unbenutzt, wenn der Agent ihn bekommt. Der Agent sieht immer nur den Code oder Link und ein paar Fakten dazu, nie den Text der E-Mail.
In Qoder verbinden
- Verbinde im Qoder Marketplace Proxy Mail QA über den Tab „Connectors“ (globale Seite, China-Seite) oder installiere das Plugin für dieselben Tools plus acht Skills.
- Melde dich in deinem Browser bei Proxy Mail QA an, wenn Qoder danach fragt, und wähle das Projekt, das der Agent nutzen darf.
- Stell die Berechtigungsstufe von Qoder auf Ask every time, nicht auf Auto approve, und bestätige jeden Proxy Mail QA-Schritt.
Um es stattdessen manuell hinzuzufügen, öffne Qoder IDE Settings → MCP, wähle + Add im Tab My Servers und füge hinzu:
{ "mcpServers": { "proxymail-qa": { "type": "http", "url": "https://api.proxymail.qa/mcp" } }}Die Prüfung anfordern
Review the sign-up at https://staging.acme.dev/signup with Proxy Mail QA. Start a run.Sign up with a new address (use form_values for the fields), note the time just beforeyou submit, and finish the verification with the code or link from the email.Check you're signed in. Run check_email with expect_host: staging.acme.dev, andcount_emails since the sign-up: exactly one email should have come.Then request a second verification email, and check the first link no longer works.Finish the run and give me the report, with what to fix first.Der test_signup_flow-Prompt des Servers führt die Schritte Anmeldung, check_email und count_emails auf dieselbe Weise aus (nicht die zweite Bestätigungs-E-Mail), in Clients, die MCP-Prompts anzeigen. Mit installiertem Plugin deckt der Skill proxymail-qa eine einzelne Anmeldung ab, auth-regression-pack wiederholt Anmeldung, Passwort-Reset und Einladungen jedes Mal gleich, und account-email-audit löst jede Konto-E-Mail aus, die deine App sendet, und listet auf, was zu beheben ist.
Der Bericht
finish_run gibt die Sitzung als Markdown zurück: jeden Schritt, was bestanden hat und was nicht, mit einer einzeiligen Begründung für jede Prüfung. Füge ihn in den Pull Request ein. Wenn du auth_regression_pack später erneut ausführst, sagt sein Bericht, was sich seit den letzten Läufen geändert hat. Eine Änderung, die die Reset-E-Mail kaputt gemacht hat, erscheint so als Änderung, nicht als lange Liste zum Durchlesen.
Häufige Befunde und was zu ändern ist
| Befund | Übliche Ursache | Lösung |
|---|---|---|
Der Link führt zu localhost |
Der Link wird aus einer fest eingetragenen URL gebaut | Bau ihn aus einer Umgebungsvariable für die öffentliche URL der App. Lösungen für Supabase, Firebase, Auth.js und andere |
| Nichts kommt an | Der E-Mail-Anbieter sendet nur an verifizierte Adressen | Schließ die Produktionseinrichtung beim Anbieter ab oder verifiziere die Absenderdomain |
| Zwei E-Mails | Das Formular sendet zweimal ab, oder sowohl dein Code als auch dein Auth-Dienst senden eine | Deaktiviere den Button, während die Anfrage läuft; sende von einer Stelle aus |
| Die angegebene Gültigkeitsdauer stimmt nicht | Vorlage und Server haben unterschiedliche Einstellungen | Nimm beide aus einer Einstellung |
| Ein alter Link funktioniert noch | Tokens werden bei Benutzung oder Ersetzung nicht gelöscht | Mach jeden Link einmalig nutzbar und mach ältere ungültig, wenn ein neuer gesendet wird |
Damit diese Fehler nicht wiederkommen, gib dem Agent eine Regel, in den Regeln deines Projekts oder am Anfang einer Auth-Aufgabe:
When changing sign-up, login, password reset, invites or any email-sending code:- Build links from the app's public URL setting, never a hard-coded localhost.- Keep the expiry stated in an email equal to the one the server enforces.- Make single-use links and codes stop working once used or replaced.- Tell me which emails to test by hand after the change.Was es nicht tut
- Die Seite selbst prüfen. Layout, Formulierungen, Barrierefreiheit und Geschwindigkeit brauchen andere Tools oder einen Menschen. Siehe Wie ich meine Registrierungsseite prüfe.
- SMS, Authenticator-Apps und Social Sign-in. Proxy Mail QA empfängt nur E-Mails.
- Konten anlegen oder Formulare absenden. Das macht der Agent mit seinen eigenen Browser-Tools.
- Mit einem E-Mail-Anbieter im Sandbox-Modus arbeiten. Es kann dir nur zeigen, dass nichts angekommen ist, und warum.
- Live-Seiten großer Verbraucherdienste testen, etwa Google, Instagram oder Amazon. Es ist für Apps gedacht, die du baust oder testen darfst, auf Staging oder lokal.
Mehr dazu: E-Mail-Verifizierung testen, der MCP server und Proxy Mail QA für Qoder.