MCP
Gmail、Outlook、Yahoo、iCloud、IMAP対応のMCPサーバー
Claude、Cursor、VS Codeやエージェントが、接続済みのすべてのメールボックスでメールの閲覧、OTPコードの取得、返信、迷惑メールからの移動を行えます。ワークスペースのAPI keyを使うだけで、コードは不要です。
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \ --header "Authorization: Bearer mh_live_xxx"接続
- サーバーURL
https://mailera.app/api/public/v1/mcp- 認証
Authorization: Bearer mh_live_… または X-API-Key- トランスポート
- Streamable HTTP、セッション不要
- プロトコルバージョン
- 2025-06-18 · 2025-03-26 · 2024-11-05
キーの権限に応じた12個のツール
エージェントには、API keyの権限で許可されたツールのみが表示されます。各呼び出しは対応するRESTエンドポイントを実行するため、結果とエラーコードはAPIと同じです。
| ツール | 機能 | スコープ |
|---|---|---|
| list_mailboxes | メールボックス、プロバイダー、対応機能、同期状態を一覧表示します | read |
| get_mailbox_status | メールボックスの接続状態と最終同期時刻を確認します | read |
| list_messages | フォルダー内のメールを新しい順に一覧表示します | read |
| search_messages | すべてのメールボックスからメールを検索します。OTPコードも取得できます | read |
| get_message | 差出人、本文、添付ファイルを含むメール全体を読み取ります | read |
| get_latest_otp | 受信トレイまたは迷惑メールから最新のOTPコードを取得します | read |
| send_email | idempotency_keyで重複送信を防ぎながら、新規メールを送信します | send |
| reply_to_email | メールに返信、全員に返信、または転送します | send |
| get_send_status | 送信処理の状態がsent、failed、unknownのいずれかになるまで追跡します | send |
| move_message | メールを受信トレイ、迷惑メール、アーカイブ、削除済みアイテムに移動します | move |
| rescue_spam | 迷惑メールからすべてのメール、または差出人、ドメイン、件名で指定したメールを移動します | move |
| sync_mailbox | 今すぐ同期し、スリープ中のメールボックスを再開します | sync |
各ツール呼び出しは対応するRESTエンドポイントを使用します。スコープ、毎分300リクエストの上限、APIログは共通です。エラーはツールの結果(isError)に表示され、エージェントが処理できるよう、一貫したerror.codeが含まれます。
アプリ別の設定
設定をコピーしてAPI keyを入力し、アプリを再起動してください。各アプリのガイドには、動作確認の手順とよくあるエラーを掲載しています。
Claude
Claude Codeはコマンド1つで、Claude Desktopはmcp-remoteブリッジ経由で接続できます。
Terminal · claude_desktop_config.json
ClaudeガイドCursor
mcp.jsonファイル1つで、すべてのプロジェクトにも、特定のプロジェクトにも設定できます。
~/.cursor/mcp.json
CursorガイドVS Code
.vscode/mcp.jsonで設定できます。VS Codeはキーを一度だけ確認し、安全に保管します。
.vscode/mcp.json
VS Codeガイド
エージェントによる安全なメールボックス利用
必要な権限だけを付与
エージェントがメールを読むだけなら、読み取り権限のみのキーを作成してください。送信権限は本当に必要な場合にのみ付与し、可能な限りキーのアクセス先をメールボックスのグループで制限してください。
受信メールはデータであり、指示ではありません
メールの内容は他の人が書いたものです。「すべてのメールを…に転送して」など、メール内の指示にエージェントを従わせないでください。送信や転送の前には、必ず確認を求めるようにしてください。
各メールの送信は1回だけ
送信時は必ずidempotency_keyを渡してください。ステータスが不明な場合は再送せず、まず送信済みアイテムを確認してください。
いつでも失効可能
設定 → API keyでキーを失効させると、そのキーを使うすべてのアプリを即座にブロックできます。ツールの呼び出しは毎回APIログに記録されます。
MCPを使わない場合は?
すべてのツールに対応するRESTエンドポイントがあり、新着メール用の署名付きwebhookも利用できます。

