如何把 nicemails 连接到 Cursor

Q: Cursor 里看不到 nicemails，或者显示错误。

检查 mcp.json 是合法的 JSON，url 正好是 https://nicemails.net/mcp。打开 Output 面板（Cmd+Shift+U），选 MCP Logs 查看连接错误。改完文件后重启 Cursor。

要给 Cursor 一个邮箱，在 mcp.json 里添加 nicemails，把 nicemails 的 MCP 服务器地址填为 url。Cursor 用 OAuth 登录：你在浏览器的 nicemails 页面上批准访问后，Cursor 的 Agent 就能搜索和阅读你的邮箱、整理邮件，并在你批准后发信。

开始前需要准备什么？

一个 nicemails 账号，以及给 Cursor 用的邮箱。注册免费，用发到你邮箱的验证码登录，没有密码。
Cursor 桌面应用。按 Cursor 文档，Cursor 支持 Streamable HTTP 服务器和带 PKCE 的 OAuth 登录，并会自动注册为客户端，不需要 client ID。

怎样把 nicemails 添加到 Cursor？

要在所有项目里使用，打开 ~/.cursor/mcp.json；只在某个项目里用，就打开项目里的 .cursor/mcp.json。文件不存在就新建，在 mcpServers 下加入 nicemails：
```
{
  "mcpServers": {
    "nicemails": {
      "url": "https://nicemails.net/mcp"
    }
  }
}
```
保存文件。如果 nicemails 没出现，重启 Cursor。
打开侧边栏的 Customize，确认 nicemails 已启用。
Cursor 会从 nicemails 服务器读取登录信息并发起 OAuth。浏览器打开 nicemails，用发到你邮箱的验证码登录。
在授权页上勾选权限，选择 Cursor 可以用全部邮箱还是只用一个，然后点「允许」。
在 Agent 对话里问「列出我的 nicemails 邮箱」。Cursor 会在合适时使用 Available Tools 里列出的 MCP 工具。

桌面应用在 http://localhost:8787/callback 完成登录，nicemails 接受这个地址，所以不需要配置白名单。Cloud Agents 的 MCP 登录保存在 Cursor 的服务器上，和本机分开，用到时要在那里再登录一次。

怎样改用 API 密钥？

没有浏览器的机器，或者想给某个项目一个固定、权限较窄的凭据时，适合用密钥。先创建密钥：

在 nicemails 打开「设置 → API 密钥」，点「创建 API 密钥」。
密钥用途选「AI 代理（MCP）」。
勾选权限，需要的话把密钥限定为一个邮箱。
复制密钥。它只显示这一次。

Cursor 会展开 url 和 headers 里的 ${env:NAME}，所以密钥可以不写进文件。在启动 Cursor 的环境里设置 NICEMAILS_API_KEY，然后这样写：

{
  "mcpServers": {
    "nicemails": {
      "url": "https://nicemails.net/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NICEMAILS_API_KEY}"
      }
    }
  }
}

不要提交写有明文密钥的项目 .cursor/mcp.json。

连接后 Cursor 能对邮箱做什么？

Cursor 的 Agent 能用你授权范围内的 nicemails 工具，共 8 个：

list_mailboxes：列出这个连接能用的邮箱。
list_messages：列出某个邮箱一个文件夹里的邮件，最新的在前。
search：搜索所选邮箱的所有文件夹，包括垃圾邮件。
get_message：读取一封邮件，不会把它标为已读。
create_mailbox：新建邮箱（需要「管理」权限，且连接不限定单个邮箱）。
move 把邮件移到别的文件夹；flag 把邮件标为已读、未读、星标或已回复。
send_message：从你的某个邮箱发信（需要「发信」权限；新收件人要你先批准）。

写代码时可以这样用：「打开 qa 邮箱里 staging 应用发来的最新邮件，把魔法链接填进端到端测试」，或者「搜索昨天发出的发票邮件，对比它的主题和代码里的模板」。

Cursor 做的事由谁批准？

按 Cursor 文档，Cursor 默认在使用 MCP 工具前请你批准，规则和终端命令的运行模式相同。在 Auto-review 下，白名单里的工具不再询问。
权限：连接只拿到你勾选的权限：读取（列出、搜索、阅读邮件）、管理（新建邮箱、移动邮件、设置标记）和发信。连接还可以限定为只用一个邮箱。
发信确认：如果收件人不是你在最近 30 天内从网页版发过信、或在之前的确认中信任过的地址，就什么都不会发出，直到你登录 nicemails 在确认页上批准这封信。未批准的请求 15 分钟后失效。
不可信内容：工具结果会把邮件内容标为不可信数据，邮件里的任何文字都不能批准发信。
随时断开：在 Customize 里停用 nicemails，或在 nicemails 的「设置 → API 密钥 → 已连接的应用」里断开 Cursor，访问立即结束。

排查问题

Cursor 里看不到 nicemails，或者显示错误。

检查 mcp.json 是合法的 JSON，url 正好是 https://nicemails.net/mcp。打开 Output 面板（Cmd+Shift+U），选 MCP Logs 查看连接错误。改完文件后重启 Cursor。

登录完成了，但工具调用失败。

这个连接可能没有对应权限，或者被限定在另一个邮箱。在「设置 → API 密钥 → 已连接的应用」里断开 Cursor，再从 Cursor 重新登录并勾选需要的权限。

Cursor 的 Cloud Agents 能用这个连接吗？

Cloud Agents 有自己的 MCP 登录，和本机分开，需要在那里再登录一次 nicemails。