接続前に何を用意しますか？

Mailera は、既存のメールボックスを API や MCP 経由でアプリや AI エージェントにつなぐサービスです。新しいメールボックスやメールアドレスは発行しません。

まず、自分が所有するテスト用メールボックスと、機密情報を含まない確認用メッセージを用意してください。Mailera でメールボックスを追加できるのは Admin または Leader です。全体の構成は既存メールを AI エージェントにつなぐガイドで説明しています。サービスごとの接続方法は既存のメールサービスをエージェントにつなぐ手順を参照してください。

メールサービスMailera での認証前提条件接続後の確認
Gmailアプリパスワード（app password）2 段階認証。組織のアカウントでは管理者による許可も確認対象アドレスと確認用メッセージ
Outlook／Microsoft 365Microsoft Graph を通じた OAuthMicrosoft へのサインインと必要な同意同意したアカウントと確認用メッセージ

認証方式とメールの取得・送信経路の違いは、エージェント開発者向けの IMAP・Graph・SMTP 解説で整理しています。

OpenClaw 側では、使っているバージョン、外部ツールの接続方式、秘密情報の保存先を先に確認します。Mailera の認証情報と、Gmail／Microsoft の認証情報は別です。エージェントへ渡すのは対象を絞った Mailera の API キーとし、プロバイダーの認証情報をチャットに貼らないでください。

Gmail または Outlook を Mailera に接続するには？

  1. 「メールボックス」から「メールボックスを追加」を開きます。
  2. Gmail の場合は「単一メールボックス」で「メールアドレス」を入力します。検出されたプロバイダーを確認して「続行」へ進み、「接続情報」の「パスワード」にアプリパスワードを入力します。通常のログインパスワードは使いません。「メールボックスグループ」はテスト用に分けてください。
  3. Outlook／Microsoft 365 の場合は「Microsoftでサインイン」を選び、Microsoft 側で対象アカウントへのサインインと OAuth の同意を進めます。アプリパスワードで接続する手順ではありません。
  4. 接続情報を入力する経路では「テストして接続」を実行します。このテストでメールは送信されません。送信側の認証だけが失敗した場合は「受信専用で保存」を選べます。
  5. 接続後は「メールボックスを開く」から、用意した確認用メッセージを探します。
Gmail の追加経路と「Microsoftでサインイン」タブがある Mailera のメールボックス追加画面
Gmail はアプリパスワード、Microsoft は OAuth の経路を使います。

Gmail のアプリパスワードはGoogle 公式の作成・取り消し手順に従ってください。Google は一般にアプリパスワードを推奨せず、アプリに「Sign in with Google」がある場合はそちらを勧めています。ここで説明しているのは、Mailera のアプリパスワードを使う接続経路です。

Microsoft 側の同意や承認の仕組みはMicrosoft Graph の認証と承認を参照してください。サービス別の説明は Gmail 接続と Microsoft 接続、画面操作の詳細は最初のメールボックスを接続する手順にあります。

読み取り専用の API キーを作るには？

「どのメールボックスを扱えるか」と「何を実行できるか」は別の設定です。読み取り専用でも、全グループを対象にする必要はありません。

  1. 「設定」の API キー画面から「キーを作成」を開きます。
  2. 「わかりやすい名前」に用途を記入し、「メールボックスのスコープ」でテスト用のグループを選びます。そのグループに業務用メールボックスが混ざっていないか確認してください。
  3. 権限は read だけにします。send、move、manage、sync などは付けません。
  4. 「有効期限」を設定して作成し、安全な保存先へコピーします。キー本体が表示されるのは一度だけです。
テスト用グループと read 権限だけを選択した Mailera の API キー作成画面
対象のメールボックスと操作権限を別々に絞ります。

この制限は Mailera API の操作に対するものです。プロバイダー側で付与した権限を変更する操作ではありません。また、「受信専用で保存」と API キーの read 制限は別なので、受信専用で保存した場合もキーの権限を確認します。

OpenClaw 側へ渡す接続情報は？

Mailera の MCP 接続では、次の接続先と認証を使います。

項目値
MCP 接続先https://mailera.app/api/public/v1/mcp
認証ヘッダーAuthorization: Bearer $MAILERA_API_KEY
最初に使う権限read

