Mail Vet

절차

다섯 단계이며, 에이전트는 각 단계를 일일이 안내받지 않고도 모두 실행합니다.

1. 주소 받기

   한 번의 호출로 일회용 주소를 확보하고 수정 계획을 어떤 언어로 작성할지 에이전트에 알려줍니다. 이 주소는 정확히 한 개의 메시지만 수신하며 한 시간 후 만료됩니다.

2. 실제 메시지 보내기

   요약본도, 축약본도 아닙니다. 검사 중 절반은 발송 플랫폼이 추가한 헤더를 확인하며, 붙여 넣은 본문에는 그러한 헤더가 하나도 없습니다.

3. 대기

   한 번의 블로킹 호출입니다. 분석이 완료되면 반환되므로 에이전트가 폴링할 필요가 없고 잘못 구현할 수 있는 대기 루프도 없습니다.

4. 지적된 항목 수정

   각 발견 사항에는 근거가 되는 RFC 섹션과 Google 문서 페이지가 함께 제공되므로, 에이전트는 이를 신뢰하기만 하는 대신 주장을 확인할 수 있습니다.

5. 다시 전송

   새 주소, 수정된 메시지, 첫 번째 점수와 비교할 두 번째 점수입니다. 예상 개선치는 재채점으로 계산되지만 합산할 수 없으며, 두 번째 보고서의 점수가 실제 수치입니다.

연결

MCP 서버는 Claude Code에서 한 줄이면 됩니다:

claude mcp add --transport http email-spam-tester https://email-spam-tester.com/mcp

또는 JSON을 받는 클라이언트의 경우:

{
  "mcpServers": {
    "email-spam-tester": {
      "type": "http",
      "url": "https://email-spam-tester.com/mcp"
    }
  }
}

다음 네 가지 도구가 함께 제공됩니다: 주소 예약, 보고서 대기, 슬러그로 기존 보고서 읽기, 전달된 그대로 메시지 원본 가져오기.

스킬 파일

MCP는 에이전트에 도구를 제공합니다. 이 파일은 에이전트에 판단 기준을 제공합니다: 언제 도구를 사용해야 하는지, skip 상태와 pass 상태를 어떻게 해석해야 하는지, 어떤 발견 사항이 에이전트가 편집할 수 있는 텍스트가 아니라 사용자가 변경해야 하는 DNS 레코드인지. 이 파일을 추가하면 에이전트가 더 이상 묻지 않습니다.

.claude/skills/mail-vet/SKILL.md로 저장하거나, 클라이언트에서 같은 용도로 사용하는 위치에 붙여 넣으세요.

에이전트 없이

키 없이 두 번 요청합니다. 첫 번째 요청은 주소를 예약하고, 두 번째 요청은 보고서를 읽습니다: 아직 아무것도 도착하지 않았으면 202, 도착한 뒤에는 모든 내용과 함께 200을 반환합니다.

# reserve a single-use address
curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en&utm_source=agent'
# {"address":"test-<slug>@email-spam-tester.com","slug":"<slug>",...}

# send the message there, then read it back
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'
# 202 while nothing has arrived, 200 with the report once it has

응답에는 사람이 읽을 수 있는 페이지인 report_url이 포함됩니다. JSON 덩어리 대신 이를 전달하세요.

보고서 읽기

두 개의 수치이며, 같은 항목에 대한 두 가지 의견이 아닙니다.

검사는 통과, 경고, 실패, 건너뜀 또는 오류 상태가 됩니다. 건너뜀은 통과가 아닙니다. 검사할 첨부 파일이 없거나 평가할 HTML 부분이 없어 해당 검사가 적용되지 않았다는 뜻입니다. 오류는 확인할 수 없었다는 뜻이며, 확인한 것처럼 점수를 매기기보다 이를 명시하는 것이 중요합니다.

초안으로 해결할 수 없는 항목

일부 결과는 콘텐츠가 아니라 DNS와 관련되므로, 에이전트는 점수가 바뀔 때까지 메시지를 수정하는 대신 이를 명확히 밝혀야 합니다:

• SPF, DKIM 및 DMARC 레코드와 해당 레코드가 From 도메인과 정렬되는지 여부
• 발신 IP의 역방향 DNS와 정방향 확인 여부
• MX 레코드, 발신 호스트의 TLS 및 차단 목록 등재 여부
• MTA-STS, TLS 보고, DNSSEC 및 BIMI

나머지는 모두 초안입니다: 제목, 프리헤더, HTML 용량, 텍스트 파트, 이미지 대체 텍스트, 링크 단축 서비스, 구독 취소 헤더.

가르칠 만한 네 가지 습관