MCPAIエージェントメールチュートリアル

AIエージェントにメールへのアクセスを与える方法(2026年完全ガイド)

Gmail、Outlook、iCloud、Fastmail、IMAPの本物の受信トレイへの読み取りと送信のアクセスを、MCP経由でAIエージェントに与える方法。仕組み、ツール、セキュリティ、設定手順。

MCP経由でAIエージェントにメールへのアクセスを与える方法:MCPEmails

AIエージェントにメールへのアクセスを与えるには、受信トレイをMCPサーバーに接続し、エージェントにエンドポイントのURLを1つ指定します。するとエージェントは、メールの閲覧、検索、送信のための小さなツール一式を手にします。難しいのはエージェント側ではありません。パスワードをプロンプト、ログ、ベクトルストアに漏らさずにこれをやることです。このガイドは、その最後の一歩についてのものです。

最短経路だけ知りたいなら、ダッシュボードで受信トレイを接続し、MCPエンドポイントをclaude.ai、Claude Desktop、Cursor、または自作のエージェントに貼り付けて、最初にinbox_listを呼んでください。この記事の残りでは、実際に何が起きているのか、なぜセキュリティモデルが重要なのか、対応しているすべてのプロバイダーをどうつなぐのかを説明します。

「MCP経由のメール」とは実際に何か

Model Context Protocolは、HTTP越しに言語モデルへツールを公開する標準的な方法です。MCPメールサーバーは、受信トレイを生のIMAPとしてではなく、エージェントが呼び出せる少数の型付きの動詞として提示します。メッセージを一覧する、1通読む、検索する、送信する、返信する。エージェントはこれらの動詞のうえで推論します。下層のメールボックスのプロトコルに触れることはなく、認証情報を目にすることもありません。

それがMCPEmailsの考え方のすべてです。エンドポイント1つ、ツール一式、MCP対応のあらゆるクライアント。アーキテクチャを一から知りたければ、関連記事MCPメールサーバーとは何かが平易に説明しています。

最後の一歩が難しい理由

モデルをメールにつなぐのは、実際にやってみるまでは簡単に見えます。3つの点でつまずきます。

  1. 認証がプロバイダーごとに違う。 OutlookとMicrosoft 365は、Microsoftのサインインを通じたOAuthを求めます。GmailはGoogleのアプリ パスワードを求め、Googleは2 段階認証プロセスが有効なときにしかそれを作らせません。iCloudとFastmailはアプリ用のパスワードを求めます。それぞれに独自のトークン更新サイクルと、独自の失敗のしかたがあります。
  2. 認証情報は危険物である。 チャットの記録やログの行に置かれたメールボックスのパスワードは、侵害が起きるのを待っているだけです。モデルにシークレットを持たせてはいけません。
  3. メールはエージェントに向かない形をしている。 MIME、スレッドのヘッダー、HTMLとプレーンテキスト、添付ファイル、実はラベルであるフォルダー。モデルに必要なのは整った応答であって、RFC 5322ではありません。

素朴な自作の解決策、つまりモデルにIMAPライブラリとパスワードを渡す方法は、この3つすべてに一度に失敗します。GitHubの「Gmail MCPサーバー」リポジトリの多くは、まさにそこで止まっています。

MCPEmailsはどう解決するか

4つの設計上の決定が重い仕事を担っています。私が自分の受信トレイを預けている理由でもあります。

メールはその場で取得され、一切保存されない

すべてのツール呼び出しはプロバイダーにリアルタイムにアクセスします。Gmail、iCloud、FastmailなどはIMAP/SMTP、OutlookはMicrosoft Graphです。メッセージ本文、件名、添付ファイルはエージェントに渡され、すぐに破棄されます。キャッシュも、インデックスも、蓄積もしません。受信トレイごとに永続化されるのは、次の呼び出しに必要な認証情報だけです。これがなぜ重要かの長い説明は「メールを一切保存しない」ことが重要な理由をご覧ください。

認証情報は保存時にAES-256-GCMで暗号化される

各受信トレイのアプリ パスワードやOAuthトークンは、データベースに書き込まれる前に暗号化されます。復号されるのはリクエストに必要なときだけで、私たちのサーバー上で行われ、エージェントに送られることはありません。暗号鍵はデータベースとは別にサーバーのシークレットとして管理しています。そのため、データベースが漏れても攻撃者が手にするのは暗号文であって、あなたの受信トレイではありません。

