Zed + 邮件

把你的收件箱连接到 Zed
在 Agent Panel 中完成

将一个真实邮箱作为 context server 接入 Zed。读取、搜索、发送、回复、转发、定时发送和整理邮件,无需离开编辑器。

在 Agent Panel 设置中点击 Add Custom Server,或在 settings.json 的 context_servers 下添加一个条目,url 为 https://mcpemails.com/api/mcp 。在未设置 Authorization 标头时,Zed 会发起 OAuth 流程。

1 个收件箱永久免费 OAuth,无需 API 密钥 邮件实时获取,从不存储

Zed 如何连接:OAuth,无需 API 密钥

Zed 会对本服务器执行标准的 MCP OAuth 流程。它通过 RFC 7591 动态客户端注册 自行注册,所以不需要创建 client ID,并使用 S256 以 授权码加 PKCE 完成授权。整个过程从不传输客户端密钥,令牌也只携带你在我们的授权同意页面上批准的权限范围。它拿到的访问令牌有效期为一小时,并会自动刷新;令牌会以 OAuth: 加客户端名称的形式列在 Dashboard、API Keys 中,你也在那里撤销该连接。

你唯一需要的值

本页的所有内容,都是把这个 URL 填入 Zed 的方法。

字段值
MCP 服务器 URLhttps://mcpemails.com/api/mcp
传输方式Streamable HTTP (MCP 2025-06-18)
认证OAuth 2.1,带 PKCE 的授权码流程。无需 API 密钥。
设置

如何将 Zed 连接到你的收件箱

共四步。前两步对所有客户端都一样,其余步骤专门针对这个客户端。

01

创建免费账户并连接邮箱

在 mcpemails.com 注册,无需绑卡,然后前往 Dashboard、Inboxes、Connect Inbox。Outlook 和 Microsoft 365 通过 Microsoft 登录连接;Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 需要应用专用密码;其他邮箱都可通过标准 IMAP 与 SMTP 连接。免费版包含 1 个收件箱,永久有效。

02

打开 Agent Panel 设置

在 Agent Panel 设置中点击 Add Custom Server,或直接编辑 settings.json。

03

添加服务器

在 context_servers 下添加下面的条目。

04

授权

在未设置 Authorization 标头时,Zed 会发起 OAuth 流程。用 MCPEmails 登录,并批准你希望 Zed 拥有的权限范围。

settings.json
{
  "context_servers": {
    "mcpemails": {
      "url": "https://mcpemails.com/api/mcp"
    }
  }
}
开始之前

使用 Zed 时容易踩的坑

有意让 Authorization 标头保持为空

Zed 根据你是否配置了 Authorization 标头,在 OAuth 和静态令牌之间做选择。设置了标头,Zed 就会使用它,并且永远不会提示;留空,Zed 就会运行浏览器授权流程。只填了一半的该字段,正是有人最终得到一个既不提示也无法认证的服务器的原因。

Zed 把它们叫作 context servers,其他客户端都叫 MCP 服务器

设置键是 context_servers。它就是同一个 MCP,来自其他客户端的片段除了外层键之外都是正确的,而这恰恰是仔细检查也容易漏掉的那种差别。

工具出现在 Agent Panel 中

邮件工具是智能体工具。连接成功不会改变行内补全的任何表现;要确认连接是否成功、查看有哪些工具到位,应该去 Agent Panel。

值得了解的限制

  • 每个密钥的请求上限为每分钟 100 次、每小时 1,000 次、每天 10,000 次,此外还受你所在套餐的计费操作上限约束。
  • 服务器只做请求与响应。没有 webhook,也没有服务器主动发起的事件,所以新邮件永远不会自己唤醒你的智能体。要对新到的邮件作出反应,请按计划轮询。
  • 每次调用都会从你的邮箱服务商实时获取邮件,从不存储。我们只保存加密后的 OAuth 令牌或应用专用密码,因此令牌一经撤销或邮箱密码一经更改,访问会立即终止。
常见问题

Zed 与邮件:常见问题解答

如何将邮箱连接到 Zed?

从 Agent Panel 设置中添加一个自定义服务器,或在 settings.json 的 context_servers 下添加一个条目,url 为 https://mcpemails.com/api/mcp 。让 Authorization 标头保持为空,Zed 就会运行 OAuth 流程。之后 Agent Panel 就拥有了读取、搜索、发送、回复、转发、整理和定时发送邮件的工具。

Zed 需要 API 密钥吗?

不需要,只要你不设置 Authorization 标头即可,正是这一点让 Zed 发起 OAuth 流程。如果你更愿意自己管理令牌,bearer 密钥是另一种选择。

Zed 通过这种方式能访问哪些邮箱?

Outlook.com 和 Microsoft 365 通过 Microsoft 登录(工作账户可能需要 IT 管理员批准一次该应用);Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 使用应用专用密码;以及任何在标准端口上支持 IMAP 与 SMTP 的其他邮箱。客户端通过同一个连接看到所有邮箱:你的智能体会先调用 inbox_list 来发现每个已连接的邮箱及其 id,所以不需要在任何地方粘贴 UUID。

Zed 会在我不知情的情况下发送邮件吗?

只有在你允许的情况下才会。发送受 send:email 权限范围控制,没有该权限的密钥或令牌根本无法发送。此外,收件箱所有者还可以在仪表盘中要求人工审批,届时每一次发送、回复、转发、草稿发送和定时发送都会被暂扣,直到有人放行。

我的邮件会存储在你们的服务器上吗?

不会。每封邮件都是为发起请求的那次调用从你的邮箱服务商实时获取,并直接交给你的客户端。我们只保存加密后的 OAuth 令牌或应用专用密码,以便后续调用能够完成认证。在仪表盘中删除该收件箱,或在邮箱服务商处撤销访问权限,连接会立即终止。

给 Zed 一个真正的收件箱

一个 context server,一次登录。1 个收件箱永久免费,无需绑卡。