@multimail/mcp-server

MultiMail을 위한 MCP 서버입니다. 에이전트에게 자체 이메일 주소를 부여하고, 완전한 승인부터 자율 발송까지 단계별 인간 감독 기능을 제공합니다.

빠른 시작

npx @multimail/mcp-server

전체 액세스 권한을 얻으려면 MULTIMAIL_API_KEY를 설정하거나, 먼저 계정을 생성하려면 키 없이 실행하세요. multimail.dev에서 키를 받을 수 있습니다.

MultiMail을 사용함으로써 귀하는 서비스 약관 및 허용 가능한 사용 정책에 동의하게 됩니다.

Related MCP server: MCP Email Server

설정

옵션 A: 원격 서버 (권장)

설치가 필요 없습니다. 호스팅된 서버에 직접 연결하세요. 브라우저에서 OAuth를 통해 인증합니다.

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}

Claude.ai, Claude Desktop, Claude Code 및 원격 MCP 서버를 지원하는 모든 클라이언트에서 작동합니다.

옵션 B: 로컬 서버 (stdio)

서버를 로컬에서 실행합니다. API 키는 환경 변수로 전달됩니다.

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_...",
        "MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
      }
    }
  }
}

추가 위치

클라이언트	설정 파일
Claude Code	`~/.claude/.mcp.json`
Claude Desktop	`claude_desktop_config.json`
Cursor	프로젝트 내 `.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Copilot (VS Code)	프로젝트 내 `.vscode/mcp.json`
OpenCode	프로젝트 내 `mcp.json`
ChatGPT Desktop	설정 > MCP 서버
모든 MCP 클라이언트	클라이언트 문서의 설정 위치 참조

환경 변수

변수	필수	설명
`MULTIMAIL_API_KEY`	예	MultiMail API 키 (`mm_live_...`)
`MULTIMAIL_MAILBOX_ID`	아니오	기본 메일함 ID. 설정하지 않으면 각 도구에 `mailbox_id`를 전달하거나 먼저 `list_mailboxes`를 호출하세요.
`MULTIMAIL_API_URL`	아니오	API 기본 URL. 기본값은 `https://api.multimail.dev`입니다.

첫 실행 설정

처음 사용할 때 MultiMail은 메일함 구성을 요청합니다. configure_mailbox 도구를 사용하여 명시적으로 실행할 수도 있습니다:

감독 모드: 필요한 인간 승인 수준 (gated_send, monitored, autonomous 등)
표시 이름: 이메일에 표시되는 발신자 이름
CC/BCC 기본값: 모든 발신 이메일에 자동으로 참조/숨은참조 추가
예약: 예약 발송 활성화/비활성화 및 기본 게이트 시간 설정
서명: 이메일 서명 블록

이 단계를 건너뛰면 첫 도구 호출 시 MultiMail이 다시 알려줍니다.

도구

