SuperMailbox · CRM 연동 가이드

SuperMailbox를 CRM에 연결하기

CRM 사용자마다 선택한 메일함에 안전한 OAuth 연결을 설정할 수 있습니다. CRM은 고객 대화를 찾고 확인된 이메일 맥락을 보여 주며 SuperMailbox MCP 서버를 통해 답장을 작성하거나 보낼 수 있습니다.

연결 작동 방식

01

메일함 연결

사용자가 Gmail, Outlook 또는 지원되는 메일함을 SuperMailbox에 연결합니다. 이메일 제공업체 로그인은 CRM 승인과 별개입니다.

02

CRM 승인

CRM이 브라우저에서 SuperMailbox OAuth를 엽니다. 사용자는 로그인한 뒤 클라이언트와 요청 권한을 확인하고 연결을 승인합니다.

03

MCP 도구 사용

CRM은 사용자의 액세스 토큰으로 원격 MCP 서버를 호출합니다. 사용자가 승인된 메일함을 선택하면 CRM은 그 권한 안에서 작동합니다.

연결 설정

원격 Streamable HTTP와 OAuth 검색을 지원하는 MCP 클라이언트 또는 SDK를 사용하세요. 브라우저 승인 과정을 처리하고 MCP 요청에 액세스 토큰을 포함해야 합니다.

MCP 서버 URL
https://api.supermailbox.app/mcp
승인
OAuth 2.0 · Authorization Code · PKCE S256
권한 범위
openid email mail.accounts.read mail.messages.read mail.send

워크플로에 필요한 권한만 요청하세요. 고객 이메일을 읽고 답장을 보내는 CRM은 다음을 요청할 수 있습니다.

대화 검색 및 확인

  • list_mail_accounts를 호출해 사용자가 사용할 메일함을 선택하게 하세요. canSend는 참고 정보이며 실제 전송 시 권한을 다시 확인합니다.
  • search_emails 또는 search_threads_by_recipient로 후보를 찾으세요. 수신자 검색은 메타데이터만 반환하므로 CRM 기록에 연결하기 전에 선택한 스레드를 가져와 확인하세요.
  • 검색 결과는 제한되거나 불완전할 수 있습니다. coverage와 completeness를 확인하세요. 불완전한 빈 결과가 메일 부재를 증명하지는 않습니다.
  • 메일함, 메시지, 스레드 ID는 불투명하며 현재 사용자의 권한에 속합니다. 같은 사용자 연결에서 조회하고 검증하세요.

안전하게 답장 준비 및 전송

  • 전송을 확인하기 전에 선택한 메일함, 수신자, 답장 내용을 CRM에 표시하세요.
  • send_email과 reply_to_email은 대기 중인 작업을 반환합니다. 최종 상태가 될 때까지 같은 operation ID와 필요한 권한으로 get_mail_action을 확인하세요.
  • 대기열 접수는 전송 완료를 뜻하지 않습니다. 상태가 불확실하면 같은 작업을 확인하고 새 ID로 자동 재전송하지 마세요.

보안 및 액세스 제어

  • MCP 클라이언트 검색 과정을 통해 PKCE S256이 적용된 OAuth authorization-code 흐름을 사용하세요. 시크릿과 토큰은 서버에 보관하고 브라우저 코드나 로그에 노출하지 마세요.
  • CRM 사용자마다 별도의 연결을 만드세요. 한 사용자의 토큰이나 불투명 메일 ID를 다른 사용자와 공유하지 마세요.
  • CRM에서 이메일을 보낼 때만 mail.send를 요청하세요. 사용자는 SuperMailbox의 연결된 앱 설정에서 CRM 연결을 취소할 수 있습니다.