开始前需要准备什么？
这里的 Cursor 邮箱 MCP 配置，是让 Cursor 通过 Mailera 的邮件工具访问已有邮箱，不是检测邮箱地址是否有效。MCP 负责连接客户端与工具；跨客户端的说明见已有邮箱的 MCP 接入总览，本文只讲 Cursor。
准备可使用 MCP 的 Cursor、Mailera 工作区，以及你自己的测试邮箱。Mailera 不创建邮箱或邮件地址。
| 条件 | 开始前怎么检查 |
|---|---|
| 邮箱已连接 | 确认目标邮箱已连接 |
| 邮箱分组明确 | 将测试邮箱放入准备授权的分组，避免包含无关邮箱 |
| 密钥允许读取 | 初次只授予 read |
| 准备测试回复 | 邮箱支持发件，并使用具备 send 权限的密钥 |
还没连接邮箱时，由 Admin 或 Leader 从“邮箱列表”进入“添加邮箱”。Outlook、Microsoft 365 使用“使用 Microsoft 登录”完成 OAuth 授权，具体见 Microsoft 邮箱连接说明；Gmail 按 Gmail 邮箱连接说明操作，也可参照 Gmail MCP 配置教程。
“测试并连接”只测试连接，不发送邮件。即使连接成功，也要单独验证一次真实回复。
如何把 Mailera MCP 配置加入 Cursor？
- 打开 Mailera“设置”中的 API key 管理区域，选择“创建 API key”。在“易于识别的名称”中填写便于辨认的名称，例如“Cursor 只读测试”。
- 将“邮箱范围”限制到测试邮箱所在分组，初次只授予
read权限，并设置合适的“有效期”。不要为了省事开放所有分组。 - 创建后立即安全保存密钥。密钥只展示一次；在同一对话框选择 Cursor，再使用“复制 MCP 配置”。
- 将生成的配置加入 Cursor。服务地址应为
https://mailera.app/api/public/v1/mcp，配置结构和认证内容直接使用生成结果，不要将 REST 请求示例改写成 MCP 配置。
Cursor 官方 MCP 文档给出的配置位置是：项目级配置放在 .cursor/mcp.json，全局配置放在 ~/.cursor/mcp.json。前者用于当前项目，后者让工具在不同项目中可用。已有配置时合并内容，不要覆盖其他服务器配置。
不要把含真实密钥的文件提交到代码仓库，也不要将密钥粘贴进对话或截图。若使用环境变量，Cursor 支持 ${env:NAME} 插值；远程 HTTP/SSE 服务器不支持 envFile，不要照搬本地服务器的配置方式。
配置后，在 Cursor 的“Available Tools”中检查邮件工具，再要求它调用 list_mailboxes，核对返回的邮箱是否都属于预期分组。范围不对时先停止读取，撤销该密钥，再创建仅授权测试分组和 read 权限的新密钥，并替换 Cursor 中的配置。Mailera 的 Cursor 接入页与 MCP 工具说明可用于对照入口和工具名称。
如何读取指定邮箱中的一封邮件？
用自己的另一个测试邮箱发来一封主题为“回复流程测试”的邮件，正文写一段不含敏感信息的内容。不要用客户邮件作为首次测试材料。
接着在 Cursor 中给出明确指令，并补上目标测试邮箱的标识：
只读取指定测试邮箱中主题为“回复流程测试”的邮件。先定位邮件，再读取正文，列出邮箱、邮件标识、发件人、主题和正文摘要。不发送、不移动邮件；有多封匹配时先让我选择。
让 Cursor 用 list_messages 或 search_messages 定位，再用 get_message 获取正文。这些工具都只需要 read 权限。列表摘要不等于完整正文，不要在只拿到摘要时让它起草依赖正文细节的回复。
工具参数以 Cursor 实际读取到的工具定义为准。MCP 工具规范中的 inputSchema 定义了工具所需参数，不要把 REST 的路径参数直接当成 MCP 参数。
在工具返回结果中记录目标邮件标识，后续操作使用同一标识，避免选中同主题的其他邮件。在 Mailera“统一收件箱”中打开同一封邮件，核对邮箱、发件人、主题和正文是否一致。
如何先起草回复，再确认发送？
把起草和发送拆成两次操作。只读阶段就能让 Cursor 根据已读取的正文生成回复文本：
根据刚才的测试邮件，在对话中起草回复。只输出拟用的发件邮箱、收件人、抄送、主题和完整正文，不调用任何发送工具。
这里的“草稿”是对话中的文本，不代表已经保存到邮箱的草稿文件夹。
准备发送时，使用同时具备 read 和 send 权限、且仍限制到测试分组的密钥，将对应的 Cursor MCP 配置更新到原先选定的位置。再检查一次可见邮箱和当前工具授权，不要只改提示词就尝试发送。
- 要求 Cursor 展示发件邮箱、收件人、抄送、主题和完整正文。核对它回复的是刚才那封邮件，而不是新建一封无关邮件。
- 明确确认这一次回复后，才允许调用
reply_to_email（回复邮件的工具）。可以说：“确认按上面展示的收件人和正文回复这封测试邮件，不添加其他收件人。” - 在 Cursor 的工具审批处检查调用参数。点击工具名称旁的箭头可以展开参数；若参数与确认内容不一致，不要批准。
- 调用
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 安全说明；发现密钥泄露时立即撤销，后续使用该密钥的调用会被拒绝，再配置新的受限密钥。
Mailera 的边界在哪里？
Mailera 连接已有邮箱，不提供群发营销或邮箱预热，也不保证邮件进入收件箱。它不能代替服务商决定邮件分类。
新邮件不一定会立即显示：后台检查频率会随邮箱使用情况变化，闲置邮箱可能进入休眠。验收时以指定邮件的正文读取结果、发送状态和自己的收件结果为准，而不是以配置文件保存成功为准。