送信は自分のプロバイダーを経由する

エージェントが送信や返信をするとき、メールはあなたのGmail、あなたのMicrosoft 365、あなたのSMTPサーバーから出ていきます。MCPEmailsが自分のドメインから中継することはありません。到達性とドメインの評判は完全にあなたのものに保たれ、共有IPのせいで迷惑メールフォルダー行きになる運試しもありません。

標準のMCP over HTTPである

サーバーはMCP 2025-06-18仕様のStreamable HTTPに対応しています。インストールするSDKも、独自のクライアントもありません。MCPに対応するものなら何にでもそのまま組み込めます。

エージェントが手にするツール

アクションベースに統合された少数のツールが、全体をカバーします。閲覧、作成、整理に加えて、フォルダー、予約送信、連絡先のためのツールです。エージェントは必ずinbox_listから始めて、何が接続されているかを調べ、各受信トレイのIDを取得します。UUIDをハードコードすることはありません。

  • inbox_list:接続済みのアカウントとその機能を検出する
  • email_read(アクションlist):受信トレイごとに、新しい順、ページ分割あり
  • email_read(アクションread):解析済みのプレーンテキスト、任意でサニタイズ済みHTML、任意で添付ファイル
  • email_read(アクションsearch):プロバイダー固有の構文(Gmailの演算子、OutlookのKQL、IMAPのテキスト検索)
  • email_compose(アクションsend):CC/BCC、HTML、合計10 MBまでの添付ファイル付きで作成
  • email_compose(アクションreply):同上。スレッドのヘッダー(In-Reply-To、References)を自動で設定
  • email_organize:移動、削除、フラグ付け、アーカイブ(1回の呼び出しに1アクション)

最初に知っておきたいことが1つあります。ツール自体はリクエスト/レスポンスで動きます。サーバーはエージェントが尋ねたときに答えるので、新着メールに反応するいちばん簡単な方法は、定期的なポーリングです。たとえばemail_read(アクションlist)をunread: trueで呼びます。プッシュがほしければ、ProとBusinessのワークスペースではダッシュボードのAPIキーでWebhookを追加できます。新着メールが届くとMCPEmailsが署名付きのPOSTをあなたのURLに送り、含まれるメッセージIDをエージェントがemail_readで開きます。自動応答の構築ガイドで、両方のパターンを示しています。

朝のトリアージの実行は、次のように読めます。

{
  "step1": "inbox_list                  → 仕事用のGmailを見つける",
  "step2": "email_read (action list)    → 過去24時間、unread: true",
  "step3": "email_read (action read)    → 急ぎのものは本文全体を読む",
  "step4": "email_compose (action reply) → 下書き、または要約だけして待つ"
}

パスワードは一度も通信路を通っていません。エージェントが持っていたのは認証情報ではなく権限です。ほかのアイデアは受信トレイにアクセスできるAIエージェントができる7つのことと、より詳しいトリアージと要約の手順をご覧ください。

対応プロバイダーと、それぞれの接続方法

受信トレイはダッシュボード → 受信トレイ → 受信トレイを接続で一度だけ接続します。認証の方法はプロバイダーによって異なります。

OAuthプロバイダー(ログインするだけ、パスワード不要)

  • Outlook / Microsoft 365:Sign in with Microsoft(Microsoftでサインイン)によるOAuth 2.0で、IMAPではなくMicrosoft Graphを使います。個人用のOutlook.com、Hotmail、Live、MSNアカウントはすぐに接続できます。職場または学校のMicrosoft 365アカウントでは、先にIT管理者が組織全体に対してアプリを一度承認する必要がある場合があります。ダッシュボードに、管理者へ送るためのリンクが表示されます。詳しい設定はOutlookとMicrosoft 365をAIエージェントに接続するをご覧ください。

アプリ パスワードのプロバイダー

Gmail、iCloud、Fastmail、Yahoo、Zoho、Yandex、そして汎用のIMAPメールボックスは、OAuthではなくアプリ用のパスワードで接続します。プロバイダーのセキュリティ設定でパスワードを生成し、MCPEmailsに貼り付けます。Gmailのアプリ パスワードはGoogleアカウントで作成し、Googleはその前に2 段階認証プロセスを必須にしています。iCloudのパスワードはappleid.apple.comで作成します。Fastmailはアプリ パスワードのみです(Fastmailの設定で作成します)。これらはすべて同じIMAP/SMTPの経路を通り、まったく同じ機能セットを共有します。詳しい手順はiCloud、Fastmail、任意のIMAP受信トレイをClaudeに接続するにあります。

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

