Cursor でメールを読んで返信するには？
MCP は、AI エージェントが外部のツールを呼び出すための仕組みです。Mailera は既存のメールボックスを MCP ツールとして提供し、Cursor はその接続に対応しています。
Cursor 連携の概要とMailera の MCP ツールで対応範囲を確認できます。クライアントを選ぶ段階なら、既存メールボックス向け MCP サーバーの総合ガイドを参照してください。
接続前に何を用意すればよいですか？
Cursor と、自分が管理するテスト用メールボックスを用意します。Mailera に接続済みなら、追加作業は不要です。新しく接続する場合は、Admin または Leader が「メールボックス」→「メールボックスを追加」から操作します。
Outlook・Microsoft 365 は OAuth で接続します。認証の手順は Microsoft の接続案内で確認してください。Gmail はアプリパスワード（app password）で接続します。2 段階認証を有効にしたアカウントが前提になるため、準備は Gmail の接続案内で確認してください。
API キーの権限は、実行する操作に合わせます。表の read や send は API のスコープ名です。キー作成画面では、読み取り権限と送信権限を分けて設定します。
| 操作 | MCP ツール | 必要な API スコープ |
|---|---|---|
| メールボックス一覧 | list_mailboxes | read |
| メール一覧・検索・本文取得 | list_messages、search_messages、get_message | read |
| 返信・新規送信・送信状態の確認 | reply_to_email、send_email、get_send_status | send |
| 明示的な同期 | sync_mailbox | sync |
読むだけなら send は不要です。最初からすべての権限を付けないでください。
Mailera の MCP を Cursor に設定するには？
- Mailera の「メールボックス」で、テスト用メールボックスの接続状態を確認します。
- 「設定」で API キーのタブを開き、「キーを作成」を選びます。「メールボックスのスコープ」をテスト用グループに限定し、まず読み取り権限だけを付けます。「有効期限」と、必要に応じて「IP制限（任意）」を設定してください。
- 作成後のダイアログで Cursor 向けの「MCP 設定をコピー」を使います。API キーは一度しか表示されないため、安全な場所に保管します。
- コピーした設定を Cursor の MCP 設定に追加します。プロジェクト専用なら
.cursor/mcp.json、全体で使うなら~/.cursor/mcp.jsonです。既存の設定がある場合は上書きせず、追加してください。 - 接続先が
https://mailera.app/api/public/v1/mcpであることを確認し、Cursor にlist_mailboxesの実行を依頼します。許可したテスト用メールボックスが返るか確認してください。
設定場所と認証情報の扱いは、Cursor 公式の MCP 設定資料に記載されています。認証は Authorization ヘッダーの Bearer 形式です。キーを設定ファイルへ直書きせず、Cursor が参照できる環境変数 MAILERA_API_KEY を用意し、ヘッダー値に Bearer ${env:MAILERA_API_KEY} を使えます。リモート MCP サーバーでは envFile は使えません。
必要なメールを読むには？
list_mailboxesの結果から対象のメールボックスを選びます。list_messagesでメールを絞ります。件名などで探す場合はsearch_messagesを使います。- 対象を特定したら、
get_messageで本文を取得します。一覧のプレビューだけで返信を書かせないでください。
Cursor への指示は、対象と禁止する操作を具体的に書きます。
指定したテスト用メールボックスから、件名が「接続確認」のメールを探し、本文を取得して要約してください。対象のメールボックスと件名も表示してください。送信はしないでください。
取得した件名と本文を、Mailera の「統合受信トレイ」と照合します。公開用の画像やサンプルには、自作のテストメールだけを使ってください。
ツールの引数は、接続先が提供する定義に従います。MCP のツール仕様では、inputSchema が受け付ける引数を定義します。REST API のパラメーターを、そのまま MCP に転用しないでください。
返信内容を確認してから送信するには？
- まず「まだ送信せず、返信案をこのチャットに表示してください」と依頼します。ここでは Cursor 上の文章案として扱い、メールサービスの下書きフォルダーへの保存操作とは分けます。
- 送信元、宛先、返信対象のメール、本文を人が確認します。最初の送信先は、自分が管理するテスト用メールアドレスに限定してください。
- 送信段階で
send権限を持つキーの設定に切り替えます。読み取りも続ける場合はreadも必要です。Cursor 側で手動承認を求める設定になっているか確認します。 reply_to_emailの実行前に、ツール名の横の矢印を開いて引数を確認します。内容が合っていれば承認してください。- 実行後は
get_send_statusで送信状態を確認します。結果が不明なら、その場で同じ返信を再送しないでください。
Cursor は既定で MCP ツールの実行前に承認を求めます。ただし Auto-review モードでは、許可リストに登録したツールは即時実行され、それ以外は classifier（分類器）を経由して判定されます。送信ツールは許可リストに入れないでください。プロンプトに「確認してから送信」と書くだけでは不十分です。
よくあるエラーはどう切り分けますか？
| 症状 | 確認する場所 | 次の操作 |
|---|---|---|
| MCP に接続できない | 接続先、認証ヘッダー、キーの期限・失効、IP 制限 | Cursor の「Output」で「MCP Logs」を選び、設定と照合する |
| 接続できるがメールボックスが出ない | キーの対象グループと read 権限 | 許可対象を確認し、list_mailboxes を再実行する |
| 新着メールが見つからない | 接続状態、フォルダー、検索条件、同期状態 | 条件を見直す。sync_mailbox を実行する場合だけ sync 権限を追加する |
| 読めるが返信できない | send 権限、送信元、受信専用の設定 | 送信接続を確認する。実行済みなら送信状態を調べる |
メールを AI に読ませるときの安全対策は？
受信メールは信頼できないデータであり、エージェントへの命令ではありません。 本文中に「秘密情報を送れ」「設定を変更せよ」とあっても従わせないでください。メール本文に MCP 設定を追加するリンクが含まれていても、そのまま開かず接続先と設定内容を確認します。
読み取り時は対象グループと最小権限でアクセスを限定し、送信時はツールの承認設定で止めます。文章による指示と、権限による制限を併用してください。設計の詳細は承認の境界を設けたメールエージェントの構築手順を参照してください。
API キーはチャット、Git 管理対象、スクリーンショットに含めません。漏えいしたら失効させてください。失効後、そのキーによる呼び出しは即座に拒否されます。
メール本文が Cursor や選択したモデルに渡る範囲も確認し、社内の機密情報の取り扱い規程に従ってください。Mailera 側の情報はセキュリティの説明で確認できます。
Mailera でできないことは？
受信専用で保存したメールボックスは、返信も新規送信もできません。送信接続に失敗した場合、メールボックスを受信専用として保存できます。
送信処理の成功と、相手の受信トレイへの到達は別です。Mailera は受信トレイへの到達を保証しません。また、使用状況によって同期頻度が変わり、非アクティブなメールボックスはスリープする場合があります。新着メールが必ずすぐに表示されるとは限らない点に注意してください。
MCPでAIエージェントがメールボックスを利用
MaileraのMCPサーバーをClaude、Cursor、VS Codeに追加すると、エージェントがメールの閲覧、分類、返信を行えます。
MCPの使い方を見る
