只读访问

只读连接能做什么

• 它持有 read:email 权限，也可以附带 search:email，但后者不增加任何能力。
• 它可以列出、读取和搜索邮件，下载附件，并列出收件箱和文件夹。
• 它不能发送、回复、起草、移动、加旗标、标为已读、删除、定时发送或创建自动化。

如何选择

• 连接 AI 客户端时，授权页面会提供访问级别。选择 只读（“读取和搜索您的邮件。无法发送、更改或删除任何内容。”），或打开 自定义权限 只授予读取。您还可以只允许连接访问部分收件箱。
• ChatGPT 打开此页面时默认选中 完全访问,因为它之后无法回来申请更多权限。请在点击 允许访问 之前选择 只读。
• 在控制台创建的 API 密钥也可以限制为相同的权限。

限制如何执行

• 每次工具调用都会在我们联系您的邮件服务器之前，按连接的权限进行检查。超出授权的调用会以 insufficient_scope 被拒绝。
• 对于 IMAP 邮箱，只读连接用 EXAMINE（SELECT 的只读形式）打开每个文件夹。这样，在该会话中，无论我们的代码做什么，您的邮件服务商本身都会拒绝任何旗标更改、移动或删除。
• 邮件内容通过 BODY.PEEK 获取，因此读取邮件永远不会把它标为已读。这适用于所有连接，而不仅是只读连接。
• 读取工具从不更改您的邮箱。它旧的 mark_as_read 选项已被移除；标为已读是单独的操作，需要 manage:folders 权限。
• 通过 OAuth 登录的 AI 客户端会看到完整的工具列表，以便向您申请更多权限。在您授予之前，这些调用仍会失败。

连接时会发生什么

• 我们建立 TLS 连接，验证服务器证书，登录一次以检查您的密码或应用专用密码，然后退出。
• 不会下载、复制或索引任何内容。只有当工具请求时，才会从您的服务商获取邮件。
• 后台任务只为自动化和定时发送运行，两者都需要只读连接所没有的写入权限。
• 如果您从不打算用该地址发信，连接时选择 高级设置 → 连接类型 → 仅接收 (IMAP)。不会配置或联系任何 SMTP 服务器。

搜索大型邮箱

• 对于 IMAP 邮箱，搜索在您服务商的服务器上通过 IMAP SEARCH 执行。我们只下载所请求的那一页结果，最多 100 封，AI 再逐页获取其余结果。
• 除非指定文件夹，搜索只覆盖收件箱，因为在大型账户的所有文件夹中搜索很慢。
• 每次搜索限时 30 秒。在有数万封邮件的邮箱中，请按发件人、主题或日期缩小宽泛的搜索。

自行核实

mcpemails 是开源的。以下文件实现并测试了本页所述内容：

• imap-read-only.ts 只读连接使用 EXAMINE
• imap-read-only.test.ts EXAMINE 的测试，包括服务商拒绝旗标更改
• scopes.ts 权限列表
• argument-aliases.ts 从读取工具中移除 mark_as_read
• imap-client.ts IMAP 客户端：每次获取内容都使用 BODY.PEEK