도구	설명
`list_mailboxes`	이 API 키로 사용할 수 있는 모든 메일함 나열
`configure_mailbox`	메일함 기본 설정(감독 모드, 표시 이름, CC/BCC, 예약, 서명) 구성
`send_email`	마크다운 본문으로 이메일 발송. 첨부 파일, `idempotency_key`, 예약 발송을 위한 `send_at` 지원
`check_inbox`	상태, 발신자, 제목, 날짜 범위, 방향, 첨부 파일, 커서 페이지네이션 필터로 이메일 나열
`read_email`	전체 이메일 내용 가져오기. 신뢰할 수 있는 메타데이터와 신뢰할 수 없는 본문을 별도의 콘텐츠 블록으로 반환
`reply_email`	기존 스레드의 이메일에 답장. 첨부 파일 및 `idempotency_key` 지원
`download_attachment`	이메일 첨부 파일을 콘텐츠 유형과 함께 base64로 다운로드
`get_thread`	대화 스레드의 모든 이메일을 참가자 및 메타데이터와 함께 가져오기
`cancel_message`	대기 중이거나 예약된 이메일 취소
`schedule_email`	`send_at` 시간을 지정하여 미래의 발송을 예약. 발송 전 수정 또는 취소 가능
`edit_scheduled_email`	발송 전 예약된 이메일의 발송 시간, 수신자, 제목 또는 본문 수정
`update_mailbox`	메일함 설정 업데이트 (표시 이름, 감독 모드, 서명, 웹훅)
`update_account`	계정 설정 업데이트 (조직 이름, 감독 이메일, 실제 주소)
`delete_mailbox`	메일함 영구 삭제 (관리자 권한 필요)
`request_challenge`	계정 생성을 위한 ALTCHA 작업 증명 챌린지 요청 (API 키 불필요)
`create_account`	해결된 PoW 챌린지로 새 계정 생성 (API 키 불필요)
`resend_confirmation`	새 코드로 확인 이메일 재발송 (API 키 불필요)
`activate_account`	확인 이메일의 코드를 사용하여 계정 활성화 (API 키 불필요)
`tag_email`	이메일에 키-값 태그 설정, 가져오기 또는 삭제 (지속적인 에이전트 메모리)
`add_contact`	선택적 태그와 함께 주소록에 연락처 추가
`search_contacts`	이름 또는 이메일로 주소록 검색
`get_account`	계정 상태, 플랜, 할당량, 발송 활성화 여부, 집행 등급 확인
`create_mailbox`	새 메일함 생성 (관리자 권한 필요)
`request_upgrade`	감독 모드 업그레이드 요청 (신뢰 사다리)
`apply_upgrade`	운영자로부터 받은 업그레이드 코드 적용
`get_usage`	청구 기간에 대한 할당량 및 사용 통계 확인
`list_pending`	감독 결정 대기 중인 이메일 나열 (감독 권한 필요)
`decide_email`	대기 중인 이메일 승인 또는 거부 (감독 권한 필요)
`delete_contact`	주소록에서 연락처 삭제
`check_suppression`	수신 거부된 이메일 주소 나열
`remove_suppression`	수신 거부 목록에서 주소 제거
`list_api_keys`	모든 API 키 나열 (관리자 권한 필요)
`create_api_key`	범위가 지정된 새 API 키 생성 (관리자 권한 + 운영자 승인 필요; 자체 승인을 방지하기 위해 `send`+`oversight` 조합은 거부됨)
`revoke_api_key`	API 키 취소 (관리자 권한 필요)
`get_audit_log`	계정 감사 로그 가져오기 (관리자 권한 필요)
`delete_account`	계정 및 모든 데이터 영구 삭제 (관리자 권한 필요)
`wait_for_email`	필터와 일치하는 새 이메일이 도착하거나 타임아웃(최대 120초)될 때까지 차단
`create_webhook`	실시간 이메일 이벤트 알림을 위한 웹훅 구독 생성
`list_webhooks`	이 계정에 대한 모든 웹훅 구독 나열
`delete_webhook`	웹훅 구독 삭제

작동 방식

이메일 본문을 마크다운으로 작성하면 MultiMail이 발송을 위해 서식 있는 HTML로 변환합니다.
수신 이메일은 깔끔한 마크다운으로 도착합니다. HTML 파싱이나 MIME 디코딩이 필요 없습니다.
스레딩은 자동으로 처리됩니다. 이메일에 답장하면 헤더가 올바르게 설정됩니다.
발송 시 이메일이 위협 요소에 대해 스캔되는 동안 pending_scan 상태를 반환합니다. 메일함이 게이트 감독을 사용하는 경우, 상태는 인간 검토를 위해 pending_send_approval로 전환됩니다. 재시도하거나 다시 보내지 마십시오.
수신된 이메일의 X-MultiMail-Identity 서명된 헤더를 확인하여 다른 에이전트를 검증하세요.

개발

npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start     # Run compiled version

테스트

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js

라이선스

MIT

MultiMail

@multimail/mcp-server

빠른 시작

설정

옵션 A: 원격 서버 (권장)

옵션 B: 로컬 서버 (stdio)

추가 위치

환경 변수

첫 실행 설정

도구

작동 방식

개발

테스트

라이선스

Resources

Tools

Latest Blog Posts

MCP directory API