--- title: "邮箱 MCP 服务器怎么选：把已有邮箱安全接入 AI" description: "为已有 Outlook、Gmail 或自定义 IMAP 邮箱选择 MCP 服务器。了解 Mailera 的邮箱连接、只读密钥、客户端配置、读取搜索与人工确认后回复的验收流程。" url: https://mailera.app/zh/blog/email-mcp-server published: 2026-10-25 updated: 2026-10-25 --- # 邮箱 MCP 服务器怎么选：把已有邮箱安全接入 AI 从读取与搜索能力开始选型，再用一个测试邮箱完成最小权限配置。本文给出 Mailera 的接入步骤、回复邮件的验收方法，以及不能交给邮件正文决定的安全边界。 ## 已有邮箱怎样接入 MCP？ 邮箱 MCP 服务器把邮件操作作为工具提供给 AI 客户端。能否读取收件箱、搜索历史邮件或回复，取决于服务器提供哪些工具，以及你授予哪些权限，不取决于名称里是否有“邮件”二字。 [MCP 官方规范](https://modelcontextprotocol.io/specification/2025-06-18)定义的是应用连接外部数据和工具的方式。你仍然需要分别处理邮箱服务商认证，以及客户端访问 MCP 服务的认证。 在 [Mailera MCP](https://mailera.app/zh/mcp) 中，Mailera 连接已有邮箱，不创建邮箱或新地址。Outlook 使用 Microsoft OAuth；其他连接方式可能使用应用专用密码。AI 客户端使用的是 Mailera API 密钥，不是邮箱密码。 ![AI 客户端使用 API 密钥连接 Mailera MCP，Mailera 再通过邮箱认证访问已有邮箱](https://mailera.app/media/2f46808747caa3be/mcp-ai-connection-layers-zh-hans-1200.jpg) _客户端访问权限与邮箱服务商登录是两层认证，凭据不能混用。_ ## 怎样判断一个邮箱 MCP 服务器是否适合你？ 先写清任务：只发送通知，还是要读已有邮件、跨邮箱搜索，并回复原来的会话？如果你需要后者，就不要把“支持 SMTP”当作读取能力的依据。 下面按方案类型列出检查项，不做产品排名。 | 方案类型 | 读取与搜索 | 认证与维护 | 访问范围与发送确认 | | --- | --- | --- | --- | | 仅发信工具 | 不满足读取已有邮箱的需求 | 检查发信凭据如何配置、由谁保管 | 检查发件身份限制，以及客户端发送前确认 | | 可读写已有邮箱的自托管服务 | 核对实际工具列表和搜索范围 | 你控制部署与配置，也需要承担维护工作 | 检查是否有服务端权限限制，不能只靠提示词约束 | | 托管连接服务 | 核对支持的邮箱、读取和搜索工具 | 减少自建服务工作，但要审查凭据处理和数据政策 | 检查密钥范围、操作权限、撤销方式及客户端确认机制 | 看工具列表比看功能标题更直接。[MCP 工具规范](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)规定，客户端通过 `tools/list` 发现工具，通过 `tools/call` 调用工具；每个工具的 `inputSchema` 定义输入参数。 选型时还要问：密钥能否只访问测试邮箱所在组？读权限和发送权限是否分开？撤销密钥后能否阻止后续调用？这些问题决定你能否先安全地做只读验证。MCP 协议本身不会替你强制落实所有安全原则。 ## 你的邮箱需要哪种连接方式？ 先在 [Mailera 邮箱服务商目录](https://mailera.app/zh/providers)确认连接路线，再配置客户端。邮箱没有连通时，修改 MCP 配置不能修复服务商登录问题。 | 已有邮箱 | Mailera 连接方式 | 配置前检查 | 详细入口 | | --- | --- | --- | --- | | Outlook.com、Hotmail、Microsoft 365 | Microsoft OAuth，通过 Microsoft Graph 访问 | 使用有权访问该邮箱的账号完成授权；组织邮箱遇到授权阻碍时联系管理员 | [Microsoft 邮箱连接](https://mailera.app/zh/providers/microsoft) | | Gmail、Google Workspace | 应用专用密码（app password） | 已开启两步验证，且账号及管理员策略允许使用 | [Gmail 邮箱连接](https://mailera.app/zh/providers/gmail) | | 自定义 IMAP 邮箱 | IMAP 接收；需要发送时另配 SMTP | 准备服务商提供的服务器、端口、安全方式及登录凭据 | [自定义 IMAP／SMTP 连接](https://mailera.app/zh/providers/imap) | Microsoft 邮箱走 OAuth，不使用应用密码连接。Gmail 在 Mailera 中的当前连接方式则是应用专用密码，不能把两家的配置方法互换。 按 [Google 应用密码说明](https://support.google.com/accounts/answer/185833)（查阅日期：2026-10-25），应用密码要求开启两步验证。仅使用安全密钥的两步验证、组织账号或 Advanced Protection 都可能导致该选项不可用。Google 也建议，在应用提供“Sign in with Google”时优先使用该方式；这与 Mailera 当前的 Gmail 连接入口是两个不同问题。 如果你要接入 QQ 邮箱或 163 邮箱，应先确认该账号允许外部 IMAP／SMTP 访问，并取得对应服务商的配置和授权方式，再走自定义 IMAP 路径分别测试收件与发件。不要直接套用 Gmail 的服务器设置，也不要把“支持自定义 IMAP”理解为任何邮箱都能直接连通。 收件成功不代表发件可用。自定义连接可以不填写 SMTP；发送连接失败时，也可以保存为仅收件。Daum 当前在 Mailera 中仅支持接收，不能用于后面的回复验收。 ## 如何把 Mailera 接入你的 MCP 客户端？ 用你自己有权访问、没有敏感邮件的测试邮箱开始。把它放入专门的测试组，比把日常工作邮箱全部开放给客户端更容易核对范围。 1. **添加测试邮箱。** 由 Admin 或 Leader 进入“邮箱列表”→“添加邮箱”。Microsoft 邮箱选择“使用 Microsoft 登录”；其他邮箱从“单个邮箱”输入地址，确认服务商后选择“继续”。自定义连接填写“收件服务器（IMAP）”，需要发送时再填写“发件服务器（SMTP）”。核对连接信息中的账号和服务商是否正确。 2. **运行连接测试。** 选择“测试并连接”，查看收件登录、文件夹检测及发件登录结果。此操作只测试连接，不会发送邮件。若出现“可以收件，但暂时无法发件”，可以选择“保存为仅收件”继续读取测试，但不要进入回复验收。 3. **检查邮箱状态。** 返回“邮箱列表”，核对连接状态与最近同步情况。首次连接会加载保留期内的邮件，最新邮件优先显示。确认能在“统一收件箱”中找到你准备的测试邮件，不要只看连接是否完成。 ![Mailera 邮箱列表中的测试邮箱连接状态与最近同步信息](https://mailera.app/media/4d2aacd06e6c3984/mcp-ai-mailbox-status-zh-hans-1200.jpg) _先确认邮箱连接和同步，再排查 MCP 客户端。_ 4. **创建专用只读密钥。** 在“设置”的 API 密钥页面选择“创建 API key”。填写“易于识别的名称”，把“邮箱范围”限定到测试邮箱所在组，只授予 `read`，并设置“有效期”。这里限制的是一个邮箱组，不是单邮箱级权限；若只想开放一个邮箱，就让测试组只包含它。不要选择所有分组。 5. **保存并复制客户端配置。** 密钥只显示一次。在“API key 已创建，请立即复制”对话框中，使用“复制 MCP 配置”，选择你实际使用的 Claude、Cursor 或 VS Code。配置中包含访问凭据，应按密钥保管，不要粘贴到公开问题、聊天或截图中。 6. **核对地址并启用连接。** 服务端地址应为 `https://mailera.app/api/public/v1/mcp`，认证形式为 `Authorization: Bearer $MAILERA_API_KEY`，其中变量代表你的专用密钥。使用对应客户端生成的配置，不要把一种客户端的 JSON 原样套给另一种。启用后检查工具发现结果，并查看工具的 `inputSchema`。 ![限定测试邮箱组和只读权限的 API 密钥配置，以及复制 MCP 配置入口](https://mailera.app/media/c26443576078cc56/mcp-ai-readonly-key-zh-hans-1200.jpg) _先用限定邮箱组的只读密钥验证，再按任务需要增加权限。_ 客户端的具体入口分别见 [Claude 接入说明](https://mailera.app/zh/integrations/claude)、[Cursor 接入说明](https://mailera.app/zh/integrations/cursor)和 [VS Code 接入说明](https://mailera.app/zh/integrations/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 安全说明](https://mailera.app/zh/security)和[隐私政策](https://mailera.app/zh/privacy)。 - **测试结束收回访问。** 截图和日志遮挡邮箱地址、完整密钥与私人正文；演示结束后撤销测试密钥，再用旧密钥发起一次读取，确认访问已被拒绝。 MCP 工具规范建议客户端对敏感操作请求用户确认。这里的人工确认是你需要在客户端或工作流中落实的要求，不能因已经接入 MCP，就假定每次发送都会自动出现确认框。 Mailera 密钥撤销后，使用该密钥的后续调用会立即被拒绝。保留专用测试密钥而不复用其他系统的密钥，也让你能单独结束这次访问。 ## Mailera 的能力边界 Mailera 不提供营销群发或邮箱预热，也不承诺邮件落入收件箱；邮件服务商的过滤决定不会因为接入 MCP 而改变。当前不支持 Proton Mail 和 Tuta。 选型的通过条件应是：你的目标邮箱能连接，所需工具能在限定权限内完成任务，写操作前有人确认。不要把这些条件换成“客户端显示已连接”。 **让 AI 智能体通过 MCP 使用您的邮箱** — 将 Mailera 的 MCP 服务器添加到 Claude、Cursor 或 VS Code，让智能体读取、分类和回复邮件。 [了解 MCP 用法](https://mailera.app/zh/docs#mcp)