SuperMailbox · CRM連携ガイド
SuperMailboxをCRMに接続する
CRMの各ユーザーは、選択したメールボックスへの安全なOAuth接続を利用できます。CRMは顧客とのメールを検索し、確認済みのメール情報を表示して、SuperMailbox MCPサーバー経由で返信を作成・送信できます。
接続の仕組み
メールボックスを接続
ユーザーがGmail、Outlookなどの対応メールボックスをSuperMailboxに接続します。メールプロバイダーへのログインはCRMの認可とは別です。
CRMを認可
CRMがブラウザーでSuperMailbox OAuthを開きます。ユーザーはログインし、クライアント名と要求権限を確認して接続を許可します。
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の接続を取り消せます。

