MinuteMail

MinuteMail MCP サーバー

MinuteMail を MCP（Model Context Protocol）ツールとして利用できます。AI エージェントや MCP クライアントから、一時メールボックス、メール、添付ファイル、カスタムドメイン、チーム、テスト用のモック OAuth ID を操作できます。メールや認証のフローをテストするのに便利です。

• エンドポイント： https://mcp.minutemail.co/mcp（ストリーミング可能な HTTP、プロトコルリビジョン 2025-06-18）
• 認証： ご自身の MinuteMail API キー（Bearer mmak_...）。このサーバーはステートレスなプロキシであり、独自の認証情報、セッション、ローカルストレージは保持しません。キーはそのまま MinuteMail API に転送され、スコープとクォータはそこで適用されます。すべての状態（メールボックス、メール、ID）は、その背後にある MinuteMail プラットフォームに保存されます。
• 公式 MCP レジストリでは io.github.minutemailco/mcp-server として、また Smitheryにも掲載されています。

API キーを取得する

1. minutemail.co で登録します（早期アクセス期間中は無料です）。

2. ダッシュボードで API キーを作成します。

3. MCP クライアントから Authorization ヘッダーとして送信するよう設定します。

   Authorization: Bearer mmak_XXXXXXXX

MCP クライアントを接続する

Claude Code／Claude Desktop／Cursor／ストリーミング可能な HTTP クライアント：

• URL：https://mcp.minutemail.co/mcp
• ヘッダー：Authorization: Bearer mmak_...

Claude Code CLI：

claude mcp add --transport http minutemail https://mcp.minutemail.co/mcp \
  --header "Authorization: Bearer mmak_XXXXXXXX"

Claude Desktop／mcpServers JSON 設定を使用するクライアント（例： claude_desktop_config.json／~/.cursor/mcp.json）：

{
  "mcpServers": {
    "minutemail": {
      "type": "http",
      "url": "https://mcp.minutemail.co/mcp",
      "headers": {
        "Authorization": "Bearer mmak_XXXXXXXX"
      }
    }
  }
}

一部のクライアント（古い Claude Desktop ビルドなど）は、JSON 設定でローカルの stdio サーバーのみをサポートしています。type: "http" が拒否される場合は、上記の URL とヘッダーを使って、組み込みのリモート／コネクター UI を使用するか、 mcp-remote を stdio ブリッジとして実行してください。

{
  "mcpServers": {
    "minutemail": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.minutemail.co/mcp",
        "--header",
        "Authorization: Bearer mmak_XXXXXXXX"
      ]
    }
  }
}

手順に沿ったガイドについては、ドキュメントをご覧ください： docs.minutemail.co/mcp/getting-started。

生の JSON-RPC（クライアント内部での動作）：

curl -s https://mcp.minutemail.co/mcp \
  -H 'Authorization: Bearer mmak_XXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"mailboxes.create","arguments":{"expiresIn":30}}}'

ツール（39）

各ツールは MinuteMail API のルートに 1 対 1 で対応しています。すべての呼び出しで Bearer API キーが必要です。書き込み操作には、対応するスコープ（mailboxes、domains、team、identities）が必要です。

メールボックス（mailboxes スコープ）

ツール	目的
mailboxes.list	アクティブなメールボックスを一覧表示します（任意でアドレスを完全一致検索できます）
mailboxes.create	メールボックスを作成します（TTL、ドメイン、リカバリータグは任意です）
mailboxes.get / mailboxes.delete	1 つのメールボックスを取得／削除します
mailboxes.delete_bulk	ID を指定して複数のメールボックスを削除します
mails.list / mails.inject	メールを一覧表示／受信メールをシミュレートします（添付ファイルを含むマルチパート形式）
mails.get / mails.delete / mails.delete_bulk	メールを読み取る／削除します
attachments.list / attachments.add / attachments.get / attachments.delete / attachments.delete_bulk	添付ファイルの CRUD 操作

アーカイブ済みメールボックス（mailboxes スコープ）

archived.list、archived.get、 archived.delete、archived.reactivate。

カスタムドメイン（domains スコープ）

domains.list、domains.register、domains.verify、domains.delete。

チーム（team スコープ）

team.members.list、team.members.add、team.members.get、team.members.delete、 team.invitations.create、team.invitations.list、team.invitations.delete。

モック ID と OAuth クライアント（identities スコープ）

identities.list、identities.create、identities.update、identities.get、 identities.delete、oauth.clients.list、oauth.clients.create、 oauth.clients.get、oauth.clients.delete、oauth.clients.rotate_secret。 identities.update は、プロフィールフィールド、isActive（有効化／無効化）、 emailVerified（email_verified クレームを制御）、および発行された ID トークンと userinfo レスポンスに マージされるカスタム claims を更新します。

ツールの結果は、API の JSON レスポンスを含む MCP テキストコンテンツとして返されます。2xx 以外のレスポンスは、 HTTP ステータスと本文を含む isError: true の結果になります（401 は無効なキー、403 はスコープ／ドメイン、 429 は残り回数を含むクォータ超過、502 はアップストリームの停止）。

エージェントの一般的なワークフロー

mailboxes.create (expiresIn 30)
        ↓
your app under test sends a verification email to the mailbox address
        ↓
mails.list → mails.get (extract the code / link)
        ↓
assert the flow completed — the mailbox expires on its own

セルフホスティング

このサーバーは、scratch イメージに含まれる単一の静的 Go バイナリです（約 7 MB）。

docker run -p 8080:8080 \
  -e API_BASE=https://api.minutemail.co \
  ghcr.io/minutemailco/mcp-server:latest
# or from Docker Hub:
docker run -p 8080:8080 \
  -e API_BASE=https://api.minutemail.co \
  chrptvn/minutemail-mcp:latest

セルフホスティングにも MinuteMail API キーが必要です。このサーバーはホストされた API のステートレスな プロキシであり、単独で動作する実装ではありません。セッションやローカルデータは保持せず、 すべてのメールボックス、メール、ID は、転送先の MinuteMail API に保存されます。

環境変数	デフォルト	用途
PORT	8080	リッスンポート
API_BASE	http://api-gateway:80	MinuteMail API のベース URL（クラスター外では https://api.minutemail.co を使用）
LOG_LEVEL	warn	debug／info／warn／error
LOG_FORMAT	json	json／text
PROFILE	dev	デプロイプロファイルのラベル

稼働状態の確認には GET /health、Prometheus カウンターには GET /metrics を使用します。 API キー管理機能は MCP 経由では公開されていません。キーはウェブアプリから管理してください。

開発

Go 1.23、標準ライブラリ、および prometheus/client_golang。

go test ./...     # unit tests
go vet ./...
go run .          # local server on :8080

ライセンス

MIT — © MinuteMail.co