必要な値は1つだけ
claude mcp add --transport http mcpemails https://mcpemails.com/api/mcpを実行し、Claude Codeに求められたらブラウザーで認証します。設定はこれだけです。APIキーも、手で編集する設定ファイルもありません。
| 項目 | 値 |
|---|---|
| MCPサーバーURL | https://mcpemails.com/api/mcp |
| トランスポート | Streamable HTTP (MCP 2025-06-18) |
| 認証 | OAuth 2.1、PKCE付き認可コード。APIキーは不要です。 |
Claude Codeの接続方法：OAuth、APIキー不要
Claude Codeはこのサーバーに対して標準のMCP OAuthフローを実行します。RFC 7591の動的クライアント登録で自身を登録するため、クライアントIDを作成する必要はなく、S256による認可コードとPKCEで認可します。クライアントシークレットが送信されることはなく、トークンには同意画面で承認したスコープだけが含まれます。取得したアクセストークンの有効期間は1時間で、自動で更新されます。ダッシュボードの「APIキー」にOAuth:とクライアント名の形で表示され、そこから接続を取り消せます。
Claude Codeを受信トレイに接続する方法
手順は4つです。最初の2つはどのクライアントでも同じで、残りはこのクライアント固有の手順です。
無料アカウントを作成してメールボックスを接続
mcpemails.comで新規登録し（カード登録は不要）、ダッシュボードの「受信トレイ」でメールボックスを接続します。受信トレイ1つはずっと無料です。
サーバーを追加
下のコマンドを実行します。--transport httpはStreamable HTTPトランスポートを指し、このサーバーが使うトランスポートです。
認証
Claude Codeのセッション内で/mcpを実行し、このサーバーを選んでブラウザーの手順に従います。ブラウザーが自動で開かない場合は、表示されたURLをコピーしてください。
何か頼んでみる
「今日の未読メールをすべて要約して」と試してください。Claude Codeは最初にinbox_listを呼び出してメールボックスを見つけるので、IDを貼り付ける必要はありません。
claude mcp add --transport http mcpemails https://mcpemails.com/api/mcpリモートMCPサーバーに関するClaude Codeの公式ドキュメント： https://code.claude.com/docs/en/mcp
どのメールボックスから接続するか迷っていますか。 プロバイダー互換性の一覧を見る
Claude Codeでつまずきやすいポイント
Claude CodeはMCPツールの定義を遅延読み込みし、ここではそれが利点になる
Claude Codeは既定で、セッション開始時にツール名とサーバーの指示だけを読み込み、必要になった時点で完全なスキーマを取得します。そのため、このサーバーを追加しても、素朴なMCPサーバーに比べてごく一部のコンテキストしか消費せず、使わないツールのスキーマがコンテキストを使うこともありません。
接続のスコープはセッションの目的に合わせる
トークンが有効な間にCLIが何をできるかは、OAuthの同意画面で決まります。メールを読むが送信はしないコーディングセッションなら、send:emailを含まないトークンにします。後から権限を広げたい場合は、再接続してより広い範囲を承認します。勝手に権限が広がることはありません。
エージェントループと送信スコープの組み合わせはよく考える
Claude Codeは長時間無人で動くことがあり、誤送信がいちばん痛いのはまさにそのときです。そのための切り替えが2つあります。トークンにsend:emailを含めないか、ダッシュボードで人による承認をオンにして、送信、返信、転送、予約送信のすべてを人の確認待ちにすることです。承認は受信トレイ単位で設定し、どのクライアントからの呼び出しにも適用されます。
知っておきたい制限
- リクエストにはキーごとに、プランに応じた1分、1時間、1日単位のレート制限があります。429レスポンスにはRetry-Afterが付きます。
- サーバーはリクエストとレスポンスだけで動作します。Webhookもサーバー発のイベントもないため、新着メールがエージェントを自動で起動することはありません。届いたメールに反応するには、定期的にポーリングしてください。
- メールは呼び出しのたびにプロバイダーからその場で取得され、保存されることはありません。保存するのは暗号化したOAuthトークンまたはアプリ パスワードだけなので、トークンを取り消すかメールボックスのパスワードを変更すれば、アクセスはすぐに終わります。
- OAuthフローでは一度だけブラウザーが必要です。ヘッドレスのマシンでは、AuthorizationヘッダーにAPIキーを指定してサーバーを追加すれば、フロー自体を省けます。そこでもOAuthを使いたい場合は、
--callback-portでコールバックを転送可能なポートに固定できます。
Claude Codeとメールに関するよくある質問
Claude Codeにメールを接続するには？
このMCPサーバーをURLで追加します：claude mcp add --transport http mcpemails https://mcpemails.com/api/mcp。次にセッション内で/mcpを実行し、ブラウザーでのログインを完了します。これでClaude Codeに、メールの閲覧、検索、送信、返信、転送、整理、予約送信のツールが加わります。
OAuthの代わりにAPIキーを使えますか？
はい。Claude Codeはaddコマンドでヘッダーを受け付けるので、ダッシュボードの「APIキー」で作成したBearerキーをAuthorizationヘッダーで渡せば、ブラウザーは一切不要です。ログインを完了する場所がないヘッドレスマシンやCIでは、これが適した方法です。
devcontainerやSSH経由でも使えますか？
はい。ただしOAuthフローでは一度だけブラウザーが必要です。ブラウザーのある環境でログインを完了するか、BearerのAPIキーヘッダーを付けてサーバーを追加し、フローを省いてください。それ以降は1つのエンドポイントへの通常のHTTPS通信です。
この方法でClaude Codeが使えるメールボックスは？
Outlook.comとMicrosoft 365は「Microsoftでサインイン」で接続します（職場アカウントでは、IT管理者による一度きりのアプリ承認が必要な場合があります）。Gmail、iCloud、Fastmail、Yahoo、Zoho、Yandexはアプリ パスワードで接続でき、標準ポートでIMAPとSMTPに対応するその他のメールボックスも使えます。クライアントはこれらすべてを同じ接続で扱います。エージェントは最初にinbox_listを呼び出して、接続済みのすべてのメールボックスとそのIDを取得するので、UUIDをどこかに貼り付ける必要はありません。
Claude Codeが私の知らないうちにメールを送信することはありますか？
許可した場合に限ります。送信にはsend:emailスコープが必要なので、このスコープを持たないキーやトークンでは一切送信できません。さらに、受信トレイのオーナーはダッシュボードで人による承認を必須にでき、その場合は送信、返信、転送、下書きの送信、予約送信のすべてが、人が許可するまで保留されます。
メールはサーバーに保存されますか？
いいえ。メッセージはすべて、それを求めたリクエストのためにプロバイダーからその場で取得され、そのままクライアントに渡されます。保存するのは、以降の呼び出しで認証するための暗号化したOAuthトークンまたはアプリ パスワードだけです。ダッシュボードで受信トレイを削除するか、プロバイダー側でアクセスを取り消せば、接続はすぐに切れます。