MCP
CursorでMaileraを使う
Cursorのmcp.jsonファイルにMaileraを追加してください。コーディング中でも、Cursorのエージェントがメールの閲覧、登録テスト中のOTPコード取得、メールへの返信を行えます。
Cursorの公式ドキュメント始める前に
- 無料のワークスペースを作成し、メールボックスを1つ以上接続します。
- 「設定 → API key」でキーを作成し、権限を選択します。まずはread権限だけで始められます。
- 作成したキーはすぐにコピーしてください。Maileraでキー全体が表示されるのは一度だけです。
セットアップ
- 全プロジェクトで使う場合は~/.cursor/mcp.jsonを、特定のプロジェクトのみで使う場合はプロジェクトディレクトリ内に.cursor/mcp.jsonを作成してください。
- 以下の設定を貼り付け、ご自身のキーを入力してください。ファイルにすでにmcpServersがある場合は、maileraブロックだけを追加してください。
- Cursorの設定でMCPセクションを開き、maileraが有効で、ツール一覧が表示されることを確認してください。
mh_live_xxxをご自身のAPI keyに置き換えてください。
~/.cursor/mcp.json
{ "mcpServers": { "mailera": { "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer mh_live_xxx" } } }}実際のキーを含む.cursor/mcp.jsonをgitにコミットしないでください。個人用のキーにはホームディレクトリ内のファイルを使うか、チーム用に読み取り権限のみのキーを別途作成してください。
接続を確認
エージェントに「Maileraのメールボックスを一覧表示して」と依頼します。エージェントがlist_mailboxesを呼び出し、メールボックスと同期状態を返します。次に「noreply@…からの最新メールを探してOTPを抽出して」と試してください。
ツール一覧と安全な利用ガイドよくあるエラー
- 401 unauthorized
- キーが無効、失効済み、またはBearerが不足しています。ヘッダーはAuthorization: Bearer mh_live_…の形式にしてください。
- send_emailやrescue_spamが見つからない
- キーに必要な権限（send、move）がありません。Maileraはキーの権限に対応するツールのみを表示します。必要な権限を持つキーを新しく作成してください。
- エージェントがメールボックスを見つけられない
- キーの利用範囲がメールボックスのないグループに制限されているか、ワークスペースにメールボックスが接続されていません。
- 429 rate_limited
- このキーのリクエストが毎分300回を超えました。Retry-Afterで指定された秒数だけ待ってから、再試行してください。
CursorでMaileraを使う
「設定 → API key」でキーを作成し、権限を選択します。まずはread権限だけで始められます。