必要な値は1つだけ
openclaw gateway stopでGatewayを停止し、openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauthを実行します。続けてopenclaw mcp login mcpemailsを実行し、ブラウザーで承認します。最後にopenclaw gateway startでGatewayを再起動します。
| 項目 | 値 |
|---|---|
| MCPサーバーURL | https://mcpemails.com/api/mcp |
| トランスポート | Streamable HTTP (MCP 2025-06-18) |
| 認証 | OAuth 2.1、PKCE付き認可コード。APIキーは不要です。 |
OpenClawの接続方法：OAuth、APIキー不要
OpenClaw組み込みのMCPクライアントは、auth: "oauth"で保存したHTTPサーバーに対して標準のMCP OAuthフローを実行します。RFC 7591の動的クライアント登録で自身を登録するため、クライアントIDを作成する必要はなく、S256による認可コードとPKCEで認可します。トークンには同意画面で承認したスコープだけが含まれ、有効期間は1時間で、自動で更新されます。トークンはOpenClawがGateway上に保存し、ダッシュボードの「APIキー」にOAuth: OpenClaw MCPとして表示されます。接続はそこから取り消せます。
OpenClawを受信トレイに接続する方法
手順は4つです。最初の2つはどのクライアントでも同じで、残りはこのクライアント固有の手順です。
無料アカウントを作成してメールボックスを接続
mcpemails.comで新規登録し（カード登録は不要）、ダッシュボードの「受信トレイ」でメールボックスを接続します。受信トレイ1つはずっと無料です。
OAuthでサーバーを保存
Gatewayを動かしているマシンでopenclaw gateway stopを実行し、続けてopenclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauthを実行します。これで~/.openclaw/openclaw.jsonのmcp.serversにエントリが書き込まれます。Gatewayの実行中は、OpenClawは保存済みサーバーの変更を受け付けません。
ターミナルからログイン
Gatewayを停止したままopenclaw mcp login mcpemailsを実行します。表示された認可URLを開き、OpenClawに持たせたいスコープを承認してください。OpenClawがブラウザーからのコールバックを受け取って認証情報を保存したら、openclaw gateway startを実行します。
またはControl UIからログイン
ターミナルでログインする代わりに、Gatewayを起動し、Control UIをGatewayのループバックアドレスか公開HTTPSアドレスで開いて、Settings → MCPに進む方法もあります。管理者としてmcpemailsサーバーのSign inを選び、ブラウザーでアクセスを承認してからSettingsに戻ります。プライベートアドレスやTailscale専用のアドレスでは、ターミナルからログインしてください。
接続を確認
openclaw mcp status --verboseを実行します。このコマンドはGatewayの実行中でも使えます。authorization-requiredと表示されたら、もう一度ログインしてください。あとは任意のチャネルで、エージェントに受信トレイの一覧を頼んでみましょう。
openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauthリモートMCPサーバーに関するOpenClawの公式ドキュメント： https://docs.openclaw.ai/tools/mcp
どのメールボックスから接続するか迷っていますか。 プロバイダー互換性の一覧を見る
OpenClawでつまずきやすいポイント
transportを指定しないとSSEになる
HTTPエントリでtransportを省略すると、OpenClawはsseを使います。このサーバーはStreamable HTTPで通信するので、必ず--transport streamable-httpを指定するか、SettingsでStreamable HTTPを選んでください。設定を手で書く場合、OpenClawが読むのはtransport: "streamable-http"という表記です。CLI流のtype: "http"は、openclaw mcp set経由でのみ受け付けられるか、openclaw doctor --fixで修正されます。
CLIでの変更にはGatewayの停止が必要
openclaw mcp add、login、probe、doctor --probeは、ローカルのGatewayがOpenClawの状態を握っている間は実行を拒否します。先に停止し、終わったら再起動してください。Gatewayがサーバー上にあり、ブラウザーが別のマシンにある場合、ループバックのコールバックはGatewayに届きません。ブラウザーに表示されたコードをコピーし、表示されるopenclaw mcp login mcpemails --codeコマンドで完了してください。
ログインの共有はメールボックスの共有
初期設定では、OAuthの認証情報は共有され、オペレーターが管理します。そのGateway上のすべてのエージェントが同じログインを使うため、エージェントにメッセージを送れる人なら誰でも、あなたのメールを読むよう頼めてしまいます。自分しか使わないチャネルに限定する、エージェントに読むだけをさせたいなら同意画面でsend:emailを外す、または受信トレイで人による承認を有効にして送信をすべて人の許可待ちにする、のいずれかを行ってください。OpenClawには、送信者ごとに自分のアカウントを接続するリクエスター単位のログインもあります。これにはgateway.publicOriginにGatewayの公開HTTPSアドレスを設定する必要があります。
保存できても動くとは限らない
OpenClawは、定義が動作するかを確かめずに保存します。また、まだログインが必要なサーバーは、そのターンをエラーにするのではなく、エージェントのツールから外されるだけです。エージェントがメールのツールがないと言う場合はopenclaw mcp status --verboseを実行してください。authorization-requiredなら、ログインの手順をやり直します。
知っておきたい制限
- リクエストはキーごとに、1分あたり100件、1時間あたり1,000件、1日あたり10,000件までに制限されます。
- サーバーはリクエストとレスポンスだけで動作します。Webhookもサーバー発のイベントもないため、新着メールがエージェントを自動で起動することはありません。届いたメールに反応するには、定期的にポーリングしてください。
- メールは呼び出しのたびにプロバイダーからその場で取得され、保存されることはありません。保存するのは暗号化したOAuthトークンまたはアプリ パスワードだけなので、トークンを取り消すかメールボックスのパスワードを変更すれば、アクセスはすぐに終わります。
OpenClawとメールに関するよくある質問
OpenClawにメールを接続するには？
Gatewayのマシンで、Gatewayを停止してからopenclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauthを実行し、openclaw mcp login mcpemailsでログインしてGatewayを再起動します。Control UIのSettingsにあるMCPからログインすることもできます。これでエージェントに、メールの閲覧、検索、下書き、送信、返信、転送、整理、予約送信を行うツールが加わります。
OpenClawにはAPIキーが必要ですか？
いいえ。OpenClawは自分でMCP OAuthフローを実行し、トークンをGateway上に保存します。HTTPエントリには静的なheadersマップも指定できるので、スコープを絞ったキーをAuthorization Bearerヘッダーで送る方法も使えます。ただし、auth oauthに設定したエントリでは静的なAuthorizationヘッダーは無視されるため、どちらか一方を使ってください。
メールのツールの一部だけをエージェントに見せられますか？
はい。openclaw mcp addの実行時に、ツール名のカンマ区切りリストか'email_*'のようなパターンを--includeで指定するか、設定のサーバーの下でtoolFilterを設定します。これでエージェントに見えるツールが絞られます。実際に何ができるかは、引き続き同意画面で承認したスコープで決まります。
この方法でOpenClawが使えるメールボックスは？
Outlook.comとMicrosoft 365は「Microsoftでサインイン」で接続します（職場アカウントでは、IT管理者による一度きりのアプリ承認が必要な場合があります）。Gmail、iCloud、Fastmail、Yahoo、Zoho、Yandexはアプリ パスワードで接続でき、標準ポートでIMAPとSMTPに対応するその他のメールボックスも使えます。エージェントは最初にinbox_listを呼び出して、接続済みのすべてのメールボックスとそのIDを取得するので、UUIDをどこかに貼り付ける必要はありません。
OpenClawが私の知らないうちにメールを送信することはありますか？
許可した場合に限ります。送信にはsend:emailスコープが必要なので、このスコープを持たないトークンでは一切送信できません。さらに、受信トレイのオーナーはダッシュボードで人による承認を必須にでき、その場合は送信、返信、転送、下書きの送信、予約送信のすべてが、人が許可するまで保留されます。チャットのチャネルをまたいで無人で動くエージェントなら、両方を使う価値があります。
メールはサーバーに保存されますか？
いいえ。メッセージはすべて、それを求めたリクエストのためにプロバイダーからその場で取得され、そのままエージェントに渡されます。保存するのは、以降の呼び出しで認証するための暗号化したOAuthトークンまたはアプリ パスワードだけです。ダッシュボードで受信トレイを削除するか、プロバイダー側でアクセスを取り消せば、接続はすぐに切れます。