EngageLab Agent Email MCP Server

영어 | 简体中文

AI 에이전트에서 이메일 보내기, 받기, 답장하기 — Model Context Protocol을 통해.

각 에이전트는 자체 사서함을 갖습니다: 실제 주소로 보내고 받을 수 있으며, 대화가 스레드로 그룹화되어 에이전트가 맥락을 파악할 수 있습니다. Claude Desktop, Claude Code, Cursor, Cowork 및 모든 MCP 호환 클라이언트에서 작동합니다.

{
  "mcpServers": {
    "engagelab-email": {
      "command": "npx",
      "args": ["-y", "@engagelabemail/mcp"],
      "env": { "ENGAGELAB_EMAIL_SECRET_KEY": "sk_sg_your_key" }
    }
  }
}

왜

대부분의 이메일 API는 전송 전용입니다. 이메일로 대화를 해야 하는 에이전트(지원, 일정 조율, 승인)는 받은 편지함이 필요합니다.

• 보내기 및 받기 — 에이전트는 전용 사서함을 소유하며, 별도로 붙인 파싱 웹훅이 아닙니다.

• 스레드 인식 — 답장이 대화로 그룹화되어 에이전트가 전체 기록을 볼 수 있습니다.

• 샌드박스 모드 — 실제 사람에게 이메일을 보내지 않고 에이전트 흐름을 테스트합니다.

• 환경 변수 하나 — 로컬 사용을 위한 OAuth 절차 없음; 키에서 지역을 추론합니다.

도구

빠른 시작

1. Secret Key 받기. EngageLab 계정을 만들고 콘솔에서 키를 생성하세요 (형식 sk_sg_xxx — 접두사가 지역을 선택합니다). 또는 CLI를 사용하세요: engagelab-email-cli login이 브라우저를 통해 생성합니다.

2. 사서함 만들기. 콘솔에서 에이전트용 사서함을 만드세요 (공유 하위 도메인은 즉시 가능; 사용자 지정 도메인은 DNS 확인 필요). 프로그래밍 방식의 사서함 생성은 로드맵에 있습니다 — list_mailboxes가 비어 있으면 문제 해결을 참조하세요.

3. 서버 등록.

Claude Desktop — 위의 JSON 블록을 claude_desktop_config.json에 추가하세요.

Claude Code:

claude mcp add engagelab-email \
  -e ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_your_key \
  -- npx -y @engagelabemail/mcp

그런 다음 에이전트에게 요청하세요:

내 사서함을 나열한 다음 첫 번째 사서함에서 bob@example.com으로 송장이 승인되었다는 이메일을 보내세요.

지원 봇의 일반적인 에이전트 루프:

check_new_messages()            → [messageUids]
get_message(uid)                → body, attachments
list_thread_messages(threadId)  → full conversation context
reply_email(uid, { text: ... }) → response lands in the same thread

구성

제한: 메시지당 최대 10개 첨부파일 / 총 10MB (도구 스키마에서 base64로 인코딩됨).

문제 해결

• list_mailboxes가 빈 목록을 반환 — 계정에 아직 사서함이 없습니다. EngageLab 콘솔에서 만드세요 (빠른 시작 2단계 참조). 에이전트는 아직 사서함을 자체 프로비저닝할 수 없습니다.

• 401 / code 100101 — Secret Key가 잘못되었거나 취소되었습니다. ENGAGELAB_EMAIL_SECRET_KEY와 키의 지역 접두사(sk_sg_ / sk_tr_)가 사용 중인 엔드포인트와 일치하는지 확인하세요.

• API 기본 URL을 확인할 수 없음 — 키의 지역 접두사가 인식되지 않습니다. ENGAGELAB_EMAIL_BASE_URL을 명시적으로 설정하세요.

• 답장이 새 대화로 표시됨 — reply_email(이 아닌 send_email)을 사용하여 In-Reply-To 헤더와 스레딩이 유지되도록 하세요.

로드맵

• 호스팅 MCP (OAuth)로 원격 사용 시 구성 불필요

• Secret Key를 통한 프로그래밍 방식 사서함 생성

• check_new_messages를 위한 웹훅 푸시 (폴링 없음)

• URL 기반 첨부파일 참조 (컨텍스트에 base64 없음)

소스에서 실행

git clone https://github.com/Metaverse-Cloud/engagelab-email-mcp
cd engagelab-email-mcp
npm install && npm run build
ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_xxx node dist/index.cjs

관련 자료

• EngageLab Agent Email CLI — 터미널에서 동일한 사서함, 에이전트용 --json 출력

• EngageLab Node SDK / Python SDK — 코드에서 이메일 보내기

라이선스

MIT