Raycast 如何连接：OAuth，无需 API 密钥
Raycast 会对本服务器执行标准的 MCP OAuth 流程。它通过 RFC 7591 动态客户端注册 自行注册，所以不需要创建 client ID，并使用 S256 以 授权码加 PKCE 完成授权。整个过程从不传输客户端密钥，令牌也只携带你在我们的授权同意页面上批准的权限范围。它拿到的访问令牌有效期为一小时，并会自动刷新；令牌会以 OAuth: 加客户端名称的形式列在 Dashboard、API Keys 中，你也在那里撤销该连接。
你唯一需要的值
本页的所有内容，都是把这个 URL 填入 Raycast 的方法。
| 字段 | 值 |
|---|---|
| MCP 服务器 URL | https://mcpemails.com/api/mcp |
| 传输方式 | Streamable HTTP (MCP 2025-06-18) |
| 认证 | OAuth 2.1，带 PKCE 的授权码流程。无需 API 密钥。 |
如何将 Raycast 连接到你的收件箱
共四步。前两步对所有客户端都一样，其余步骤专门针对这个客户端。
创建免费账户并连接邮箱
在 mcpemails.com 注册，无需绑卡，然后前往 Dashboard、Inboxes、Connect Inbox。Outlook 和 Microsoft 365 通过 Microsoft 登录连接；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 需要应用专用密码；其他邮箱都可通过标准 IMAP 与 SMTP 连接。免费版包含 1 个收件箱，永久有效。
运行 Install MCP Server
运行 Install MCP Server 命令；如果你已经装过一些服务器，则运行 Manage MCP Servers。
填写服务器信息
输入名称，将 Transport 设为 HTTP，并粘贴 https://mcpemails.com/api/mcp。
安装并登录
按下 Install MCP Server，然后点击 Sign In，通过 MCPEmails 授权。批准你希望 Raycast 拥有的权限范围。
Raycast 关于远程 MCP 服务器的官方文档： https://manual.raycast.com/ai/model-context-protocol
不确定先连接哪个邮箱？ 查看邮箱服务商兼容性对照表
使用 Raycast 时容易踩的坑
Sign In 与 Install 是两个独立的步骤
在 Raycast 中，安装服务器和授权服务器是两个操作，而服务器在完成第一步后就会出现在列表中。刚安装但未授权的服务器，其工具调用会以 401 失败，看起来像是服务器坏了，而实际上只是设置没做完。请点击 Sign In。
启动器很快，而这是一把双刃剑
Raycast 的意义就在于念头一起，按两下键操作就完成了。这对搜索和分拣非常好，也正因如此，发送操作在这里比在反应较慢的客户端里更值得多看一眼。要么不给这个连接 send:email，要么开启人工审批，让每次发送都等待人工处理。
不会有任何东西自动送达
服务器只做请求与响应，没有 webhook，也没有推送。Raycast 只有在你让它去看时才会看到邮件，这正适合启动器的使用方式：打开、提问、得到答案。但这也意味着它不是通知工具，像“X 到了就告诉我”这样的常驻需求，这个连接做不到。
值得了解的限制
- 每个密钥的请求上限为每分钟 100 次、每小时 1,000 次、每天 10,000 次，此外还受你所在套餐的计费操作上限约束。
- 服务器只做请求与响应。没有 webhook，也没有服务器主动发起的事件，所以新邮件永远不会自己唤醒你的智能体。要对新到的邮件作出反应，请按计划轮询。
- 每次调用都会从你的邮箱服务商实时获取邮件，从不存储。我们只保存加密后的 OAuth 令牌或应用专用密码，因此令牌一经撤销或邮箱密码一经更改，访问会立即终止。
Raycast 与邮件：常见问题解答
如何将邮箱连接到 Raycast？
运行 Install MCP Server 命令，将 Transport 设为 HTTP，粘贴 https://mcpemails.com/api/mcp 并安装，然后点击 Sign In，通过 MCPEmails 授权。之后 Raycast AI 就拥有了读取、搜索、发送、回复、转发、整理和定时发送邮件的工具。
Raycast 需要 API 密钥吗？
不需要。Raycast 通过它的 Sign In 操作执行 OAuth 流程，所以不会在命令中输入任何机密。bearer 密钥是为其他无法做到这一点的客户端准备的。
Raycast 通过这种方式能访问哪些邮箱？
Outlook.com 和 Microsoft 365 通过 Microsoft 登录（工作账户可能需要 IT 管理员批准一次该应用）；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 使用应用专用密码；以及任何在标准端口上支持 IMAP 与 SMTP 的其他邮箱。客户端通过同一个连接看到所有邮箱：你的智能体会先调用 inbox_list 来发现每个已连接的邮箱及其 id，所以不需要在任何地方粘贴 UUID。
Raycast 会在我不知情的情况下发送邮件吗？
只有在你允许的情况下才会。发送受 send:email 权限范围控制，没有该权限的密钥或令牌根本无法发送。此外，收件箱所有者还可以在仪表盘中要求人工审批，届时每一次发送、回复、转发、草稿发送和定时发送都会被暂扣，直到有人放行。
我的邮件会存储在你们的服务器上吗？
不会。每封邮件都是为发起请求的那次调用从你的邮箱服务商实时获取，并直接交给你的客户端。我们只保存加密后的 OAuth 令牌或应用专用密码，以便后续调用能够完成认证。在仪表盘中删除该收件箱，或在邮箱服务商处撤销访问权限，连接会立即终止。