同じエンドポイント、同じツール。入り口は、クライアントがOAuthに対応しているかどうかで2つに分かれます。

OAuth対応クライアント(APIキー不要)

claude.ai、Claude Desktop、Cursor、その他同様のクライアントは、OAuth 2.0のAuthorization Code + PKCEとRFC 7591のDynamic Client Registrationで接続します。claude.aiではカスタマイズ → コネクタ → コネクタを追加を開き、MCPエンドポイントのURLを貼り付けて「接続」をクリックし、MCPEmailsアカウントにログインして承認します。トークンのスコープは、同意画面で承認した範囲に限られます。読み取り専用、標準、フルアクセスのいずれか、または権限を個別に設定で選んだ権限だけです。手順を追った説明はClaudeと受信トレイを設定するとChatGPTにメールを追加するをご覧ください。

OAuthのないクライアント(APIキー)

Cline、JetBrains、自作のスクリプト、生のcURLは、スコープを絞ったAPIキーを使います。ダッシュボード → APIキーで作成し、スコープを選んでコピーします(表示は一度だけです)。Authorization: Bearer <api-key>として渡してください。これらの設定の全体はCursor、Cline、VS CodeのAIエージェントのためのメールに、2つの方式のトレードオフはAIメールアクセスにおけるOAuthとAPIキーの比較にあります。

どちらの場合も、接続はダッシュボードからワンクリックで取り消せます。正確なエンドポイントURLはドキュメントから取得してください。手で打ち込むのではなく、そこからコピーしてください。

これは安全か、そしてレート制限

結論は、はい、です。AIエージェントにメールへのアクセスを許可しても安全かで全体の論拠を示しています。モデルが持つのはパスワードではなくスコープ付きの権限で、認証情報は暗号化され、何も保存されず、送信はあなたのプロバイダーに留まり、アクセスはワンクリックで取り消せます。

レート制限については、各ワークスペースにプランに応じた毎分の上限があり(料金を参照)、各APIキーにはそのプランに合わせた毎分、毎時、毎日の枠があります。1つのキーが上限全体を使うこともできますし、複数のキーで分け合うこともできます。上限に達すると、サーバーは秒単位のretry_after値を含む再試行可能なエラーを返します。それに従ってください。そして、email_composeの送信を何も考えずに自動再試行しないでください。重複して送信することになります。

料金

プランの価格は接続する受信トレイの数で決まります。APIキーはすべてのプランで無制限で、プランによってバースト制限、分析履歴の長さ、チーム機能、サポートも異なります。

  • Free。 カード不要で、ずっと無料。受信トレイ1つ、利用状況の分析、ヘルプセンターとメールサポート。
  • Personal。 1人で使う前提で、受信トレイの追加、より高いバースト制限、より長い分析履歴、優先メールサポート。
  • Pro。 1人で事業を回す人向け。受信トレイをさらに追加、バースト制限もさらに高く、分析履歴は年単位、新着メールのWebhook。
  • Business。 Proのすべてに加えて、チーム向けで料金は1人ごと。各自のメールボックスは非公開のまま、共有メールボックスは会社全体で使えます(一定数を含み、それを超える分はメールボックス単位の追加料金)。ロール、保留された送信を承認する管理者、CSVでエクスポートできる監査ログ、クライアントや事業ごとの個別ワークスペース。

最新の価格と受信トレイ数は料金ページにあります。

始めるには

受信トレイを接続し、エンドポイントをエージェントに貼り付けて、inbox_listを呼ぶ。オンボーディングはそれだけです。無料で始めるか、クイックスタートにざっと目を通してください。数分後には、エージェントが本物のメールを読んでいます。

Asgeir Albretsen
執筆
Asgeir Albretsen

Asgeirは、AIエージェントがModel Context Protocolを通じて実際のメールを読み、検索し、送信できるようにする橋渡し役、MCPEmailsを開発しています。エージェント、メールインフラ、開発者体験について執筆しています。

エージェントに受信トレイを

Gmail、Outlook、Fastmail、あらゆるIMAPアカウントを、数分でAIエージェントに接続できます。