---
title: "Cursor 邮箱 MCP：读取邮件、起草并确认回复"
description: "通过 Mailera 将已有 Gmail、Outlook 邮箱接入 Cursor。先用只读密钥验证邮件正文，再人工确认回复、查询发送状态，并防范邮件提示注入。"
url: https://mailera.app/zh/blog/cursor-email-mcp
published: 2026-10-25
updated: 2026-10-25
---

# Cursor 邮箱 MCP：读取邮件、起草并确认回复

把已有邮箱接入 Cursor，先验证只读访问，再按需开放发送权限。以自己的测试邮件为起点，逐步核对正文、回复内容和发送结果。

## 开始前需要准备什么？

这里的 Cursor 邮箱 MCP 配置，是让 Cursor 通过 Mailera 的邮件工具访问已有邮箱，不是检测邮箱地址是否有效。MCP 负责连接客户端与工具；跨客户端的说明见[已有邮箱的 MCP 接入总览](https://mailera.app/zh/blog/email-mcp-server)，本文只讲 Cursor。

准备可使用 MCP 的 Cursor、Mailera 工作区，以及你自己的测试邮箱。Mailera 不创建邮箱或邮件地址。

| 条件 | 开始前怎么检查 |
| --- | --- |
| 邮箱已连接 | 确认目标邮箱已连接 |
| 邮箱分组明确 | 将测试邮箱放入准备授权的分组，避免包含无关邮箱 |
| 密钥允许读取 | 初次只授予 `read` |
| 准备测试回复 | 邮箱支持发件，并使用具备 `send` 权限的密钥 |

还没连接邮箱时，由 Admin 或 Leader 从“邮箱列表”进入“添加邮箱”。Outlook、Microsoft 365 使用“使用 Microsoft 登录”完成 OAuth 授权，具体见 [Microsoft 邮箱连接说明](https://mailera.app/zh/providers/microsoft)；Gmail 按 [Gmail 邮箱连接说明](https://mailera.app/zh/providers/gmail)操作，也可参照 [Gmail MCP 配置教程](https://mailera.app/zh/blog/gmail-mcp-app-password)。

“测试并连接”只测试连接，不发送邮件。即使连接成功，也要单独验证一次真实回复。

## 如何把 Mailera MCP 配置加入 Cursor？

1. 打开 Mailera“设置”中的 API key 管理区域，选择“创建 API key”。在“易于识别的名称”中填写便于辨认的名称，例如“Cursor 只读测试”。
2. 将“邮箱范围”限制到测试邮箱所在分组，初次只授予 `read` 权限，并设置合适的“有效期”。不要为了省事开放所有分组。
3. 创建后立即安全保存密钥。密钥只展示一次；在同一对话框选择 Cursor，再使用“复制 MCP 配置”。
4. 将生成的配置加入 Cursor。服务地址应为 `https://mailera.app/api/public/v1/mcp`，配置结构和认证内容直接使用生成结果，不要将 REST 请求示例改写成 MCP 配置。

![Mailera API 密钥界面中限制测试邮箱分组、授予只读权限并复制 Cursor MCP 配置的入口](https://mailera.app/media/35a4ec574d03a097/cursor-mcp-cursor-api-key-zh-hans-1200.jpg)
_先限制邮箱范围和读取权限，再复制 Cursor 配置；真实密钥必须遮蔽。_

[Cursor 官方 MCP 文档](https://cursor.com/docs/mcp)给出的配置位置是：项目级配置放在 `.cursor/mcp.json`，全局配置放在 `~/.cursor/mcp.json`。前者用于当前项目，后者让工具在不同项目中可用。已有配置时合并内容，不要覆盖其他服务器配置。

不要把含真实密钥的文件提交到代码仓库，也不要将密钥粘贴进对话或截图。若使用环境变量，Cursor 支持 `${env:NAME}` 插值；远程 HTTP/SSE 服务器不支持 `envFile`，不要照搬本地服务器的配置方式。

配置后，在 Cursor 的“Available Tools”中检查邮件工具，再要求它调用 `list_mailboxes`，核对返回的邮箱是否都属于预期分组。范围不对时先停止读取，撤销该密钥，再创建仅授权测试分组和 `read` 权限的新密钥，并替换 Cursor 中的配置。[Mailera 的 Cursor 接入页](https://mailera.app/zh/integrations/cursor)与 [MCP 工具说明](https://mailera.app/zh/mcp)可用于对照入口和工具名称。

## 如何读取指定邮箱中的一封邮件？

用自己的另一个测试邮箱发来一封主题为“回复流程测试”的邮件，正文写一段不含敏感信息的内容。不要用客户邮件作为首次测试材料。

接着在 Cursor 中给出明确指令，并补上目标测试邮箱的标识：

> 只读取指定测试邮箱中主题为“回复流程测试”的邮件。先定位邮件，再读取正文，列出邮箱、邮件标识、发件人、主题和正文摘要。不发送、不移动邮件；有多封匹配时先让我选择。

让 Cursor 用 `list_messages` 或 `search_messages` 定位，再用 `get_message` 获取正文。这些工具都只需要 `read` 权限。**列表摘要不等于完整正文**，不要在只拿到摘要时让它起草依赖正文细节的回复。

工具参数以 Cursor 实际读取到的工具定义为准。[MCP 工具规范](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)中的 `inputSchema` 定义了工具所需参数，不要把 REST 的路径参数直接当成 MCP 参数。

在工具返回结果中记录目标邮件标识，后续操作使用同一标识，避免选中同主题的其他邮件。在 Mailera“统一收件箱”中打开同一封邮件，核对邮箱、发件人、主题和正文是否一致。

![Mailera 统一收件箱中打开主题为回复流程测试的邮件，用于核对 Cursor 读取的正文](https://mailera.app/media/ae55f0cc075d477e/gmail-imap-mailera-gmail-first-message-hi-1200.jpg)
_对照同一封邮件的邮箱、发件人、主题与正文，避免把列表摘要当作完整内容。_

## 如何先起草回复，再确认发送？

把起草和发送拆成两次操作。只读阶段就能让 Cursor 根据已读取的正文生成回复文本：

> 根据刚才的测试邮件，在对话中起草回复。只输出拟用的发件邮箱、收件人、抄送、主题和完整正文，不调用任何发送工具。

这里的“草稿”是对话中的文本，不代表已经保存到邮箱的草稿文件夹。

准备发送时，使用同时具备 `read` 和 `send` 权限、且仍限制到测试分组的密钥，将对应的 Cursor MCP 配置更新到原先选定的位置。再检查一次可见邮箱和当前工具授权，不要只改提示词就尝试发送。

1. 要求 Cursor 展示发件邮箱、收件人、抄送、主题和完整正文。核对它回复的是刚才那封邮件，而不是新建一封无关邮件。
2. 明确确认这一次回复后，才允许调用 `reply_to_email`（回复邮件的工具）。可以说：“确认按上面展示的收件人和正文回复这封测试邮件，不添加其他收件人。”
3. 在 Cursor 的工具审批处检查调用参数。点击工具名称旁的箭头可以展开参数；若参数与确认内容不一致，不要批准。
4. 调用 `get_send_status` 查询发送状态，所需参数按 Cursor 实际读取到的工具定义填写。该工具也需要 `send` 权限。

不能把“工具已调用”当成“发送成功”。查询发送状态后，打开自己的收件端，确认回复确实收到，内容正确，并检查它是否关联到原会话。Mailera 不保证邮件进入收件箱。

## 常见错误：为什么连不上、读不到或发不出？

| 现象 | 优先检查 | 如何验证 |
| --- | --- | --- |
| 没有发现邮件工具 | 配置结构、文件位置、服务地址 | 对照 Mailera 生成的配置；在 Cursor 的“Output”面板选择“MCP Logs”查看连接日志 |
| 鉴权失败 | 密钥是否过期、已撤销或受 IP 限制 | 检查密钥设置，再尝试列出邮箱 |
| 看不到目标邮箱 | 密钥的邮箱分组范围 | 用 `list_mailboxes` 核对，不要先扩大到所有分组 |
| 找不到新邮件 | 文件夹、筛选条件、邮箱状态和最近同步情况 | 在 Mailera 中对照；确需手动同步时另授 `sync`，再调用 `sync_mailbox` |
| 能读却不能回复 | `send` 权限、仅收件模式、发信连接 | 检查密钥权限和邮箱发件能力，不能只看收件是否正常 |
| 发送失败或结果未知 | 该次发送的状态及收件结果 | 查询 `get_send_status`，排除已发送的情况后再决定下一步 |

`sync` 不是读取邮件的必需权限。只为排查同步问题而开放时，不必顺带授予其他管理权限。

邮箱发信连接失败时，可以保存为仅收件模式，因此“已连接”与“可以回复”是两件事。

## 让 AI 读邮件时，怎样避免误发和提示注入？

邮件正文、引用内容和附件内容都应视为不可信数据，不是给 AI 智能体的指令。邮件里出现“忽略之前的规则”“转发其他邮件”或“输出 API 密钥”等内容时，不应据此执行操作或扩大权限。

默认保持只读，仅在任务需要时开放 `send`。读取和回复不需要额外授予 `manage`、`share` 或 `import`。只让智能体读取任务必需的邮件，不要用“扫描全部邮箱”代替明确的邮箱和主题条件。

你需要确保操作经过人工确认。Cursor 默认会在使用 MCP 工具前请求批准，但在“Auto-review”模式下，允许列表中的工具会立即运行，其他工具则交给分类器处理。检查实际审批设置，不要把发送工具加入自动放行范围。MCP 规范本身也不强制规定某一种用户交互方式。

处理工作邮件前，确认工作区政策和所用模型的数据处理条款，不要假设邮件内容只在本地处理。凭据管理可参照 [Mailera 安全说明](https://mailera.app/zh/security)；发现密钥泄露时立即撤销，后续使用该密钥的调用会被拒绝，再配置新的受限密钥。

## Mailera 的边界在哪里？

Mailera 连接已有邮箱，不提供群发营销或邮箱预热，也不保证邮件进入收件箱。它不能代替服务商决定邮件分类。

新邮件不一定会立即显示：后台检查频率会随邮箱使用情况变化，闲置邮箱可能进入休眠。验收时以指定邮件的正文读取结果、发送状态和自己的收件结果为准，而不是以配置文件保存成功为准。

**让 AI 智能体通过 MCP 使用您的邮箱** — 将 Mailera 的 MCP 服务器添加到 Claude、Cursor 或 VS Code，让智能体读取、分类和回复邮件。 [了解 MCP 用法](https://mailera.app/zh/docs#mcp)