Claude CodeやCursorにMCPでメール受信箱を追加

サーバーは1つ、クライアントは7つ

このサーバーは、Streamable HTTP経由でModel Context Protocolを話す、単一のHTTPSエンドポイントです。JSON-RPCを乗せたPOSTが1回、JSONの返答が1回、開いたままのストリームはありません。インストールするものも、ローカルで動かすものもなく、公開ドメインではサインアップするものもありません — 設定のすべてはこのURLです。

MCPエンドポイントhttps://grabmail.io/mcpコピー

どのMCPクライアントもリモートHTTPサーバーに対応していますが、それぞれ設定を別々のファイルに、少しずつ違うキー名で保持しています。以下の各セクションで、それぞれの正確な設定内容を示します。これらの形式は2026年9月時点のものです。それ以降に変更されている場合は、各クライアント自身のドキュメントが正となります。

シェルから、応答を確認する

どのクライアントにも触れる前に、サーバーが実在し、何を提供しているかを確認しましょう。トランスポートがごく普通のHTTPであるため、curl1回で十分です。

$ curl -s -X POST https://grabmail.io/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

"create_inbox"
"list_domains"
"list_messages"
"read_message"
"wait_for_message"
"delete_message"

これがうまくいけば、以下のどのクライアントも動くはずであり、それでもクライアントが失敗する場合は、サーバー側の問題ではなくクライアント側の設定の問題です。うまくいかない場合は、ネットワークがgrabmail.ioへのアウトバウンドHTTPSを許可しているか確認してください — それがネットワーク上必要なもののすべてです。

Claude Code

コマンド1つ、どのディレクトリからでも実行できます。これはユーザー単位でサーバーを登録するため、すべてのプロジェクトで使えるようになります。

$ claude mcp add --transport http grabmail https://grabmail.io/mcp

代わりにリポジトリ経由でチームと共有したい場合は、プロジェクトスコープにしてください。これによりルートに.mcp.jsonが書き込まれ、これはコミットされ、チームメンバーは承認を求められます。

$ claude mcp add --transport http --scope project grabmail https://grabmail.io/mcp

{
  "mcpServers": {
    "grabmail": {
      "type": "http",
      "url": "https://grabmail.io/mcp"
    }
  }
}

Claude Codeを再起動して/mcpを実行すると、grabmailが6つのツールとともに一覧に表示されます。このサーバーは、プロトコルのinitialize呼び出しに対して短い指示の一節でも応答し、それはClaude Codeによってモデルに渡されます — そのためエージェントは、エイリアスを渡してアドレスを待つべきことを、最初から知った状態で登場します。

Claude Desktop

リモートサーバーは、設定ファイルではなく、アプリケーションを通じて追加します。

1. 設定 → コネクタ → カスタムコネクタを追加。
2. https://grabmail.io/mcpを貼り付けてURLとし、名前を付けます。
3. 新しい会話を開始すると、コネクタの下にツールが表示されます。

claude_desktop_config.jsonでローカルサーバーしか扱えないバージョンでは、mcp-remoteでリモートエンドポイントをブリッジしてください。これはローカルプロセスとして動作し、そのURLへ転送します。

{
  "mcpServers": {
    "grabmail": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://grabmail.io/mcp"]
    }
  }
}

Cursor

Cursorは、プロジェクト内の.cursor/mcp.json(またはすべてのプロジェクト共通の~/.cursor/mcp.json)を読み込みます。リモートサーバーはurlとして指定します。

{
  "mcpServers": {
    "grabmail": {
      "url": "https://grabmail.io/mcp"
    }
  }
}

Cursorの設定 → MCPを開くと一覧表示され、そこでツールを有効化できます。エージェントモードでは、モデルが自分でそれらを呼び出します。チャットでは、名前を指定して呼んでもらうこともできます。

Windsurf

Windsurfは、サーバー設定を~/.codeium/windsurf/mcp_config.jsonに保持しており、リモートサーバーのキーはurlではなくserverUrlです — 形が異なる唯一の箇所です。

{
  "mcpServers": {
    "grabmail": {
      "serverUrl": "https://grabmail.io/mcp"
    }
  }
}

CascadeはMCPパネルからのリフレッシュ後にサーバーを一覧表示します。同じファイルは、Windsurfの設定 → Cascade → MCPサーバー → View raw configからも開けます。

VS Code

VS Codeのエージェントモードは、ワークスペース内の.vscode/mcp.json、またはコマンドパレットのMCP: Add Serverが書き込むユーザーレベルのファイルを読み込みます。サーバーはmcpServersではなくserversの下に置かれ、リモートサーバーはトランスポートを宣言します。

{
  "servers": {
    "grabmail": {
      "type": "http",
      "url": "https://grabmail.io/mcp"
    }
  }
}

エディタ内のエントリの上に、小さな「Start」リンクが表示されます。それをクリックすると、チャットのツールピッカーにツールが表示され、エージェントモードは、こちらから頼まなくてもそれらを呼び出します。

Codex CLIとGemini CLI

Codex CLIは、設定を~/.codex/config.tomlにTOML形式で保持しています。リモートサーバーは、urlを持つテーブルとして指定します。

