三种邮箱接入 MCP，先检查什么？
你需要的是让 AI 读取已有邮箱，而不是再申请一个地址。Mailera 通过 MCP 向 AI 智能体提供邮件工具，连接的是你已有且有权访问的邮箱；Mailera 不创建邮箱或邮箱地址。
接入分两段：服务商允许 Mailera 连接邮箱，AI 客户端再凭 API 密钥调用 Mailera 的工具。前一段看 IMAP 与认证设置，后一段看密钥权限和邮箱范围。总体结构见已有邮箱的 MCP 接入总览，客户端支持与端点见 Mailera MCP 页面。
Zoho、Naver 和 Daum 的要求有什么不同？
下表列出 Mailera 的预设连接要求。应用专用密码（app password）用于邮箱客户端连接，不要用普通登录密码代替。
| 服务商 | IMAP 与认证前提 | Mailera 预设收件服务器 | 发件设置 |
|---|---|---|---|
| Zoho | 开启 IMAP；预设使用应用专用密码。Zoho 开启两步验证后，IMAP 客户端需使用应用专用密码 | imap.zoho.com，993，TLS；须核对账户对应服务器 | smtp.zoho.com，587，STARTTLS；需单独测试 |
| Naver | 开启两步验证和 IMAP，使用应用专用密码 | imap.naver.com，993，TLS | smtp.naver.com，587，STARTTLS；需单独测试 |
| Daum | 开启两步验证和 IMAP，使用应用专用密码 | imap.daum.net，993，TLS | Mailera 当前仅收件 |
Zoho 不能只照抄默认主机。Zoho 官方 IMAP 说明（查阅日期：2026-10-25）要求先勾选 IMAP 部分的“IMAP Access”，并说明服务器取决于账户类型和数据中心，应查看账户内的“Server Configurations Details”。付费组织的自定义域名邮箱，文档列出的收件服务器是 imappro.zoho.com，端口 993，使用 SSL。
同一文档还说明，新注册的免费套餐用户没有 IMAP 功能；组织用户需确认管理员的邮件策略允许 IMAP。遇到这类限制，修改密码或更换 MCP 客户端不能解决问题。
Naver、Daum 按添加邮箱页面的“准备事项”和“如何获取应用密码”入口处理账户设置。Daum 对应 Kakao 账户安全设置，daum.net 与 hanmail.net 都使用 Daum 连接路径。
如何把已有邮箱连接到 Mailera？
- 由管理员或主管进入“邮箱列表”→“添加邮箱”，选择“单个邮箱”。在“邮箱地址”中输入地址，核对服务商识别结果；不正确时，在“或选择服务商”中手动选择。
- 完成对应服务商的 IMAP 与认证设置。在“连接信息”的“密码”字段填入应用专用密码，并用“邮箱分组”把测试邮箱放到单独的组。
- 若 Zoho 账户显示的服务器与预设不同，使用“自定义 IMAP”，按账户内的服务器信息填写“收件服务器（IMAP）”及可选的“发件服务器（SMTP）”。
- 选择“测试并连接”，分别查看“收件服务器登录”“文件夹检测”和“发件服务器登录”。测试只检查连接，不会发送邮件；没有发件服务器时，发件登录检查会跳过。
- 若收件成功、发件失败，可选择“保存为仅收件”，也可“修改信息”后“重新测试”。Daum 按仅收件路径完成连接，不要为了完成读取测试反复修改发件配置。
连接完成后，回到“邮箱列表”确认状态。再从自己的另一个测试邮箱发送一封主题为“邮箱 MCP 接入测试”的邮件，正文只放无敏感信息的测试文字。接下来用这封邮件核对工具结果，而不是只看连接成功提示。
如何配置 MCP 并验证读取和搜索？
进入“设置”的 API 密钥区域，选择“创建 API key”。在“邮箱范围”中选中测试邮箱所在组，只授予 read 权限，并设置“有效期”。管理员也能选择所有分组，但读取测试不需要这么大的范围。
新密钥只显示一次。保存后，使用同一对话框中的“复制 MCP 配置”，选择 Claude、Cursor 或 VS Code，再把配置放入对应客户端。端点为 https://mailera.app/api/public/v1/mcp。不要把含认证信息的配置贴进聊天或截图。
如果你使用 VS Code，配置位置与客户端测试步骤见 VS Code 邮箱 MCP 配置与测试指南。
客户端应读取服务端提供的工具定义。MCP 工具规范说明，客户端通过 tools/list 发现工具，工具的 inputSchema 定义调用参数。限定邮箱时按实际工具定义填写，不要把 REST 参数名直接套到 MCP 上。
按下面的顺序验证；这些读取工具都使用 read 权限。
| 步骤与工具 | 要核对的结果 | 不符合时怎么办 |
|---|---|---|
1. list_mailboxes | 能看到目标测试邮箱 | 检查密钥的邮箱组范围；若工具本身不可见，检查客户端 MCP 配置 |
2. list_messages | 在目标邮箱、目标文件夹找到测试主题 | 检查文件夹及最近同步，不要立即重建连接 |
3. get_message | 正文与自己写的测试内容一致 | 确认选中的是同一邮箱中的同一封邮件 |
4. search_messages | 限定目标邮箱，按测试主题搜索，找到同一封邮件 | 核对搜索条件与工具定义，再检查同步状态 |
可以向客户端明确提出：“只访问测试邮箱组，列出目标邮箱中的邮件，读取主题为‘邮箱 MCP 接入测试’的邮件，再搜索同一主题。不要发送、移动或同步邮件。”这段要求用于说明任务，真正的访问边界仍由 API 密钥控制。
哪些邮箱可以发送或回复？
Zoho、Naver 的发件登录检查通过后，再进行实际发送测试。send_email、reply_to_email 和 get_send_status 都需要 send 权限，只有 read 的密钥不能使用它们。增加权限前，先明确任务确实需要发送，而不只是生成回复草稿。
- 由你确认收件人是自己的测试邮箱，并核对正文、附件。
- 让客户端按工具定义调用
send_email；测试回复时使用reply_to_email。 - 用
get_send_status查询发送结果，再到收件邮箱确认邮件是否收到。
收件登录成功、发送请求被受理、发送状态成功和收件方实际收到，是不同的检查点。
Zoho 的发件服务器也有账户差异。Zoho 官方 SMTP 说明（查阅日期：2026-10-25）为付费组织的自定义域名邮箱列出 smtppro.zoho.com、端口 587、TLS；发件地址须匹配认证账户的地址或别名。
Daum 在 Mailera 当前因 SMTP 端口受限而仅支持收信，hanmail.net 也一样。增加 send 权限不能恢复发送或回复。这是 Mailera 当前的连接限制，不是说 Daum 服务商完全不支持 SMTP。
常见错误：连接失败或读不到新邮件怎么办？
先判断故障发生在邮箱连接、客户端配置，还是邮件同步阶段。
| 现象 | 检查项 | 下一步 |
|---|---|---|
| 收件认证失败 | 应用专用密码是否填对；IMAP、两步验证及账户限制 | 修正对应设置，再测试连接 |
| Zoho 持续连接失败 | 账户类型、数据中心、套餐和管理员策略 | 按账户内服务器信息配置，不反复套用 imap.zoho.com |
| 客户端没有 Mailera 工具 | MCP 配置是否放入正确位置，认证信息是否完整 | 核对从“复制 MCP 配置”导出的内容 |
| 工具可见但调用被拒绝 | 密钥是否过期或已撤销；是否有 read 权限 | 更正密钥或权限后重试 |
| 能列出邮箱，但没有目标邮箱 | 密钥“邮箱范围”与目标邮箱所属分组 | 核对分组，不要直接扩大到所有邮箱 |
| 邮箱已连接，新邮件却未出现 | 收件箱与垃圾邮件文件夹、最近同步、休眠状态 | 确认服务商邮箱已收到，再检查同步 |
对 Zoho、Naver、Daum，get_mailbox_status 基于最近同步结果，不是每次调用都直接向服务商重新验证登录。状态正常也不表示刚到的邮件已经同步。
后台检查会随使用状态调整，闲置邮箱可能休眠，因此 Mailera 不承诺绝对实时同步。确实需要主动刷新时，可单独授予 sync 权限后调用 sync_mailbox，它也能唤醒休眠邮箱；只读密钥不能执行该操作。
让 AI 读取邮件时，怎样控制风险？
邮件正文、附件和链接都是不可信数据，不是给 agent 的新指令。即使邮件声称来自管理员，也不要执行其中要求泄露密钥、扩大权限或转发资料的指示。这是防范提示词注入的基本边界。
默认只开放指定邮箱组的 read 权限。需要发送、移动或主动同步时，再分别考虑 send、move、sync。只读仍然允许读取敏感内容，因此测试应使用自己的测试邮箱，日志中尽量少保留正文和个人信息。
发送或回复前，在客户端或工作流中要求人工确认收件人、正文和附件。MCP 工具规范建议对敏感操作请求用户确认，但这不等于协议或 Mailera 会自动拦住所有危险操作。
提前熟悉 API 密钥管理中的撤销操作：密钥撤销后，使用它的调用会立即被拒绝。截图时遮盖 API 密钥、应用专用密码、邮箱地址及私人邮件；相关产品说明见 Mailera 安全页面。
Mailera 不能解除服务商的 IMAP、套餐或账户安全限制，也不是这些服务商的官方合作伙伴。
