まず何をすれば接続できますか？

最初の目標は、既存のメールアカウントを 1 件接続し、テストメールの件名と本文を Mailera で確認することです。AI クライアントの設定は、受信を確認してから進めます。

Mailera は、既存のメールボックスを REST API、MCP、webhook 経由でアプリや AI エージェントにつなぐサービスです。新しいメールボックスやメールアドレスは作成しません。構成の全体像は、既存メールを AI エージェントで使う方法で説明しています。

接続前に何を用意すればよいですか？

自分が所有する、または利用許可を得たメールアカウントを用意します。Mailera で追加操作ができるのは、管理者（Admin）またはリーダー（Leader）です。

提供元Mailera での認証方法事前に用意・確認するもの
Outlook／Hotmail／Microsoft 365OAuth接続する Microsoft アカウントと、要求される権限への同意
Gmail／Google Workspaceアプリパスワード（app password）2 段階認証、組織での利用許可
iCloud Mailアプリ用パスワードApple Account の 2 ファクタ認証
独自 IMAPサーバー指定の認証情報IMAP のサーバー、ポート、暗号化方式。送信する場合は SMTP 設定も必要

Gmail の利用条件は、Google のアプリパスワード公式案内で確認してください。職場や学校などのアカウントでは、アプリパスワードを利用できない場合があります。発行から接続までの詳しい手順は、Gmail のアプリパスワード設定にまとめています。

iCloud は、Apple のアプリ用パスワード公式案内を参照してください。生成と利用には 2 ファクタ認証が必要です。Proton Mail と Tuta は Mailera の接続対象外です。

最初のメールボックスを追加するには？

  1. 追加画面を開きます。「メールボックス」から「メールボックスを追加」を選びます。ここでは 1 件ずつ接続し、一括取り込みや既存 token の取り込みは使いません。
  2. 提供元を確認します。「単一メールボックス」の「メールアドレス」に入力し、自動判定された提供元を確認します。必要なら「またはプロバイダーを選択」で選び直し、「続行」を押します。独自ドメインでも、利用しているサービスに合わせて選んでください。
  3. Microsoft は OAuth で認証します。 Outlook、Hotmail、Microsoft 365 は「Microsoftでサインイン」タブから、接続するアカウントでサインインして同意を進めます。アプリパスワードは使いません。Microsoft 接続の案内も参照できます。
  4. Gmail などはアプリパスワードを入力します。「アプリパスワードの取得方法」と「必要なもの」を確認し、「接続情報」の「パスワード」に入力します。普段のログインパスワードではありません。必要に応じて「表示名」「メールボックスグループ」を指定します。Gmail 接続の案内でも条件を確認できます。
Mailera のメールボックス追加画面。Microsoft 認証用タブと提供元の選択欄。
Microsoft は OAuth、それ以外は提供元に合った認証方法で接続します。

Microsoft の同意画面では、まだ承認していない権限への同意を求められます。仕組みは Microsoft の OAuth 公式資料、Mailera での流れは Outlook を OAuth で接続する手順を参照してください。

独自サーバーを使う場合は「カスタムIMAP」を選び、「受信サーバー（IMAP）」のサーバー、ポート、セキュリティを指定します。「設定を検出」で公開設定が見つかった場合も、提供元の設定値と照合してください。「送信サーバー（SMTP）」は任意で、空欄なら受信専用です。詳細は IMAP／SMTP 接続の案内にあります。接続方式の違いを整理したい場合は、エージェント開発者向けの IMAP・Graph・SMTP 解説を参照してください。

接続に成功したことをどう確認しますか？

  1. 接続テストを実行します。「テストして接続」を押し、「受信サーバーへのサインイン」「フォルダーの検出」を確認します。送信設定があれば「送信サーバーへのサインイン」も確認します。送信サーバーが未設定なら、この項目はスキップされます。
  2. 初回のメール読み込みを確認します。 接続後は、保存期間内のメールが新しい順に読み込まれます。無料プランの保存期間は 30 日です。
  3. テストメールを開きます。 自分の別アカウントから、件名を「Mailera 受信テスト」、本文を「受信確認用のメールです。」などにしたメールを送ります。「統合受信トレイ」で接続したアカウントを選び、件名と本文が読めることを確認してください。機密情報は入れません。
追加したテスト用メールボックスが並ぶ Mailera のメールボックス一覧。
追加したメールボックスで、次にテストメールの受信を確認します。

接続テスト自体はメールを送信しません。 認証の成功と、実際の受信・送信は分けて判定します。

確認すること完了の目安
接続接続テストが完了し、対象メールボックスが保存されている
受信別アカウントから送ったテストメールの件名と本文を読める
送信送信対応の設定で別途テスト送信し、宛先で受信を確認できる

新着メールの即時反映は保証されません。バックグラウンドの確認頻度は利用状況によって変わるため、見つからないときは同期状態も確認します。

統合受信トレイでテストメールの件名と本文を確認している画面。
接続テストだけで終えず、実際のテストメールを開いて受信を確認します。

よくある接続エラーはどこを確認すればよいですか？

症状確認すること次の操作
メールボックスを追加できないMailera の役割が Admin または Leader かワークスペースの管理者に権限を確認する
Gmail の認証に失敗する通常のパスワードを使っていないか、アプリパスワードが失効していないか有効なアプリパスワードを入力し直す。発行できなければ組織の管理者に確認する
Microsoft の同意を完了できない接続する Microsoft アカウントと、画面に表示された要求権限接続するアカウントを確認し、表示された要求権限への同意を進める
受信できるが送信できないSMTP の設定と認証情報「受信専用で保存」、または「情報を編集」から修正して「再テスト」を選ぶ
メールが見つからない対象アカウント、フォルダー、迷惑メール、最終同期、保存期間テストメールの宛先を確認し、該当フォルダーと同期状態を見直す

Google アカウントのパスワードを変更すると、アプリパスワードは失効します。以前は接続できていた Gmail でも、変更後は認証情報の更新が必要です。

AI にメールを読ませる前に何を制限すべきですか？

Mailera へのメール接続と、AI クライアントへの API キー設定は別工程です。接続しただけで、任意の AI にアクセス権が渡るわけではありません。メールボックス認証用のアプリパスワードと、外部ツールに渡す Mailera の API キーも別物です。

最初のキーは、テスト用メールボックスを入れた 1 グループだけを対象にし、読み取り権限だけを付けてください。「設定」の API キー管理から「キーを作成」を開き、「メールボックスのスコープ」で対象を絞れます。

受信メールは、信頼できないデータであり、命令ではありません。本文に指示があっても、キーを開示したり、別のメールを転送したりしない設計にします。後から送信権限を付ける場合も、送信前に利用者の確認を挟んでください。不要な API キーは失効させると、そのキーを使う呼び出しは直ちに拒否されます。

接続後の実装はメールを読んで返信するエージェントの作り方、操作の制限はエージェントに任せてはいけないメール操作で扱います。キーを渡す前に、Mailera のセキュリティ案内も確認してください。

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

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

メールボックスを接続