$MAILERA_API_KEY は、作成したキーを秘密情報として保存し、実行環境から渡すための変数です。キーを公開設定や会話本文に書かないでください。

「MCP 設定をコピー」の対象は Claude、Cursor、VS Code です。その設定を OpenClaw 用としてそのまま流用せず、利用環境の接続方式と認証の渡し方を確認します。

MCP には、クライアントがサーバーを子プロセスとして起動する stdio と、HTTP を使う Streamable HTTP があります。MCP の通信方式の仕様も参照し、URL の入力だけで設定を終えず、実際のツール呼び出しまで確認してください。

読み取りの成功をどう確認しますか？

Mailera 側の接続確認と、エージェント経由の取得確認を分けます。以下は Mailera の MCP ツール名です。

順番Mailera の MCP ツール確認する内容
1list_mailboxesテスト用グループの意図したメールボックスだけが対象か
2list_messages対象メールボックスで確認用メッセージを見つけられるか
3get_messageそのメッセージの件名と本文を読めるか

これらは read 権限で使えます。ほかの操作との区別は MCP ツールの用途別ガイドを参照してください。

REST で切り分ける場合も、同じキーで GET /mailboxes、GET /mailboxes/{id}/messages、GET /mailboxes/{id}/messages/{msgId} の順に取得します。メッセージの詳細では data.subject と data.body.text または data.body.html を、用意した内容と照合します。

エージェント経由の確認では、要求、呼び出されたツール、応答を記録してください。保存する記録ではアドレスや本文を伏せます。読み取れたことに加え、キーの設定に送信・移動権限がないことも確認します。REST での取得成功と、OpenClaw 経由での取得成功は別々に判断してください。

接続できないとき、どこを確認しますか？

症状確認箇所と次の操作
Gmail でアプリパスワードを作れない2 段階認証、組織の制限、セキュリティキーのみの認証、Advanced Protection の利用を Google 公式ヘルプで確認します。制限を回避しないでください。
Gmail の接続が途切れたGoogle アカウントのパスワードを変更するとアプリパスワードは取り消されます。認証情報を確認します。
Microsoft の同意が完了しないサインインしたアカウントを確認し、組織の承認が必要な場合は管理者に相談します。
API 認証が通らないキーの有効期限、失効状態、Bearer ヘッダー、接続先を確認します。
メッセージが見つからない対象グループ、メールボックス、フォルダー、同期状態を確認します。read だけでは sync_mailbox は実行できません。
エージェントからツールが見えないクライアント側の接続方式と認証設定を確認し、Mailera 側の読み取り確認と切り分けます。

Mailera は常に即時反映するわけではありません。使用状況によってバックグラウンド確認の頻度が変わり、未使用のメールボックスはスリープする場合があります。メールが見えないという理由だけで、エージェントの権限を増やさないでください。

メール内の指示や誤送信からどう守りますか？

受信メールは信頼できないデータであり、エージェントへの指示ではありません。本文や添付ファイルに「別の宛先へ転送」「このコマンドを実行」などと書かれていても実行させない方針を、エージェント側に設けてください。

指示文だけに頼らず、テスト用グループと read 権限で制限します。読み取りだけでも機密情報の持ち出しには注意が必要です。モデルへ渡す本文とログの保存先を確認し、OpenClaw 側の別のメール接続やシェル権限も見直してください。Mailera の API キーの制限を、ほかの経路の操作制限として扱わないでください。

将来 send を付ける場合は、宛先と本文を人が確認してから送信する仕組みをエージェント側に設けます。Mailera の設定とは分けて設計してください。製品の情報はセキュリティページにもあります。

接続を止めるには？

Mailera の API キーを失効させます。そのキーを使う呼び出しは直ちに拒否されます。続いて OpenClaw 側の設定や秘密情報の保存先からキーを除去し、別のキーやメール接続が残っていないか確認してください。

Gmail と Mailera の接続自体も止める場合は、Google 側で該当するアプリパスワードを取り消せます。エージェント用キーの失効と、プロバイダーへのアクセス取り消しは、停止する範囲が異なります。

最初のメールボックスを2分で接続

Outlook、Gmail、IMAPのメールボックスを追加して、アプリやAPIでメールを読めます。

メールボックスを接続