將您的 AI 助理連線至 Unbox

總覽

Unbox MCP 專為個人帳戶擁有者設計，讓您能在 Cursor、Workbuddy、OpenClaw 或任何相容 MCP 的主機中使用 AI 助理，協助處理代管郵件。這並非用於在 Unbox 上建構應用程式的開發者 API；如需從您的網域傳送交易郵件，請參閱我們的 HTTP API 文件。

AI 代理可執行的操作

登入後，您的 AI 代理即可代表您呼叫 Unbox 工具：

• 讀取收件匣與郵件串 — 列出對話、開啟郵件串，並取得個別郵件。
• 搜尋郵件 — 以自然語言查詢在您的收件匣中尋找郵件。
• 發送與回覆 — 從您的 Unbox 地址撰寫新郵件或回覆郵件串，並受方案寄送限制約束。
• 整理 — 標記為垃圾郵件、從垃圾郵件復原、移至資源回收筒或還原 — 一次處理一封信件。

批次清空垃圾郵件或回收筒、產生 API 金鑰，以及團隊工作區操作，在 v1 中無法透過 MCP 使用。

運作方式

您的 AI 客戶端連線至 Unbox MCP 伺服器。該伺服器使用一般網路工作階段 — 與您在 unbox.im 登入時相同 — 來呼叫 Unbox 帳戶的 API。

1. 將 Unbox 新增至您的 MCP 客戶端設定（請參閱下方的「設定」）。
2. 請您的代理程式登入 — 它會開啟一個瀏覽器連結，讓您使用 Unbox 帳戶授權存取。
3. 連線後，請您的代理程式讀取郵件、草擬回覆或整理信件。

登入

Unbox 使用瀏覽器登入，讓您隨時授權存取。您的代理程式以登入工具啟動流程，然後您在瀏覽器中完成登入：

1. 您的代理程式呼叫 unbox_login_start，並顯示一個瀏覽器網址。
2. 開啟連結，如有需要請登入 Unbox，然後複製頁面上顯示的一次性連結代碼。
3. 將代碼貼回您的代理程式 (unbox_login_complete)。
4. 您的工作階段在正常 Unbox 網路工作階段期間內保持有效 — 到期時請重新登入。

登入網址（僅供參考）

https://unbox.im/zh-TW/auth/desktop/link?source=mcp

還沒有帳戶？建立您的 Unbox ID，然後再回來連接您的代理程式。

設定

在您的 AI 客戶端中將 Unbox 新增為 MCP 伺服器。遠端 HTTP 傳輸是連線至 Unbox 雲端最簡單的方式：

遠端 HTTP（建議）

將您的 MCP 客戶端指向 Unbox MCP 端點。新增伺服器後，使用登入工具進行驗證：

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

在某些部署環境中，HTTP MCP 可能被停用，直到管理員啟用。如果連線失敗，請稍後再試或聯絡支援。

常用工具

登入後，您的代理程式可以使用以下工具：

• unbox_login_start — 開啟瀏覽器登入
• unbox_login_complete — 交換連結代碼以取得工作階段
• unbox_list_threads — 收件匣動態
• unbox_search_inbox — 搜尋郵件
• unbox_reply_to_email — 回覆郵件
• unbox_send_email — 寄送新郵件

支援的客戶端

任何相容 MCP 的代理主機皆可連線至 Unbox。我們已測試並提供文件：

• Cursor — 在 Cursor 設定的 MCP 伺服器下新增 Unbox，然後透過瀏覽器流程登入。
• Workbuddy — 設定指向 Unbox 的遠端 MCP 伺服器 URL，然後使用您的帳戶進行驗證。
• OpenClaw — 將 OpenClaw 連線至 Unbox 的 MCP HTTP 端點，並完成瀏覽器登入。

安全性

• 瀏覽器登入 — 您可以透過瀏覽器在 Unbox 上登入 — 代理程式永遠不會看到您的密碼。
• 僅帳戶擁有者 — MCP 存取權限僅限於個人帳戶擁有者，不包含團隊成員或共用工作區。
• 與網頁應用程式相同的限制 — 寄件配額、垃圾郵件規則及交易政策對代理程式動作的適用方式，與收件匣 UI 相同。
• 無批次刪除 — 代理程式無法在 v1 中透過 MCP 清空垃圾郵件、清空垃圾桶或輪替 API 金鑰。