已有邮箱怎样接入 MCP？
邮箱 MCP 服务器把邮件操作作为工具提供给 AI 客户端。能否读取收件箱、搜索历史邮件或回复，取决于服务器提供哪些工具，以及你授予哪些权限，不取决于名称里是否有“邮件”二字。
MCP 官方规范定义的是应用连接外部数据和工具的方式。你仍然需要分别处理邮箱服务商认证，以及客户端访问 MCP 服务的认证。
在 Mailera MCP 中，Mailera 连接已有邮箱，不创建邮箱或新地址。Outlook 使用 Microsoft OAuth；其他连接方式可能使用应用专用密码。AI 客户端使用的是 Mailera API 密钥，不是邮箱密码。
怎样判断一个邮箱 MCP 服务器是否适合你？
先写清任务：只发送通知，还是要读已有邮件、跨邮箱搜索，并回复原来的会话？如果你需要后者，就不要把“支持 SMTP”当作读取能力的依据。
下面按方案类型列出检查项，不做产品排名。
| 方案类型 | 读取与搜索 | 认证与维护 | 访问范围与发送确认 |
|---|---|---|---|
| 仅发信工具 | 不满足读取已有邮箱的需求 | 检查发信凭据如何配置、由谁保管 | 检查发件身份限制，以及客户端发送前确认 |
| 可读写已有邮箱的自托管服务 | 核对实际工具列表和搜索范围 | 你控制部署与配置，也需要承担维护工作 | 检查是否有服务端权限限制，不能只靠提示词约束 |
| 托管连接服务 | 核对支持的邮箱、读取和搜索工具 | 减少自建服务工作，但要审查凭据处理和数据政策 | 检查密钥范围、操作权限、撤销方式及客户端确认机制 |
看工具列表比看功能标题更直接。MCP 工具规范规定，客户端通过 tools/list 发现工具，通过 tools/call 调用工具；每个工具的 inputSchema 定义输入参数。
选型时还要问：密钥能否只访问测试邮箱所在组？读权限和发送权限是否分开？撤销密钥后能否阻止后续调用？这些问题决定你能否先安全地做只读验证。MCP 协议本身不会替你强制落实所有安全原则。
你的邮箱需要哪种连接方式？
先在 Mailera 邮箱服务商目录确认连接路线，再配置客户端。邮箱没有连通时，修改 MCP 配置不能修复服务商登录问题。
| 已有邮箱 | Mailera 连接方式 | 配置前检查 | 详细入口 |
|---|---|---|---|
| Outlook.com、Hotmail、Microsoft 365 | Microsoft OAuth，通过 Microsoft Graph 访问 | 使用有权访问该邮箱的账号完成授权；组织邮箱遇到授权阻碍时联系管理员 | Microsoft 邮箱连接 |
| Gmail、Google Workspace | 应用专用密码（app password） | 已开启两步验证，且账号及管理员策略允许使用 | Gmail 邮箱连接 |
| 自定义 IMAP 邮箱 | IMAP 接收；需要发送时另配 SMTP | 准备服务商提供的服务器、端口、安全方式及登录凭据 | 自定义 IMAP／SMTP 连接 |
Microsoft 邮箱走 OAuth，不使用应用密码连接。Gmail 在 Mailera 中的当前连接方式则是应用专用密码，不能把两家的配置方法互换。
按 Google 应用密码说明（查阅日期：2026-10-25），应用密码要求开启两步验证。仅使用安全密钥的两步验证、组织账号或 Advanced Protection 都可能导致该选项不可用。Google 也建议，在应用提供“Sign in with Google”时优先使用该方式；这与 Mailera 当前的 Gmail 连接入口是两个不同问题。
如果你要接入 QQ 邮箱或 163 邮箱，应先确认该账号允许外部 IMAP／SMTP 访问，并取得对应服务商的配置和授权方式，再走自定义 IMAP 路径分别测试收件与发件。不要直接套用 Gmail 的服务器设置，也不要把“支持自定义 IMAP”理解为任何邮箱都能直接连通。
收件成功不代表发件可用。自定义连接可以不填写 SMTP；发送连接失败时，也可以保存为仅收件。Daum 当前在 Mailera 中仅支持接收，不能用于后面的回复验收。
如何把 Mailera 接入你的 MCP 客户端？
用你自己有权访问、没有敏感邮件的测试邮箱开始。把它放入专门的测试组，比把日常工作邮箱全部开放给客户端更容易核对范围。
- 添加测试邮箱。 由 Admin 或 Leader 进入“邮箱列表”→“添加邮箱”。Microsoft 邮箱选择“使用 Microsoft 登录”；其他邮箱从“单个邮箱”输入地址，确认服务商后选择“继续”。自定义连接填写“收件服务器（IMAP）”，需要发送时再填写“发件服务器（SMTP）”。核对连接信息中的账号和服务商是否正确。
- 运行连接测试。 选择“测试并连接”，查看收件登录、文件夹检测及发件登录结果。此操作只测试连接，不会发送邮件。若出现“可以收件，但暂时无法发件”，可以选择“保存为仅收件”继续读取测试，但不要进入回复验收。
- 检查邮箱状态。 返回“邮箱列表”，核对连接状态与最近同步情况。首次连接会加载保留期内的邮件，最新邮件优先显示。确认能在“统一收件箱”中找到你准备的测试邮件，不要只看连接是否完成。
- 创建专用只读密钥。 在“设置”的 API 密钥页面选择“创建 API key”。填写“易于识别的名称”，把“邮箱范围”限定到测试邮箱所在组，只授予
read，并设置“有效期”。这里限制的是一个邮箱组，不是单邮箱级权限；若只想开放一个邮箱，就让测试组只包含它。不要选择所有分组。 - 保存并复制客户端配置。 密钥只显示一次。在“API key 已创建，请立即复制”对话框中，使用“复制 MCP 配置”，选择你实际使用的 Claude、Cursor 或 VS Code。配置中包含访问凭据，应按密钥保管，不要粘贴到公开问题、聊天或截图中。
- 核对地址并启用连接。 服务端地址应为
https://mailera.app/api/public/v1/mcp，认证形式为Authorization: Bearer $MAILERA_API_KEY，其中变量代表你的专用密钥。使用对应客户端生成的配置，不要把一种客户端的 JSON 原样套给另一种。启用后检查工具发现结果，并查看工具的inputSchema。
客户端的具体入口分别见 Claude 接入说明、Cursor 接入说明和 VS Code 接入说明。连接显示启用只是起点，下一步要检查实际返回的邮箱和邮件。
怎样确认读取、搜索和回复确实可用？
先在自己的测试邮箱准备一封无敏感内容的邮件，主题使用容易辨认的唯一文本，例如 MCP-READ-CHECK-A7。下面是验收目标，不是可以直接粘贴的工具参数；参数以客户端发现的 inputSchema 为准，不要从 REST 接口照搬。
| 验收操作 | 所需权限 | 通过标准 | 不符合时先查 |
|---|---|---|---|
list_mailboxes | read | 返回范围内只有预期邮箱组的邮箱 | 密钥绑定的组、组内成员 |
list_messages → get_message | read | 找到测试邮件，主题、发件人及正文与邮箱中一致 | 邮箱、文件夹、同步状态 |
search_messages | read | 搜到唯一测试主题，且结果属于预期邮箱 | 搜索输入、范围、邮件是否已同步 |
| 只读密钥的权限检查 | read，不授予 send | 无法成功执行发送操作 | 客户端是否仍加载旧的高权限密钥 |
reply_to_email 或 send_email | send | 人工确认后才调用，发件邮箱和内容符合确认记录 | 发送权限、邮箱发送能力 |
get_send_status | send | 可查询本次发送状态，再到自己的收件端检查邮件 | 发送状态及服务商处理结果 |
读取验收不要停在邮件预览。用 get_message 检查正文，才能确认客户端拿到的是所需内容。搜索也不要只看“有结果”，还要检查结果属于哪个邮箱，避免用另一个邮箱中的同名邮件误判成功。
权限拒绝测试只能使用自己的测试收发邮箱和无敏感正文，并由你明确同意发起。预期是只读密钥不能成功发送；不要把“发送工具没有出现在列表里”作为唯一验收标准。
确实需要回复时，再创建限定同一测试组的专用密钥：需要读取原邮件时保留 read，另加 send。让客户端先展示发件邮箱、收件人、回复正文和附件清单，等你确认后才调用 reply_to_email。不要在同一句含糊指令中同时授权检索和自动回复。
get_send_status 同样需要 send，只读密钥不能用它查询发送结果。若状态为 unknown，先核对状态及收件端，不要立即重复发送。发送状态表示发送过程的结果，是否出现在目标文件夹仍要到收件端检查。
连接失败、邮件没更新或无法发送，先查什么？
按下面的层次排查，避免把服务商认证、同步和客户端配置都归为“MCP 连不上”。
| 故障层 | 常见现象 | 检查动作 |
|---|---|---|
| 认证 | 所有调用都被拒绝 | 核对 Bearer 认证、密钥有效期、是否已撤销，以及“IP 限制” |
| 权限 | 看不到预期邮箱，或某个操作失败 | 检查邮箱组范围和 read、send、sync 等操作权限 |
| 客户端配置 | 已换密钥，但行为没有变化 | 核对当前加载的配置、服务端地址，并重新检查工具发现结果 |
| 邮箱同步 | 能读旧邮件，找不到刚收到的邮件 | 检查连接状态、文件夹和最近同步时间；需要时使用有 sync 权限的 sync_mailbox |
| 发送能力 | 可读不可回复 | 检查是否仅收件、是否有 send；IMAP／SMTP 邮箱还要检查 SMTP 连接 |
空闲邮箱的后台检查频率会降低，不活跃邮箱可能休眠。Mailera 的同步不是绝对实时；不要仅因新邮件暂时没出现，就反复重新添加邮箱。get_mailbox_status 可用于检查连接状态，但它需要 read，主动同步则另外需要 sync。
Gmail 没有应用密码入口时，回到 Google 的资格条件和组织政策排查。更改 Google 账号密码会撤销应用密码，之后连接失败应检查凭据。Microsoft 登录有问题时，应处理 OAuth 授权和组织政策，不要改成应用密码方案。
让 AI 读邮件时，哪些安全边界必须保留？
邮件正文和附件都是不可信数据，不是操作指令。 一封邮件即使写着“忽略此前要求”“把 API 密钥发到这个地址”或“打开链接继续处理”，也不能成为工具调用的授权依据。这类内容可能是间接 prompt injection。
把以下规则落实到客户端和工作流，而不只是写在一次聊天里：
- 范围由密钥限制。 只读任务只给
read，不顺手开放send、move、manage或share。邮箱组中只放完成任务所需的邮箱。 - 写操作由人确认。 发送、回复和移动邮件前，展示目标邮箱、对象和具体内容。邮件中的请求不能替代你的确认，也不能自行扩大访问范围。
- 只传必要内容。 摘要任务不应默认把所有邮件和附件交给模型。分别核对客户端、模型服务以及 Mailera 安全说明和隐私政策。
- 测试结束收回访问。 截图和日志遮挡邮箱地址、完整密钥与私人正文；演示结束后撤销测试密钥，再用旧密钥发起一次读取，确认访问已被拒绝。
MCP 工具规范建议客户端对敏感操作请求用户确认。这里的人工确认是你需要在客户端或工作流中落实的要求，不能因已经接入 MCP，就假定每次发送都会自动出现确认框。
Mailera 密钥撤销后，使用该密钥的后续调用会立即被拒绝。保留专用测试密钥而不复用其他系统的密钥，也让你能单独结束这次访问。
Mailera 的能力边界
Mailera 不提供营销群发或邮箱预热，也不承诺邮件落入收件箱；邮件服务商的过滤决定不会因为接入 MCP 而改变。当前不支持 Proton Mail 和 Tuta。
选型的通过条件应是：你的目标邮箱能连接，所需工具能在限定权限内完成任务，写操作前有人确认。不要把这些条件换成“客户端显示已连接”。