Zed 会对本服务器执行标准的 MCP OAuth 流程。它通过 RFC 7591 动态客户端注册 自行注册,所以不需要创建 client ID,并使用 S256 以 授权码加 PKCE 完成授权。整个过程从不传输客户端密钥,令牌也只携带你在我们的授权同意页面上批准的权限范围。它拿到的访问令牌有效期为一小时,并会自动刷新;令牌会以 OAuth: 加客户端名称的形式列在 Dashboard、API Keys 中,你也在那里撤销该连接。
本页的所有内容,都是把这个 URL 填入 Zed 的方法。
| 字段 | 值 |
|---|---|
| MCP 服务器 URL | https://mcpemails.com/api/mcp |
| 传输方式 | Streamable HTTP (MCP 2025-06-18) |
| 认证 | OAuth 2.1,带 PKCE 的授权码流程。无需 API 密钥。 |
共四步。前两步对所有客户端都一样,其余步骤专门针对这个客户端。
在 mcpemails.com 注册,无需绑卡,然后前往 Dashboard、Inboxes、Connect Inbox。Outlook 和 Microsoft 365 通过 Microsoft 登录连接;Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 需要应用专用密码;其他邮箱都可通过标准 IMAP 与 SMTP 连接。免费版包含 1 个收件箱,永久有效。
在 Agent Panel 设置中点击 Add Custom Server,或直接编辑 settings.json。
在 context_servers 下添加下面的条目。
在未设置 Authorization 标头时,Zed 会发起 OAuth 流程。用 MCPEmails 登录,并批准你希望 Zed 拥有的权限范围。
{
"context_servers": {
"mcpemails": {
"url": "https://mcpemails.com/api/mcp"
}
}
}Zed 关于远程 MCP 服务器的官方文档: https://zed.dev/docs/ai/mcp
不确定先连接哪个邮箱? 查看邮箱服务商兼容性对照表
Zed 根据你是否配置了 Authorization 标头,在 OAuth 和静态令牌之间做选择。设置了标头,Zed 就会使用它,并且永远不会提示;留空,Zed 就会运行浏览器授权流程。只填了一半的该字段,正是有人最终得到一个既不提示也无法认证的服务器的原因。
设置键是 context_servers。它就是同一个 MCP,来自其他客户端的片段除了外层键之外都是正确的,而这恰恰是仔细检查也容易漏掉的那种差别。
邮件工具是智能体工具。连接成功不会改变行内补全的任何表现;要确认连接是否成功、查看有哪些工具到位,应该去 Agent Panel。
从 Agent Panel 设置中添加一个自定义服务器,或在 settings.json 的 context_servers 下添加一个条目,url 为 https://mcpemails.com/api/mcp 。让 Authorization 标头保持为空,Zed 就会运行 OAuth 流程。之后 Agent Panel 就拥有了读取、搜索、发送、回复、转发、整理和定时发送邮件的工具。
不需要,只要你不设置 Authorization 标头即可,正是这一点让 Zed 发起 OAuth 流程。如果你更愿意自己管理令牌,bearer 密钥是另一种选择。
Outlook.com 和 Microsoft 365 通过 Microsoft 登录(工作账户可能需要 IT 管理员批准一次该应用);Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 使用应用专用密码;以及任何在标准端口上支持 IMAP 与 SMTP 的其他邮箱。客户端通过同一个连接看到所有邮箱:你的智能体会先调用 inbox_list 来发现每个已连接的邮箱及其 id,所以不需要在任何地方粘贴 UUID。
只有在你允许的情况下才会。发送受 send:email 权限范围控制,没有该权限的密钥或令牌根本无法发送。此外,收件箱所有者还可以在仪表盘中要求人工审批,届时每一次发送、回复、转发、草稿发送和定时发送都会被暂扣,直到有人放行。
不会。每封邮件都是为发起请求的那次调用从你的邮箱服务商实时获取,并直接交给你的客户端。我们只保存加密后的 OAuth 令牌或应用专用密码,以便后续调用能够完成认证。在仪表盘中删除该收件箱,或在邮箱服务商处撤销访问权限,连接会立即终止。