受信トレイをVS Codeに接続
Copilotエージェントモードで使う
開いているエディターに本物のメールボックスを追加できます。Copilotエージェントモードから、メールの閲覧、検索、送信、返信、転送、予約送信、整理ができます。
MCPEmailsが入力済みの状態でVS Codeが開きます。確認したら、続いて開くブラウザーのページでアカウントを作成し、受信トレイを選んでください。 VS Code Insidersにインストール
必要な値は1つだけ
コマンドパレットからMCP: Add Serverを実行し、HTTP (HTTP or Server-Sent Events)を選んでhttps://mcpemails.com/api/mcpを貼り付け、Global、続いてCopilot Globalを選びます。ログインの確認を承認すれば、MCPEmailsでの認可は完了です。APIキーは使いません。
| 項目 | 値 |
|---|---|
| MCPサーバーURL | https://mcpemails.com/api/mcp |
| トランスポート | Streamable HTTP (MCP 2025-06-18) |
| 認証 | OAuth 2.1、PKCE付き認可コード。APIキーは不要です。 |
VS Codeの接続方法：OAuth、APIキー不要
VS Codeはこのサーバーに対して標準のMCP OAuthフローを実行します。RFC 7591の動的クライアント登録で自身を登録するため、クライアントIDを作成する必要はなく、S256による認可コードとPKCEで認可します。クライアントシークレットが送信されることはなく、トークンには同意画面で承認したスコープだけが含まれます。取得したアクセストークンの有効期間は1時間で、自動で更新されます。ダッシュボードの「APIキー」にOAuth:とクライアント名の形で表示され、そこから接続を取り消せます。
VS Codeを受信トレイに接続する方法
手順は4つです。最初の2つはどのクライアントでも同じで、残りはこのクライアント固有の手順です。
無料アカウントを作成してメールボックスを接続
mcpemails.comで新規登録し（カード登録は不要）、ダッシュボードの「受信トレイ」でメールボックスを接続します。受信トレイ1つはずっと無料です。
MCP: Add Serverを実行
Shift+Cmd+P（WindowsとLinuxではShift+Ctrl+P）でコマンドパレットを開き、MCP: Add Serverを実行します。
HTTPとGlobalを選ぶ
HTTP (HTTP or Server-Sent Events)を選び、https://mcpemails.com/api/mcpを貼り付けて、サーバーIDにmcpemailsと入力します。保存先はGlobal、続いてCopilot Globalを選びます。VS Codeが下のエントリを~/.copilot/mcp-config.jsonに書き込みます。
認可
ログインの確認を承認し、MCPEmailsで認可します。Copilotに持たせたいスコープを承認してください。
{
"mcpServers": {
"mcpemails": {
"type": "http",
"url": "https://mcpemails.com/api/mcp"
}
}
}リモートMCPサーバーに関するVS Codeの公式ドキュメント： https://code.visualstudio.com/docs/copilot/customization/mcp-servers
詳しい手順をまとめた記事もあります。 Cursor、Cline、VS CodeのAIエージェントでメールを使う
どのメールボックスから接続するか迷っていますか。 プロバイダー互換性の一覧を見る
VS Codeでつまずきやすいポイント
トランスポートはstdioではなくHTTP、間違えても何も言われない
Add Serverの流れでは、最初にコマンドで起動するstdioサーバーが表示されます。多くのMCPサーバーはこちらの形式です。このサーバーはリモートでホストされているので、実行するコマンドはありません。HTTPを選んでください。設定のキーはtypeで、値はhttpです。URLを指すstdioのエントリを作ると、サーバーはいつまでも起動せず、理由もわかりません。
ツールが表示されるのはエージェントモードだけ
MCPのツールをCopilotが使えるのはエージェントモードです。接続に成功したのにツール選択欄にメールのツールがない場合、原因はたいてい、エージェントモードではなくaskモードやeditモードになっていることです。サーバーが実際に動いているかは、MCPビューで確認できます。
Globalを選び、キーをリポジトリに入れない
Globalを選ぶと、どのプロジェクトにも属さないホームフォルダーの~/.copilot/mcp-config.jsonに書き込まれます。トップレベルにserversオブジェクトを持つ従来の.vscode/mcp.jsonも引き続き動作しますが、ガイド付きの流れでは非推奨と表示され、コミットされうるプロジェクト内に置かれます。URLは公開されているもので、OAuthトークンはどちらのファイルにも書かれません。ただし、誰かが代わりにBearer APIキーを直接書き込んだ時点で話は変わります。リポジトリに入ってしまったキーは、ダッシュボードの「APIキー」から無効化してください。
知っておきたい制限
- リクエストにはキーごとに、プランに応じた1分、1時間、1日単位のレート制限があります。429レスポンスにはRetry-Afterが付きます。
- サーバーはリクエストとレスポンスだけで動作します。Webhookもサーバー発のイベントもないため、新着メールがエージェントを自動で起動することはありません。届いたメールに反応するには、定期的にポーリングしてください。
- メールは呼び出しのたびにプロバイダーからその場で取得され、保存されることはありません。保存するのは暗号化したOAuthトークンまたはアプリ パスワードだけなので、トークンを取り消すかメールボックスのパスワードを変更すれば、アクセスはすぐに終わります。
VS Codeとメールに関するよくある質問
VS Codeにメールを接続するには？
コマンドパレットからMCP: Add Serverを実行し、HTTPを選んでhttps://mcpemails.com/api/mcpを貼り付け、Global、続いてCopilot Globalを選んで、ログインの確認を承認します。これでCopilotエージェントモードに、メールの閲覧、検索、送信、返信、転送、整理、予約送信を行うツールが加わります。
VS CodeにはAPIキーが必要ですか？
いいえ。VS Codeはこのサーバーとの間でOAuthのブラウザーフローを実行するので、設定にトークンが書き込まれることはありません。ヘッドレスやスクリプトでの利用には、BearerのAPIキーも引き続き使えます。
他のエディターのCopilotでも使えますか？
Add ServerはVS Codeの機能なので、このページはVS Codeに絞って説明しています。JetBrains AI Assistantは別の設定で、OAuthではなくBearer APIキーを使います。専用のページがあります。
この方法でVS Codeが使えるメールボックスは？
Outlook.comとMicrosoft 365は「Microsoftでサインイン」で接続します（職場アカウントでは、IT管理者による一度きりのアプリ承認が必要な場合があります）。Gmail、iCloud、Fastmail、Yahoo、Zoho、Yandexはアプリ パスワードで接続でき、標準ポートでIMAPとSMTPに対応するその他のメールボックスも使えます。クライアントはこれらすべてを同じ接続で扱います。エージェントは最初にinbox_listを呼び出して、接続済みのすべてのメールボックスとそのIDを取得するので、UUIDをどこかに貼り付ける必要はありません。
VS Codeが私の知らないうちにメールを送信することはありますか？
許可した場合に限ります。送信にはsend:emailスコープが必要なので、このスコープを持たないキーやトークンでは一切送信できません。さらに、受信トレイのオーナーはダッシュボードで人による承認を必須にでき、その場合は送信、返信、転送、下書きの送信、予約送信のすべてが、人が許可するまで保留されます。
メールはサーバーに保存されますか？
いいえ。メッセージはすべて、それを求めたリクエストのためにプロバイダーからその場で取得され、そのままクライアントに渡されます。保存するのは、以降の呼び出しで認証するための暗号化したOAuthトークンまたはアプリ パスワードだけです。ダッシュボードで受信トレイを削除するか、プロバイダー側でアクセスを取り消せば、接続はすぐに切れます。