Unbox.imUnbox.im
로그인무료 시작

MCP 지원

AI 어시스턴트를 Unbox에 연결하세요

신뢰할 수 있는 AI 에이전트가 도메인 받은편지함을 돕도록 Model Context Protocol (MCP)을 사용하세요. 스레드 검색, 답변 초안 작성, 메일 보내기, 스팸 및 휴지통 관리 등을 Unbox 웹 앱과 동일한 제한 및 보안 수준으로 수행할 수 있습니다.

개요

Unbox MCP는 개인 계정 소유자가 자신의 호스팅 메일을 사용하여 AI 어시스턴트(Cursor, Workbuddy, OpenClaw 또는 MCP 호환 호스트)와 함께 작업할 수 있도록 설계되었습니다. Unbox에서 앱을 구축하기 위한 개발자 API가 아닙니다. 도메인에서 트랜잭션 전송을 보내려면 HTTP API 문서를 참조하세요.

프로토콜Model Context Protocol (MCP)
범위개인 받은편지함 — 읽기, 검색, 답장, 보내기, 스팸 및 휴지통
인증브라우저 로그인 → 단기 세션

에이전트가 할 수 있는 작업

로그인 후 에이전트가 사용자를 대신하여 Unbox 도구를 호출할 수 있습니다:

  • 받은편지함 및 스레드 읽기 — 대화 목록 보기, 스레드 열기, 개별 메시지 가져오기.
  • 메일 검색 — 자연어 쿼리로 받은편지함 전체에서 메시지를 찾습니다.
  • 보내기 및 답장 — 새 메일 작성 또는 Unbox 주소에서 스레드에 답장(요금제 발송 제한 적용).
  • 정리 — 스팸 표시, 스팸에서 복원, 휴지통으로 이동 또는 복원 — 한 번에 하나의 메시지.

대량 스팸 또는 휴지통 비우기, API 키 생성, 팀 워크스페이스 작업은 v1의 MCP를 통해 사용할 수 없습니다.

작동 방식

AI 클라이언트가 Unbox MCP 서버에 연결됩니다. 서버는 일반 웹 세션(unbox.im에 로그인할 때 생성되는 세션과 동일)을 사용하여 Unbox 계정 API를 호출합니다.

  1. MCP 클라이언트 구성에 Unbox를 추가합니다(아래 설정 참고).
  2. 에이전트에 로그인을 요청합니다 — 그러면 브라우저 링크가 열리고 Unbox 계정으로 액세스를 승인합니다.
  3. 연결 후 에이전트에게 메일 읽기, 답장 초안 작성, 메시지 정리를 요청하세요.

로그인

Unbox는 브라우저 로그인을 사용하므로 항상 액세스를 승인합니다. 에이전트가 로그인 도구로 흐름을 시작하면 브라우저에서 로그인을 완료합니다:

  1. 에이전트가 unbox_login_start를 호출하고 브라우저 URL을 표시합니다.
  2. 링크를 열고 필요한 경우 Unbox에 로그인한 후 페이지에 표시된 일회용 링크 코드를 복사합니다.
  3. 코드를 에이전트에 붙여넣습니다(unbox_login_complete).
  4. 세션은 일반 Unbox 웹 세션 기간 동안 활성 상태로 유지됩니다 — 만료되면 다시 로그인하세요.

로그인 URL (참고용)

https://unbox.im/ko/auth/desktop/link?source=mcp

계정이 필요하신가요? 먼저 Unbox ID를 생성한 후, 다시 돌아와 에이전트를 연결하세요.

설정

AI 클라이언트에 Unbox를 MCP 서버로 추가하세요. 원격 HTTP 전송이 Unbox 클라우드에 연결하는 가장 간단한 방법입니다:

원격 HTTP (권장)

MCP 클라이언트를 Unbox MCP 엔드포인트로 지정하세요. 서버를 추가한 후 로그인 도구를 사용하여 인증하십시오:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

HTTP MCP는 일부 배포 환경에서 운영자가 활성화할 때까지 비활성화될 수 있습니다. 연결이 실패하면 나중에 다시 시도하거나 지원팀에 문의하세요.

일반 도구

로그인 후 에이전트는 다음과 같은 도구를 사용할 수 있습니다:

  • unbox_login_start — 브라우저 로그인 열기
  • unbox_login_complete — 링크 코드를 세션으로 교환
  • unbox_list_threads — 받은 편지함 피드
  • unbox_search_inbox — 메시지 검색
  • unbox_reply_to_email — 메시지에 답장
  • unbox_send_email — 새 메일 보내기

지원되는 클라이언트

MCP 호환 에이전트 호스트는 모두 Unbox에 연결할 수 있습니다. 저희가 테스트하고 문서화한 내용은 다음과 같습니다:

  • Cursor — Cursor 설정의 MCP 서버 아래에 Unbox를 추가한 후 브라우저 흐름을 통해 로그인하세요.
  • Workbuddy — Unbox를 가리키는 원격 MCP 서버 URL을 구성한 다음 계정으로 인증하세요.
  • OpenClaw — OpenClaw를 Unbox MCP HTTP 엔드포인트에 연결하고 브라우저 로그인을 완료하세요.

보안

  • 브라우저 로그인 — 브라우저에서 Unbox를 통해 로그인합니다 — 에이전트는 비밀번호를 절대 볼 수 없습니다.
  • 계정 소유자만 — MCP 액세스는 개인 계정 소유자로 제한되며, 팀 구성원이나 공유 작업공간은 사용할 수 없습니다.
  • 웹 앱과 동일한 제한 — 발송 할당량, 스팸 규칙 및 트랜잭션 정책은 받은 편지함 UI에서와 동일하게 에이전트 작업에 적용됩니다.
  • 대량 삭제 불가 — 에이전트는 MCP v1을 통해 스팸함 비우기, 휴지통 비우기, API 키 교체를 수행할 수 없습니다.
무료 계정 만들기트랜잭션 API 문서
Unbox — MCP 지원 | Unbox.im