DearAgent：讓 AI 代理擁有自架信箱的 MCP 伺服器

DearAgent 是一個自架在 Cloudflare Workers 上的 AI 代理信箱 API，郵件存 D1、附件存 R2，定位為開源的 AgentMail 替代品，並透過 Worker 上的 /mcp 端點暴露無狀態 Streamable HTTP MCP 伺服器。

適合誰

• 適合想讓 AI 代理擁有真實收信能力的開發者：典型流程是建立收件匣、等待驗證郵件、讀取驗證連結。
• 前提明確：需要 Cloudflare 帳號、一個用於 Cloudflare Email Routing 的專用頂級網域、Node 20+ 並執行 npx wrangler login。接收郵件免費；只有寄送郵件才需要 Workers Paid。
• API 與 MCP 使用同一個 API_KEY 作為唯一 bearer 權杖，一把鑰匙擁有全部權限（單租戶），不適合需要細粒度權限隔離的多使用者場景。
• 不適合的情況：沒有自己的網域、無法接受自架部署與維護責任、或需要多租戶權限隔離的使用者。官方證據未說明的面向（如資料保留、刪除政策）屬未知，請自行確認。

3 分鐘完成第一次嘗試

官方推薦的唯一主路徑是複製儲存庫後執行互動式安裝腳本，它會自動設定 D1、R2、金鑰、Email Routing/Sending，完成部署並建立 catch-all 規則：

git clone https://github.com/panda-sandeep/dearagent && cd dearagent
npm install
npm run setup

前提：已 npx wrangler login 登入 Cloudflare，網域已可用於 Email Routing。腳本會引導設定必需的 API_KEY（也可用 npx wrangler secret put API_KEY 設定），該金鑰是 API 和 MCP 的唯一 bearer 權杖。

首次呼叫建議使用低風險的唯讀工具 list_inboxes：在 MCP 用戶端中設定指向 Worker 的 /mcp 端點並帶上 bearer 金鑰後，呼叫 list_inboxes。能回傳收件匣清單即表示部署和驗證成功。注意這是自架服務，不屬於遠端第三方託管寫入；create_inbox 會寫入你自己的 D1 資料庫。

如果你只想接收郵件，無需 Workers Paid；只有在準備呼叫 send_message 寄送郵件時，才確認已開通 Workers Paid，因為寄送會產生真實的對外郵件（不可由 MCP 層撤銷，需依 Email Sending 的實際行為評估）。

使用案例

案例一：讓代理自動完成註冊驗證。呼叫 create_inbox 建立一個收件匣，把該地址填入目標網站註冊表單，然後用 wait_for_message 等待驗證郵件到達，再讀取郵件內容中的驗證連結。這是官方描述的典型流程；工具回傳的是你自建服務中的真實郵件內容。

案例二：檢索歷史郵件。呼叫 search_messages 按關鍵字搜尋，或用 list_threads / get_thread 檢視會話、get_message 讀取具體郵件、get_attachment 取得附件。這些都是讀取你 D1/R2 中已有資料的查詢類操作，適合排查代理先前收到的郵件。

其餘工具（如 send_message、reply_to_message、forward_message、list_webhooks、create_webhook）在證據中被列為可用工具，但各自參數細節證據未給出，使用前請以儲存庫 README 為準。

使用邊界

• 讀寫性質：list_*、get_*、search_messages、wait_for_message 屬查詢類；create_inbox、create_webhook、send_message、reply_to_message、forward_message 會寫入資料或產生真實外寄動作，呼叫前應確認。
• 憑證與資料：單一 API_KEY 即可完全存取，請妥善保管；所有郵件資料存放在你自己的 Cloudflare D1/R2 中。
• 副作用：寄送郵件需要 Workers Paid 且會真實寄出；官方未說明寄送後的撤回機制，不能視為可撤銷操作。
• 未知項：官方證據未說明郵件保留期限、刪除工具、隱私處理細節，這些資訊尚未確認，不構成無風險的結論。