数据点： Google 在 2026 年 10 月 12 日公布，计划自 2026 年 11 月 11 日起拒绝未标记为 AI Agent 的 OAuth 客户端调用 Google Workspace MCP 服务器；截至 2026 年 11 月 3 日，这仍是待生效要求，Gmail MCP 仍处于 Developer Preview。官方更新日志
症状： MCP 能连接、工具也返回结果，但无法确认自家产品的测试邮件是否真的送达。
最快解法： 给 Agent 功能准备独立且已标记的 OAuth 客户端，再用获授权的 Gmail 测试账户核对读取；另用实际收件箱验证邮件实收。MCP 请求成功，不等于测试邮件已送达。
适合正在接入 Gmail MCP、需要核对客户端标记和读取权限的开发者。
适合要区分 MCP 连接、邮件读取、自家应用发信与收件箱实收的 QA。
适合维护混合应用、需要判断 Agent 与普通 Gmail REST API 是否拆分客户端的技术负责人。
最后更新于 2026 年 11 月 3 日；规则与范围核对自 Google Workspace 开发者更新日志及 Gmail MCP 配置文档。
先划清范围：MCP 与 Gmail REST API 不是同一项变更
这次要求针对调用 Google Workspace MCP 服务器的 OAuth 客户端，不是针对所有 Gmail API 应用。官方说明，只调用 Workspace REST API、且不属于 Agent 的应用不受该变更影响；如果同一个客户端同时服务 Agent 与非 Agent 功能，建议为 Agent 单独创建并标记客户端，原客户端继续用于普通功能。
| 集成方式 | OAuth 客户端处理 | 验收重点 |
|---|---|---|
| 只调用 Gmail REST API 的非 Agent 应用 | 不因这项 MCP 要求而必须标记 | 继续按既有 API 权限和邮件功能验收 |
| 调用 Gmail MCP 的 AI Agent | 使用已标记为 AI Agent 的客户端 | 核对客户端标记、用户授权与实际工具读取 |
| 同一应用同时含 Agent 与普通 API 功能 | 建议拆分 OAuth 客户端 | 分别验收 MCP 路径与 REST API 路径，避免证据混在一起 |
拆分不只是为了过规则检查。它还能让测试记录明确指出：某次授权、请求拒绝或读取失败，究竟来自 Agent 客户端还是普通 API 客户端。若继续共用，任何一方改动配置，都可能让另一条功能路径的验收结果变得难以解释。
客户端未标记 AI Agent，会怎样影响 Gmail MCP？
Google 给出的客户端设置项是 “Use this client for an AI-powered agent”，位置在 Google Auth Platform 的 Clients 中。官方计划自 2026 年 11 月 11 日起拒绝未标记客户端的 MCP 请求；没有标记的客户端在 2026 年 11 月 12 日仍会保持非 Agent 状态，之后要调用 MCP，需要创建已标记的新客户端并更新应用配置。变更范围与拆分建议
因此，生效前的验收应先确认客户端资格，但不能把计划中的拒绝写成已经全面发生。生效后，应使用获授权的测试项目和账户再次验证未标记客户端是否被拒绝，并同时确认已标记客户端是否能正常调用。记录测试日期和客户端标识，不要用一次成功连接推断全部环境都已符合要求。
授权通过，是否就代表邮件内容可读？
不是。客户端标记只说明客户端按要求声明了 Agent 用途；它不能代替用户授权，也不能证明读取工具可用。Google 的配置说明要求启用 Gmail API 与 Gmail MCP API，并在 OAuth 同意配置中加入所需范围；文档列出的配置范围包括 gmail.readonly 和 gmail.compose。Gmail MCP 配置步骤与范围
验收时要区分三个状态：
- 控制台配置了范围：只代表项目和同意配置已填写，不代表测试用户已完成授权。
- 用户完成授权：需要核对实际授权账户与应用请求的范围。邮件读取所需的权限应与预期工具匹配；不要把配置页面上的范围列表当成令牌已获权限的证据。
- 读取工具返回内容：才是该账户、该次授权、该项工具在当时条件下能读取数据的证据。
Gmail 的 gmail.readonly 属于受限范围，Google 说明相应范围可能涉及额外 OAuth 应用验证要求；只请求功能所需权限，并把授权账户限定为获准的测试账户。Gmail API 范围分类
| 验收指标 | 可接受的证据 | 不能据此推出 |
|---|---|---|
| 客户端资格 | 控制台记录显示 Agent 标记已启用 | 用户已经授权，或邮件已可读 |
| 授权范围 | 测试账户实际完成授权，且授权范围符合预期 | 所有工具都必然可用 |
| MCP 读取 | Agent 对测试账户中的目标样本返回预期字段或正文 | 自家产品邮件已发出或已送达 |
| 独立实收 | 目标收件箱中找到本次测试对应邮件 | Agent 已读取该封邮件 |
用受控样本关联 Agent 读取与自家产品邮件
“测试邮件真实收件”与“Gmail MCP 读取”可能发生在不同邮箱，必须先确定测试设计。若要验证 Agent 能读到自家应用发出的邮件，应用应把非敏感样本投递到该 MCP 授权的 Gmail 测试账户；若要验证独立收件服务是否收到邮件，则应在那个收件箱中单独检查。MCP 只读取它获授权访问的账户，不能替代对另一个收件箱的检查。
可在主题或正文放入本次测试专用、无个人信息的关联标记，例如 qa-run-20261103-a7f2。标记仅用于区分本次测试，不应包含用户姓名、真实验证码、订单号或生产数据。为了减少跨测试误匹配，样本也应使用独立测试账户，避免把测试邮件混进真实用户或重要账户的邮件中。
Gmail MCP 工具参考列出 10 项工具，包括 search_threads、get_thread 和 create_draft，但不包括发送邮件工具。search_threads 默认返回主题、摘要等有限字段；需要全文时，应再用 get_thread 获取线程内容。因此，“搜索到线程”与“拿到完整正文”也要分开记为不同验收点。官方 Gmail MCP 工具清单
从授权到实收：按指标记录验收证据
下列步骤适用于自家应用或获授权的测试环境，不应拿真实用户邮件、生产邮件或重要账户邮件做样本。
- 固定测试范围。 记录 Google Cloud 项目、MCP 客户端、目标功能和获授权测试账户。确认这次验证的是 Gmail MCP，还是普通 Gmail REST API。
- 核对客户端隔离。 若应用同时有 Agent 与非 Agent 功能，检查是否已拆分客户端；在 MCP 客户端设置中确认 Agent 标记已打开。将配置截图或审计记录与版本信息一并留存。
- 核对服务和授权配置。 确认项目启用了 Gmail API 与 Gmail MCP API，OAuth 同意配置包含功能所需范围。用指定测试账户完成实际授权，再核验该账户和授权结果；不要用客户端标记代替这一步。
- 生成非敏感样本。 让自家应用向授权 Gmail 测试账户发一封可识别的邮件，主题或正文加入本次测试标记。若检查的是另一只收件箱，另设独立样本，并明确它不属于 MCP 授权账户。
- 分层验证读取。 先用
search_threads按主题或标记查找线程，再用get_thread核对发件人、收件人、主题和预期正文。搜索结果默认可能只有摘要，不要将摘要误记为已读取全文。搜索工具的返回字段与限制 - 独立确认实收。 到目标收件账户检查本次样本是否存在，并记录邮件所在位置及关联标记。若测试的是自家应用发信，记录应用侧发送结果与收件箱证据；两者不要合并成一个“成功”状态。
- 形成可复查记录。 保存项目、账户、客户端标记、实际授权范围、调用工具、样本标记、读取结果和独立实收结果。规则生效后，再单独测试未标记客户端的拒绝表现，并注明日期、环境和受影响功能。
遇到失败时，按证据层逐段定位：客户端未标记或配置错，先查客户端；用户授权不匹配，重查账户与授权范围；工具能调用但查不到样本，核对搜索条件、目标账户和邮件是否实际进入该账户；应用显示已发但收件箱没有，则回到发信链路和收件端检查。Gmail API 的发送接口与 MCP 工具不是同一功能；MCP 的 create_draft 创建的是草稿，不能记作已发送邮件。Gmail API 发送方法
发布前复核：不要把四种“成功”合并
发布记录至少分开保留客户端配置、授权结果、MCP 工具读取、样本关联和独立收件证据。特别是，应用侧发信成功只证明发送调用得到相应结果；收件账户中找到邮件才证明它实际进入该账户；MCP 读取成功只证明 Agent 能访问该获授权账户中的对应内容。任何一项都不能替另一项背书。
提醒： Gmail MCP 仍在 Developer Preview。预览阶段的工具清单和行为可能变化；每次发布前都应重新检查官方配置与工具参考，不要把草稿创建写成邮件送达，也不要把一次 MCP 读取成功写成通用送达保证。
若只需验证自家应用是否能向一个受控地址投递非敏感测试邮件，可把独立收件箱作为收件证据之一；它不能代替 Gmail OAuth 测试账户，也不能证明 Agent 已读取邮件。OurTemp 页面说明，临时收件箱无需注册即可开始收信，默认有效期为 3 小时，并会显示收件状态；这适合短期、可替代的测试样本，不适合承载长期找回或重要账号。OurTemp 临时收件箱说明
若样本包含个人信息，还应先界定哪些数据进入测试邮件、谁能访问以及何时清理，可参考 OurTemp 的数据与隐私实践说明。临时邮箱只用于补充自家应用的邮件实收观察，不是 Gmail MCP 的授权账户；涉及支付、政务、工作主账号或长期找回时，仍应使用自己持续控制的邮箱。