将您的AI助手连接到Unbox

概述

Unbox MCP 面向希望使用AI助手（在Cursor、Workbuddy、OpenClaw或任何兼容MCP的主机中）处理托管邮件的个人账户所有者。它不是用于在Unbox上构建应用的开发者API；如需从您的域名发送事务性邮件，请参阅我们的HTTP API文档。

代理能力

登录后，您的代理可以代表您调用Unbox工具：

• 读取收件箱和会话 — 列出会话、打开一个会话分支、获取单条消息。
• 搜索邮件 — 使用自然语言查询在收件箱中查找邮件。
• 发送与回复 — 从您的Unbox地址撰写新邮件或回复邮件主题，受您的套餐发送限制约束。
• 整理 — 标记为垃圾邮件、从垃圾邮件恢复、移至回收站或恢复 — 每次一条邮件。

批量清空垃圾邮件或回收站、API密钥生成以及团队工作区操作在v1版本中不可通过MCP使用。

工作原理

您的AI客户端连接到Unbox MCP服务器。该服务器使用正常的Web会话调用Unbox账户API — 与您在unbox.im登录时获得的会话相同。

1. 将Unbox添加到您的MCP客户端配置中（参见下方的设置）。
2. 让您的代理登录 — 它将打开一个浏览器链接，您在其中使用Unbox账户批准访问权限。
3. 连接后，让您的代理阅读邮件、起草回复或整理邮件。

登录

Unbox使用浏览器登录，因此您始终可以批准访问权限。您的代理使用登录工具开始流程，然后您在浏览器中完成登录：

1. 您的代理调用unbox_login_start并向您显示一个浏览器URL。
2. 打开链接，必要时登录Unbox，然后复制页面上显示的一次性链接代码。
3. 将代码粘贴回您的代理（unbox_login_complete）。
4. 您的会话在正常的Unbox Web会话期间保持有效 — 过期后请重新登录。

登录URL（供参考）

https://unbox.im/zh/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 访问权限仅限于个人账户所有者，团队成员或共享工作区无法使用。
• 与 Web 应用相同的限制 — 发送配额、垃圾邮件规则和事务性策略对代理操作的限制与收件箱 UI 中的限制相同。
• 无批量删除 — 在 v1 版本中，代理无法通过 MCP 清空垃圾邮件、清空回收站或轮换 API 密钥。