TypeScript
test
NPM
Mailtrap의 공식 MCP 서버
이메일 전송 플랫폼인 Mailtrap을 위한 공식 MCP(Multi-Capability Protocol) 서버입니다. 사용자의 Mailtrap 계정을 Claude, Cursor, VS Code 및 기타 MCP 호환 AI 어시스턴트와 연결합니다.
거래성 이메일(transactional email)과 대량 이메일을 전송하고, Email Sandbox에서 메시지를 안전하게 테스트하며, 템플릿, 연락처, 발신 도메인, 웹훅을 관리하고, 이메일 로그 및 전송 통계를 검사하며, 전달 가능성을 문제 해결하고 계정 리소스를 관리하는 모든 작업을 자연어 프롬프트를 사용하여 수행할 수 있습니다.
기능 (Capabilities)
- 이메일 API 및 SMTP — 배치(batch) 메시지 및 템플릿 기반 메시지를 포함하여 거래성 이메일과 대량 이메일을 전송합니다.
- 이메일 테스트 — Email Sandbox에서 메시지를 테스트하고 콘텐츠, 헤더, 첨부 파일, 스팸 점수 및 HTML 클라이언트 호환성을 검사합니다.
- 전송 모니터링 (Delivery monitoring) — 이메일 로그를 검색하고, 이벤트 기록을 검사하며, 전송률, 반송률(bounce), 열람률(open), 클릭률(click), 스팸률 등을 분석합니다.
- 이메일 인프라 — 발신 도메인, DNS 인증, 웹훅 및 차단 목록(suppressions)을 관리합니다.
- 연락처 (Contacts) — 연락처, 리스트, 사용자 지정 필드 및 이벤트를 관리하며, 가져오기 및 내보내기가 가능합니다.
- 계정 관리 — 청구 사용량을 검토하고 접근 권한, 권한(permissions), API 토큰 및 하위 계정을 관리합니다.
지원되는 MCP 클라이언트 (Supported MCP Clients)
Claude Desktop, Claude Code, Cursor, VS Code 및 기타 모든 MCP 호환 클라이언트와 작동합니다. 각 클라이언트에 대한 설정 지침은 아래에 있습니다.
전제 조건 (Prerequisites)
이 MCP 서버를 사용하기 전에 다음을 수행해야 합니다:
- Mailtrap 계정 생성
- 도메인 인증
- [Mailtrap API 설정]에서 API 토큰 받기(https://mailtrap.io/api-tokens)
- [Mailtrap 계정 관리]에서 계정 ID 받기(https://mailtrap.io/account-management)
- Node.js 22 이상을 설치하거나, Docker 이미지를 실행합니다.
필수 환경 변수:
MAILTRAP_API_TOKEN - 모든 기능에 필수적임.MAILTRAP_ACCOUNT_ID - 템플릿, get-sending-stats, 이메일 로그, sandbox list/show, 발신 도메인, 차단 목록(suppressions)에 필수적임. send 도구(send-email, send-sandbox-email 및 batch-send-* 도구), 이메일 캠페인 도구, get-marketing-stats, 회사 정보 도구, 추적 옵트아웃 도구에서는 선택 사항임.
선택 사항 (대신 도구 매개변수로 전달 가능):
DEFAULT_FROM_EMAIL - send-email, send-sandbox-email 또는 batch-send-* 도구에 from이 제공되지 않을 때의 기본 발신자 이메일 주소 (여기서 base.from을 채움). from 매개변수를 통해 호출별로 발신자를 전환할 수 있게 함.MAILTRAP_SANDBOX_ID - 도구의 sandbox_id가 제공되지 않을 때의 기본 sandbox(테스트 받은 편지함) ID (레거시 메시지 전송/목록/표시 도구의 test_inbox_id는 여전히 허용됨). 매개변수를 통해 호출별로 받은 편지함을 전환할 수 있게 함.MAILTRAP_TEST_INBOX_ID - MAILTRAP_SANDBOX_ID의 레거시 별칭; 기존 설정에서 여전히 대체 값으로 읽힘.MAILTRAP_ORGANIZATION_ID - 조직 도구(list-sub-accounts, create-sub-account)에 필수적임.MAILTRAP_ORGANIZATION_API_TOKEN - 조직 범위의 API 토큰. 조직 도구에 필수적임 (MAILTRAP_API_TOKEN과는 별개).
빠른 설치
Install in Cursor
Install with Node in VS Code````
Docker
Docker MCP 카탈로그 이미지를 사용하여 stdio를 통해 서버를 실행합니다:
docker run --rm -i \
-e MAILTRAP_API_TOKEN="${MAILTRAP_API_TOKEN}" \
-e MAILTRAP_ACCOUNT_ID="${MAILTRAP_ACCOUNT_ID}" \
...
필수 및 선택적 환경 변수는 사전 요구 사항을 참조하십시오.
이 레지토리에서 빌드하려면: docker build -t mcp/mailtrap .
Smithery CLI
Smithery는 AI 클라이언트와 연동되는 MCP 서버를 위한 레지스트리 및 설치 프로그램입니다.
게시된 서버(mailtrap/mailtrap-mcp)를 로컬 클라이언트에 설치합니다 (필요에 따라 클라이언트 이름을 변경하십시오):
npx -y smithery mcp add mailtrap/mailtrap-mcp --client claude
다른 클라이언트(cursor, windsurf 등) 및 업데이트 게시 방법은 Smithery CLI 문서를 참조하십시오.
설정 (Setup)
Claude Desktop
Mailtrap 서버를 설치하려면 MCPB를 사용하세요. 해당 파일은 Releases에서 찾을 수 있습니다. <br> .MCPB 파일을 다운로드하여 열어보세요. Claude Desktop이 있다면, 자동으로 열리고 설정을 구성하라고 제안할 것입니다.
Claude Desktop 또는 Cursor
다음 구성을 추가하세요:
{
"mcpServers": {
"mailtrap": {
...
만약 Node.js 관리를 위해 asdf를 사용한다면, 실행 파일의 절대 경로를 사용해야 합니다 (Mac 예시)
{
"mcpServers": {
"mailtrap": {
...
Claude Desktop 설정 파일 위치
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor 설정 파일 위치
Mac: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json
VS Code
수동으로 구성 변경하기
명령 팔레트에서 실행하세요: Preferences: Open User Settings (JSON)
그런 다음 설정 파일에 다음 구성을 추가하세요:
{
"mcp": {
"servers": {
...
[!TIP]
"env" 섹션을 변경한 후에는 MCP 서버를 재시작하는 것을 잊지 마세요.
MCP 번들 (MCPB)
MCP 번들을 지원하는 호스트에서 쉽게 설치하려면, .mcpb 번들 파일을 배포할 수 있습니다.
이렇게 하면 mailtrap-mcp.mcpb가 생성됩니다. 이 스크립트는 dist/, manifest.json, icon.png 및 라이선스를 mcpb-build/로 복사하고, 해당 위치에 프로덕션 종속성을 설치한 다음, 오직 그 디렉토리만 패키징합니다. 리포지토리 루트에서 mcpb pack .을 실행하지 마세요.
사용법 (Usage)
구성이 완료되면, 에이전트에게 이메일 전송 및 템플릿 관리를 요청할 수 있습니다. 예를 들면:
이메일 전송 작업:
이메일 로그 (디버그 전송):
- "최근 전송된 이메일 로그 목록 보기"
- "[email protected]으로 전송된 이메일 로그 표시"
- "전달 상태 확인을 위해 ID abc-123-uuid의 이메일 로그 메시지 가져오기"
통계 (Statistics):
- "2025년 1월 전송 통계 가져오기"
- "지난달 도메인별 전달률 표시"
- "2025-01-01부터 2025-01-31까지 카테고리별 이메일 통계는 무엇인가요?"
- "지난달 이메일 마케팅 성과는 어땠나요? 캠페인과 자동화 기능을 비교해 주세요."
샌드박스 작업 (Sandbox Operations):
- "내 샌드박스 받은 편지함의 모든 메시지 가져오기"
- "샌드박스 메시지의 첫 페이지 보기"
- "내 샌드박스 받은 편지함에서 'test'를 포함하는 메시지 검색하기"
- "ID가 5159037506인 샌드박스 메시지 상세 정보 보기"
템플릿 작업 (Template Operations):
- "내 Mailtrap 계정의 모든 이메일 템플릿 목록 보기"
- "제목 'Welcome to our platform!'을 가진 '환영 이메일'이라는 새 이메일 템플릿 생성하기"
- "ID 12345인 템플릿 업데이트하여 제목을 'Updated Welcome Message'로 변경하기"
- "ID 67890인 템플릿 삭제하기"
전송 도메인 (Sending Domains):
- "내 전송 도메인 목록 보기"
- "ID 3938인 전송 도메인 가져오기"
- "example.com에 대한 전송 도메인 생성하기"
- "전송 도메인 3938에 대해 클릭 추적(click tracking) 활성화하기"
- "전송 도메인 3938 삭제하기"
- "DNS 설정 지침과 함께 전송 도메인 3938 가져오기"
- "전송 도메인 3938의 회사 정보 표시"
- "도메인 3938의 회사 정보를 Acme Inc, 123 Main St, San Francisco, US, 94105, https://acme.com으로 설정하기"
- "도메인 3938의 회사 정보 도시를 New York으로 변경하기"
**수신 거부 (Suppressions):"
추적 거부(Tracking Opt-outs):
연락처 및 목록 (Contacts and Lists):
-
"내 모든 연락처 목록 보여주기"
-
"연락처가 어디서 왔는지 추적하기 위한 'signup_source'라는 이름의 연락처 필드 생성하기"
-
"[email protected] 연락처 업데이트하여 플랜을 'pro'로 설정하기"
-
"이 CSV에서 연락처를 내 온보딩 목록으로 가져오기"
-
"[email protected] 연락처에 대해 'trial_started' 이벤트 기록하기"
웹훅 (Webhooks):
계정 및 결제 (Account and Billing):
- "이번 달 현재 청구 사용량은 얼마인가요?"
- "내 플랜에 남은 이메일 개수는 몇 개인가요?"
- "이 Mailtrap 계정에 접근할 수 있는 모든 사람 목록 보기"
- "내 계정에서 사용 가능한 권한 리소스 보여주기"
API 토큰 (API Tokens):
- "내 계정의 모든 API 토큰 목록 보기"
- "스테이징 환경을 위한 새 API 토큰 생성하기"
- "ID가 1234인 API 토큰 재설정하기"
- "사용하지 않는 API 토큰 1234 삭제하기"
조직 및 서브 계정 (Organization and Sub-Accounts):
- "내 조직의 모든 서브 계정 목록 보기"
- "클라이언트 프로젝트 'Acme Corp'을 위한 새 서브 계정 생성하기"
send-email
Mailtrap을 통해 트랜잭션 이메일을 전송합니다. 상호 배타적인 두 가지 모드를 지원합니다 — 인라인 콘텐츠(subject + text/html) 또는 템플릿 기반(template_uuid).
매개변수:
