Cursor 如何连接：OAuth，无需 API 密钥
Cursor 会对本服务器执行标准的 MCP OAuth 流程。它通过 RFC 7591 动态客户端注册 自行注册，所以不需要创建 client ID，并使用 S256 以 授权码加 PKCE 完成授权。整个过程从不传输客户端密钥，令牌也只携带你在我们的授权同意页面上批准的权限范围。它拿到的访问令牌有效期为一小时，并会自动刷新；令牌会以 OAuth: 加客户端名称的形式列在 Dashboard、API Keys 中，你也在那里撤销该连接。
你唯一需要的值
本页的所有内容，都是把这个 URL 填入 Cursor 的方法。
| 字段 | 值 |
|---|---|
| MCP 服务器 URL | https://mcpemails.com/api/mcp |
| 传输方式 | Streamable HTTP (MCP 2025-06-18) |
| 认证 | OAuth 2.1，带 PKCE 的授权码流程。无需 API 密钥。 |
如何将 Cursor 连接到你的收件箱
共四步。前两步对所有客户端都一样，其余步骤专门针对这个客户端。
创建免费账户并连接邮箱
在 mcpemails.com 注册，无需绑卡，然后前往 Dashboard、Inboxes、Connect Inbox。Outlook 和 Microsoft 365 通过 Microsoft 登录连接；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 需要应用专用密码；其他邮箱都可通过标准 IMAP 与 SMTP 连接。免费版包含 1 个收件箱，永久有效。
打开你的 mcp.json
编辑 ~/.cursor/mcp.json 以作用于所有项目，或编辑某个项目中的 .cursor/mcp.json。
添加服务器
在 mcpServers 下添加下面的条目。Cursor 在这里需要的字段是 url。
授权
Cursor 会提示你通过 OAuth 登录。通过 MCPEmails 授权，并批准你希望编辑器拥有的权限范围。
{
"mcpServers": {
"mcpemails": {
"url": "https://mcpemails.com/api/mcp"
}
}
}Cursor 关于远程 MCP 服务器的官方文档： https://cursor.com/docs/mcp
想看完整教程？ 在 Cursor、Cline 和 VS Code 中为 AI 智能体接入邮件
不确定先连接哪个邮箱？ 查看邮箱服务商兼容性对照表
使用 Cursor 时容易踩的坑
项目配置和全局配置是两个不同的文件，而且两者同时存在
放在 ~/.cursor/mcp.json 中的服务器会跟随你进入每个项目；放在 .cursor/mcp.json 中的只属于那个仓库。邮件通常是你个人的事，而不是仓库的事，所以全局文件是更合适的位置，也能让这个条目远离别人会克隆的仓库。
项目里的 mcp.json 是一个你可能不小心提交的文件
条目本身不包含任何机密，只是一个公开的 URL，OAuth 令牌也由 Cursor 自行保存，而不是写在这里。但一旦有人把 OAuth 条目换成内联的 bearer API 密钥，情况就变了。如果你走密钥路线，请让它远离任何会被提交的文件，并撤销任何曾经被推送过的密钥：密钥可以在 Dashboard、API Keys 中一键撤销。
给编辑器的权限要少于给邮件应用的
一个拥有 delete:email 的编码智能体，对一个主要工作是重构的工具来说，是一种奇怪的权力。读取、搜索和草稿权限范围几乎能覆盖所有编辑器工作流。你随时可以为真正用来分拣邮件的助手再签发一个权限更大的连接。
值得了解的限制
- 每个密钥的请求上限为每分钟 100 次、每小时 1,000 次、每天 10,000 次，此外还受你所在套餐的计费操作上限约束。
- 服务器只做请求与响应。没有 webhook，也没有服务器主动发起的事件，所以新邮件永远不会自己唤醒你的智能体。要对新到的邮件作出反应，请按计划轮询。
- 每次调用都会从你的邮箱服务商实时获取邮件，从不存储。我们只保存加密后的 OAuth 令牌或应用专用密码，因此令牌一经撤销或邮箱密码一经更改，访问会立即终止。
Cursor 与邮件：常见问题解答
如何将邮箱连接到 Cursor？
在 ~/.cursor/mcp.json 的 mcpServers 下添加一个条目，url 为 https://mcpemails.com/api/mcp ，然后完成 Cursor 提示的 OAuth 登录。之后 Cursor 就拥有了在你已连接的所有邮箱中读取、搜索、发送、回复、转发、整理和定时发送邮件的工具。
Cursor 需要 API 密钥吗？
不需要。Cursor 会对本服务器执行浏览器 OAuth 流程，动态注册自己并通过 PKCE 授权，所以配置文件中不含任何机密。对于脚本化或无图形界面的设置，bearer API 密钥仍然是一个选项。
为什么这里的字段叫 url，而在 Windsurf 中叫 serverUrl？
因为这两个客户端为同一件事选择了不同的配置 schema。Cursor 读取 mcpServers 下的 url，Windsurf 读取 serverUrl，VS Code 需要 servers 下的 type 和 url，而 Gemini CLI 需要 httpUrl。四者的端点完全相同，只有键名不同；在客户端之间照搬配置片段，正是设置悄无声息地失效的常见原因。
Cursor 通过这种方式能访问哪些邮箱？
Outlook.com 和 Microsoft 365 通过 Microsoft 登录（工作账户可能需要 IT 管理员批准一次该应用）；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 使用应用专用密码；以及任何在标准端口上支持 IMAP 与 SMTP 的其他邮箱。客户端通过同一个连接看到所有邮箱：你的智能体会先调用 inbox_list 来发现每个已连接的邮箱及其 id，所以不需要在任何地方粘贴 UUID。
Cursor 会在我不知情的情况下发送邮件吗？
只有在你允许的情况下才会。发送受 send:email 权限范围控制，没有该权限的密钥或令牌根本无法发送。此外，收件箱所有者还可以在仪表盘中要求人工审批，届时每一次发送、回复、转发、草稿发送和定时发送都会被暂扣，直到有人放行。
我的邮件会存储在你们的服务器上吗？
不会。每封邮件都是为发起请求的那次调用从你的邮箱服务商实时获取，并直接交给你的客户端。我们只保存加密后的 OAuth 令牌或应用专用密码，以便后续调用能够完成认证。在仪表盘中删除该收件箱，或在邮箱服务商处撤销访问权限，连接会立即终止。