Claude Code 如何连接：OAuth，无需 API 密钥
Claude Code 会对本服务器执行标准的 MCP OAuth 流程。它通过 RFC 7591 动态客户端注册 自行注册，所以不需要创建 client ID，并使用 S256 以 授权码加 PKCE 完成授权。整个过程从不传输客户端密钥，令牌也只携带你在我们的授权同意页面上批准的权限范围。它拿到的访问令牌有效期为一小时，并会自动刷新；令牌会以 OAuth: 加客户端名称的形式列在 Dashboard、API Keys 中，你也在那里撤销该连接。
你唯一需要的值
本页的所有内容，都是把这个 URL 填入 Claude Code 的方法。
| 字段 | 值 |
|---|---|
| MCP 服务器 URL | https://mcpemails.com/api/mcp |
| 传输方式 | Streamable HTTP (MCP 2025-06-18) |
| 认证 | OAuth 2.1，带 PKCE 的授权码流程。无需 API 密钥。 |
如何将 Claude Code 连接到你的收件箱
共四步。前两步对所有客户端都一样，其余步骤专门针对这个客户端。
创建免费账户并连接邮箱
在 mcpemails.com 注册，无需绑卡，然后前往 Dashboard、Inboxes、Connect Inbox。Outlook 和 Microsoft 365 通过 Microsoft 登录连接；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 需要应用专用密码；其他邮箱都可通过标准 IMAP 与 SMTP 连接。免费版包含 1 个收件箱，永久有效。
添加服务器
运行下面的命令。--transport http 即 Streamable HTTP 传输方式，也正是本服务器使用的传输方式。
完成认证
在 Claude Code 会话中运行 /mcp，选择本服务器并按浏览器流程操作。如果浏览器没有自动打开，请复制它打印出的 URL。
提个需求试试
试试“总结今天所有未读邮件”。Claude Code 会先调用 inbox_list 来发现你的邮箱，所以不需要粘贴任何 id。
claude mcp add --transport http mcpemails https://mcpemails.com/api/mcpClaude Code 关于远程 MCP 服务器的官方文档： https://code.claude.com/docs/en/mcp
不确定先连接哪个邮箱？ 查看邮箱服务商兼容性对照表
使用 Claude Code 时容易踩的坑
Claude Code 会延迟加载 MCP 工具定义，而在这里这是件好事
默认情况下，Claude Code 在会话开始时只加载工具名称和服务器说明，需要时才获取完整的 schema。实际效果是：添加本服务器所占用的上下文只是一个粗放实现的 MCP 服务器的一小部分，而你从不使用的工具也永远不会占用它的 schema。
按会话的用途限定连接的权限范围
OAuth 授权同意页面决定了 CLI 在令牌有效期内能做什么。一个只应读取邮件、绝不应发送邮件的编码会话，就对应一个不含 send:email 的令牌。以后如果需要更多权限，重新连接并批准更大的范围即可；任何权限都不会自行升级。
智能体循环加上发送权限，是一个值得慎重考虑的组合
Claude Code 会长时间无人值守地运行，而这恰恰是误发邮件危害最大的时候。为此有两个开关：让令牌不包含 send:email，或者在仪表盘中开启人工审批，让每一次发送、回复、转发和定时发送都等待人工处理。审批按收件箱设置，无论调用来自哪个客户端都会生效。
值得了解的限制
- 每个密钥的请求上限为每分钟 100 次、每小时 1,000 次、每天 10,000 次，此外还受你所在套餐的计费操作上限约束。
- 服务器只做请求与响应。没有 webhook，也没有服务器主动发起的事件，所以新邮件永远不会自己唤醒你的智能体。要对新到的邮件作出反应，请按计划轮询。
- 每次调用都会从你的邮箱服务商实时获取邮件，从不存储。我们只保存加密后的 OAuth 令牌或应用专用密码，因此令牌一经撤销或邮箱密码一经更改，访问会立即终止。
- OAuth 流程需要用一次浏览器。在没有图形界面的机器上，改为在 Authorization 标头中用 API 密钥添加服务器，完全跳过该流程。如果你确实想在那里使用 OAuth，
--callback-port可以把回调固定到一个你能转发的端口上。
Claude Code 与邮件：常见问题解答
如何将邮箱连接到 Claude Code？
通过 URL 添加本 MCP 服务器：claude mcp add --transport http mcpemails https://mcpemails.com/api/mcp 。然后在会话中运行 /mcp 并完成浏览器登录。之后 Claude Code 就拥有了读取、搜索、发送、回复、转发、整理和定时发送邮件的工具。
可以用 API 密钥代替 OAuth 吗？
可以。Claude Code 的 add 命令可以附带标头，所以传入一个 Authorization 标头，并带上 Dashboard、API Keys 中的 bearer 密钥，就能完全跳过浏览器。在没有图形界面的机器上或 CI 中，没有地方完成登录，这正是正确的选择。
在 devcontainer 或 SSH 中能用吗？
能，但要注意 OAuth 流程需要用一次浏览器。你可以在有浏览器的地方完成登录，也可以用 bearer API 密钥标头添加服务器，跳过该流程。之后的一切都只是访问单个端点的普通 HTTPS。
Claude Code 通过这种方式能访问哪些邮箱？
Outlook.com 和 Microsoft 365 通过 Microsoft 登录（工作账户可能需要 IT 管理员批准一次该应用）；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 使用应用专用密码；以及任何在标准端口上支持 IMAP 与 SMTP 的其他邮箱。客户端通过同一个连接看到所有邮箱：你的智能体会先调用 inbox_list 来发现每个已连接的邮箱及其 id，所以不需要在任何地方粘贴 UUID。
Claude Code 会在我不知情的情况下发送邮件吗？
只有在你允许的情况下才会。发送受 send:email 权限范围控制，没有该权限的密钥或令牌根本无法发送。此外，收件箱所有者还可以在仪表盘中要求人工审批，届时每一次发送、回复、转发、草稿发送和定时发送都会被暂扣，直到有人放行。
我的邮件会存储在你们的服务器上吗？
不会。每封邮件都是为发起请求的那次调用从你的邮箱服务商实时获取，并直接交给你的客户端。我们只保存加密后的 OAuth 令牌或应用专用密码，以便后续调用能够完成认证。在仪表盘中删除该收件箱，或在邮箱服务商处撤销访问权限，连接会立即终止。