MailFixture

MailFixture란 무엇인가요?

MailFixture는 CI 환경에 특화된 수신 전용 이메일 테스트 서비스입니다. 단 한 번의 API 호출로 실제 테스트 받은 편지함을 제공하여, 애플리케이션이 실제 이메일(OTP, 매직 링크, 인증 코드)을 보내면 테스트 스위트가 이를 파싱하고 유형화하여 검증할 준비가 된 상태로 수신합니다. 가짜 메일 서버나 차단 목록에 오르는 일회용 받은 편지함으로 씨름하는 대신, MailFixture는 실제처럼 동작하는 진짜 받은 편지함을 테스트에 제공하며, 일반적으로 1초 이내에 전달됩니다.

대상 사용자

• CI/CD 엔지니어 — 로컬에서는 통과하지만 타이밍 문제나 공유 테스트 도메인 때문에 파이프라인에서 실패하는 불안정한 이메일 테스트에 지친 분.
• QA 자동화 팀 — Playwright, Cypress, pytest 또는 Selenium을 사용하며, 취약한 정규식 파서를 작성하지 않고 결정적인 OTP 및 링크 추출이 필요한 분.
• AI 에이전트 개발자 — LLM 기반 도구가 MCP를 통해 자율적으로 받은 편지함을 생성하고, 가입 흐름을 트리거하며, 인증 코드를 읽어오길 원하는 분.

주요 기능

내장된 롱 폴링

waitForMessage()는 이메일이 도착할 때까지 연결을 유지합니다—일반적으로 앱이 이메일을 보낸 후 1초 이내입니다. sleep(5000)도, 500ms마다 폴링 루프도, "로컬에선 괜찮은데 CI에선 불안정"이라는 변명도 필요 없습니다. API가 당신을 기다립니다, 그 반대가 아니라.

최고 수준의 추출

모든 메시지는 사전 파싱된 상태로 도착합니다. 일회용 코드, 매직 링크, 인증 링크는 분류되어 extracted 필드에 있으며, SPF/DKIM/DMARC 판정 및 SpamAssassin 스팸 점수와 함께 제공됩니다. 검증은 한 줄이면 충분하며, 마케팅 팀이 이메일 템플릿을 재설계해도 깨지지 않습니다.

사용자 정의 도메인

MX 레코드 하나를 MailFixture에 지정하면 모든 픽스처가 tests.yourdomain.com에 위치합니다. 도메인이 당신의 것이므로, 공유 테스트 메일 도메인을 괴롭히는 "일회용 이메일 감지" 문제로 당신의 가입 양식에서 차단되지 않습니다.

대시보드 및 MCP 지원

대시보드에서 받은 편지함이 실시간으로 채워지는 것을 볼 수 있으며, 렌더링된 HTML, 일반 텍스트, 헤더, 원본 소스가 표시됩니다—추출된 OTP는 클릭 한 번으로 클립보드에 복사됩니다. MailFixture는 원격 MCP 서버로도 작동하므로, AI 에이전트가 받은 편지함을 생성하고 OTP를 자율적으로 읽을 수 있습니다.

차별화 포인트

"전달 → 파싱 → 검증."

이것이 여섯 단어로 표현된 전체 약속입니다. 대부분의 이메일 테스트 도구는 전달에서 멈춥니다—원시 메시지를 넘겨주고 파싱 및 검증 로직을 직접 구축하길 기대합니다. MailFixture는 OTP와 인증 링크를 정규식 숙제가 아닌 최고 수준의 필드로 취급하여 더 나아갑니다. 재시도 루프를 제거하는 롱 폴링과 차단 목록 문제를 피하는 사용자 정의 도메인과 결합하여, 이메일 테스트 불안정성의 세 가지 주요 원인을 한 번에 제거합니다.

확인해 볼 가치가 있다면…

이메일 전달에 의존하는 엔드투엔드 테스트를 구축 중이고 waitForTimeout(5000)이 충분하지 않은 이유를 디버깅하는 데 지쳤다면. 팀이 OTP 테스트가 로컬에서는 통과했지만 CI에서 실패하여 손상된 가입 흐름을 배포한 적이 있다면, MailFixture의 접근 방식을 살펴볼 가치가 있습니다. 무료 티어는 신용 카드 없이 월 100개의 메시지를 포함하며, 유료 플랜은 좌석당 요금 없이 월 $15부터 시작합니다—사람이 아닌 메시지에 대해 비용을 지불합니다. 또한 자체 가입 흐름을 엔드투엔드로 검증해야 하는 AI 에이전트를 실험 중이라면 훌륭한 선택입니다.