MCP Server

Model Context Protocol (MCP)은 AI 모델이 외부 도구 및 데이터 소스와 안전하게 상호작용할 수 있게 하는 Anthropic의 오픈 프로토콜입니다. MCP를 통해 Claude가 자연어를 사용하여 직접 이메일을 검증하도록 할 수 있습니다.

MCP란?

MCP는 AI 모델이 다음을 수행할 수 있게 합니다:

• 외부 도구 및 API 호출
• 로컬 파일 및 데이터 접근
• 특정 작업 실행

EmailVerify의 경우: 사용자는 수동으로 API를 호출하지 않고 자연어를 사용하여 이메일을 검증할 수 있습니다.

지원되는 클라이언트

빠른 설정

1단계: API 키 받기

EmailVerify 대시보드를 방문하여 API 키를 생성하세요.

2단계: Claude Desktop 설정

설정 파일을 편집하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

3단계: Claude Desktop 재시작

재시작 후 간단히 말하세요:

"john@company.com이 유효한 이메일인지 확인해줘"

Claude Code 설정

Claude Code의 경우 설정에 MCP 서버를 추가하세요:

claude mcp add emailverify -- npx -y @emailverify/mcp-server

또는 ~/.claude/claude_code_config.json에 추가하세요:

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor 설정

Cursor에서 Settings > MCP로 이동하여 추가하세요:

{
  "emailverify": {
    "command": "npx",
    "args": ["-y", "@emailverify/mcp-server"],
    "env": {
      "EMAILVERIFY_API_KEY": "your-api-key-here"
    }
  }
}

사용 가능한 도구

verify_email

단일 이메일 주소를 검증합니다.

매개변수:

반환값:

• 이메일 상태 (valid/invalid/unknown)
• 전달 가능성
• 일회용 이메일 여부
• 역할 기반 이메일 여부
• 신뢰도 점수

Claude에서의 사용 예:

"test@example.com이 유효한 이메일인지 확인해줘"

verify_emails_bulk

여러 이메일 주소를 한 번에 검증합니다.

매개변수:

반환값:

• job_id: 작업 식별자
• status: 처리 상태
• total: 총 개수
• processed: 처리된 개수

Claude에서의 사용 예:

"이 이메일들을 검증해줘: user1@example.com, user2@test.com, info@company.com"

check_credits

계정 잔액 및 속도 제한을 확인합니다.

매개변수: 없음

반환값:

• 남은 크레딧
• 속도 제한 정보
• 플랜 세부 정보

Claude에서의 사용 예:

"검증 크레딧이 얼마나 남았나요?"

사용 예제

기본 검증

사용자:

john@google.com을 검증해줘

Claude:

그 이메일 주소를 검증해드리겠습니다.

이메일 검증 결과

필드	값
이메일	john@google.com
상태	유효
전달 가능	예
일회용	아니요
점수	0.95

이 이메일은 유효하고 전달 가능합니다.

여러 이메일 검증

사용자:

이 이메일들을 확인해줘: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

세 개의 이메일 주소를 모두 검증하겠습니다.

이메일	상태	참고
john@google.com	유효	전달 가능, 기업 이메일
test@mailinator.com	유효하지 않음	일회용 이메일, 거부 권장
support@microsoft.com	유효	역할 기반 주소, 공유될 수 있음

권장사항:

• john@google.com - 사용해도 안전
• test@mailinator.com - 임시 이메일, 권장하지 않음
• support@microsoft.com - 유효하지만 팀 수신함일 가능성 있음

개발자 워크플로우

사용자 (Claude Code에서):

.env.example 파일의 테스트 이메일들을 검증해줘

Claude:

파일을 읽고 발견된 이메일 주소들을 검증하겠습니다.

.env.example에서 3개의 이메일 주소를 찾았습니다:

• TEST_EMAIL=user@example.com
• ADMIN_EMAIL=admin@company.com
• SUPPORT_EMAIL=help@temp-mail.org

검증 결과:

이메일	상태
user@example.com	알 수 없음 (예제 도메인)
admin@company.com	유효
help@temp-mail.org	유효하지 않음 (일회용)

테스트용으로 실제 이메일 주소 사용을 권장합니다.

출력 형식

MCP 서버는 잘 포맷된 결과를 반환합니다:

## 이메일 검증 결과

**이메일:** test@example.com
**상태:** 유효
**신뢰도 점수:** 95.0%

### 세부 정보
| 확인 항목 | 결과 |
|-----------|------|
| 전달 가능 | 예 |
| 유효한 형식 | 예 |
| 유효한 도메인 | 예 |
| 유효한 MX | 예 |
| 일회용 | 아니요 |
| 역할 주소 | 아니요 |
| Catch-all | 아니요 |
| 무료 제공자 | 아니요 |

**사용된 크레딧:** 1

모범 사례

1. API 키 안전하게 저장

API 키를 하드코딩하지 마세요. 환경 변수를 사용하세요:

{
  "env": {
    "EMAILVERIFY_API_KEY": "${EMAILVERIFY_API_KEY}"
  }
}

2. 자연어 사용

MCP 서버는 다양한 표현을 이해합니다:

• "user@example.com 검증해줘"
• "test@company.com이 유효한 이메일인가요?"
• "이 이메일이 전달 가능한지 확인해줘: john@test.com"
• "이 이메일 주소들을 검증해줄 수 있나요?"

3. 가능하면 일괄 처리

여러 이메일의 경우 Claude에 함께 검증하도록 요청하세요:

"이 이메일들을 한 번에 검증해줘: email1@test.com, email2@test.com, email3@test.com"

문제 해결

MCP 서버를 찾을 수 없음

Claude가 EmailVerify 도구를 찾을 수 없다고 하면:

1. 설정 파일 경로 확인
2. JSON이 유효한지 확인
3. Claude Desktop을 완전히 재시작
4. API 키가 올바른지 확인

속도 제한 오류

속도 제한 오류가 표시되면:

1. "크레딧이 얼마나 남았나요?"로 남은 크레딧 확인
2. 잠시 기다렸다가 다시 시도
3. 더 높은 한도를 위해 플랜 업그레이드 고려

연결 문제

검증이 실패하면:

1. 인터넷 연결 확인
2. API 키가 유효한지 확인
3. 먼저 간단한 검증 시도

FAQ

API 키가 안전한가요?

예. API 키는 로컬 설정 파일에 저장되며 여러분의 기기에서 실행되는 MCP 서버에서만 사용됩니다. 제3자에게 전송되지 않습니다.

어떤 AI 클라이언트가 MCP를 지원하나요?

Claude Desktop, Claude Code, Cursor, Zed, Cline 및 Continue를 포함한 모든 MCP 호환 클라이언트가 작동합니다.

오프라인일 때 어떻게 되나요?

EmailVerify API에 연결할 수 없으면 도구는 오류 메시지를 반환합니다. 이는 Claude의 다른 기능에 영향을 주지 않습니다.

크레딧은 어떻게 작동하나요?

각 이메일 검증은 1개의 크레딧을 사용합니다. 대량 검증은 이메일당 1개의 크레딧을 사용합니다. check_credits 도구로 잔액을 확인하세요.

다음 단계