[mcp_servers.grabmail]
url = "https://grabmail.io/mcp"

Gemini CLIは~/.gemini/settings.json(またはプロジェクト内の.gemini/settings.json)を読み込み、Streamable HTTPサーバーのキーはhttpUrlです。

{
  "mcpServers": {
    "grabmail": {
      "httpUrl": "https://grabmail.io/mcp"
    }
  }
}

どちらも、ローカルサーバーしか扱えないバージョンであれば、Claude Desktopで示したのと同じmcp-remoteブリッジ経由でこのエンドポイントに到達できます。command = "npx"、args = ["-y", "mcp-remote", "https://grabmail.io/mcp"]。

6つのツール

クライアントが何であれ、モデルには同じ名前の同じ6つのツールが見えます。呼び出しの間で管理すべき状態はなく、どのツールも、前の呼び出しが返さなかった引数を必要とすることはありません。

create_inbox

新しいアドレスをその場で作り、エイリアスと、どちらをどこで使うかを示すnext_stepとともに返します。サーバー側で何も予約されないため、失敗することはありません。任意で、読みやすいprefixを指定できます。

wait_for_message

そのアドレスにメッセージが届くまで、最大25秒ブロックし、それから全体を返します — 件名、送信者、プレーンテキスト、HTML。subject_containsやfrom_containsでフィルタでき、since_idを渡せば、すでにあったものは無視されます。何も届かないまま待機が終わるとtimed_outを返し、もう一度呼び出すよう促します。

read_message

idを指定して、1通のメッセージ全体を取得します。待機の時点ですでにメッセージ全体が返っているため、必要になることはほとんどありません。

list_messages

あるアドレスで待っているものすべてを、新しい順に、即座に返します — 何もない場合も含めて。

list_domains

誰でも使える公開ドメインの一覧です。フォームがそのうちの1つを拒否したときのためのものです。

delete_message

5日後を待たずに、今すぐメッセージを削除します。冪等であるため、リトライするエージェントにもコストはかかりません。

4つの呼び出しでできるサインアップのループ

これは、ほとんどのタスクが必要とする手順であり、クライアントが変わってもこれは変わりません。

1. create_inbox。アドレス、エイリアス、そしてどちらがどちらかを示すメモが返ってきます。
2. フォームにはエイリアスを入力します。サイトは、メールボックスに届きはするものの、それを開くことはできない、機能するアドレスを手にすることになります。
3. 送信直後に、そのアドレスに対してwait_for_messageを呼びます。subject_containsには、確認メールに含まれるはずの単語を設定します。これはブロックするため、エージェント側でループする必要はありません。
4. コードは、待機が返したメッセージの中にあります。たいていの場合、それ以上の呼び出しは一切必要ありません。

Sign up for a trial at https://app.example.com/signup with a fresh GrabMail inbox.
Use the ALIAS in the form, wait for the confirmation code with wait_for_message
on the ADDRESS, enter it, and tell me the resulting login.

エージェント自身の指示に何を書くか

サーバーは、接続時にモデルへ使い方を伝えますが、同じ4つのルールを自分自身のプロジェクト指示の中でも読んだモデルは、たいてい正しく守るのではなく、毎回正しく守るようになります。使っているクライアントが読み込むCLAUDE.md、.cursor/rules、.windsurfrules、AGENTS.md、GEMINI.mdのいずれかに、これを追加してください。

## Email

- To receive email, use the `grabmail` MCP server. Call `create_inbox` once per task.
- Put the **alias** it returns into forms; poll the **address** it returns with `wait_for_message`.
- Call `wait_for_message` right after submitting a form, with `subject_contains` set to a word
  you expect ("code", "verify", "confirm"). If it returns `timed_out`, call it again — up to
  three times — before concluding the mail was not sent.
- Never reuse an inbox across tasks. Never send anything confidential to one: it is public.

最も重要な2つのルールは、教えられなければエージェントが間違えるものです。フォームにはエイリアスを入力しアドレスをポーリングすること、そしてtimed_outを「メールが送信されなかった」ではなく「もう一度呼び出す」と捉えることです。AIエージェントが読める受信箱では、この2つを、待機がメールより先に返る理由も含めて詳しく扱っています。

うまくいかないとき

完了と呼ぶ前に

• 上のcurlを自分のマシンから実行すると、6つのツールが一覧表示される。
• 再起動後、クライアントのMCPパネルにサーバーが表示され、ツールが有効になっている。
• 使っているクライアントが読み込むファイルに、指示の一節が入っている。
• テストプロンプトでサインアップが完了する: フォームにはエイリアス、待機はアドレスに対して、コードが読み取られる。
• これらの受信箱に機密情報が送られることは決してない — これらは公開されている。

セットアップとしては、これがすべてです。同じサーバーは、MCPを話すあらゆるフレームワークから使え、MCPを使わずに構築されたエージェント — LangChainの素のツール関数、OpenAI Agents SDK、あるいは自分自身のループなど — に向けては、AIエージェント向けのメールで、同じ4つのステップのREST版を紹介しています。

質問