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の接続を取り消せます。