用途：通过 OAuth 2.0 为 Gmail 和 Google Calendar 两个 MCP 服务器完成认证，适用于首次安装后、codespace 重建后或 MCP 认证失败时。
前置条件：需要一个 Google Cloud Platform 项目，并创建 Desktop 类型的 OAuth 2.0 客户端 ID；下载 OAuth JSON，并同时放入两个位置：~/.gmail-mcp/gcp-oauth.keys.json 和 ~/.calendar-mcp/gcp-oauth.keys.json。需在 GCP 项目中启用 Gmail API、Google Calendar API 以及用于联系人查询的 People API。
操作步骤：先确认 OAuth 密钥存在，可用 ls ~/.gmail-mcp/gcp-oauth.keys.json ~/.calendar-mcp/gcp-oauth.keys.json；如缺少目录可用 mkdir -p ~/.gmail-mcp ~/.calendar-mcp 创建。随后执行认证命令，Gmail 为 node ${CLAUDE_PLUGIN_ROOT}/servers/gmail/index.js auth，Calendar 为 node ${CLAUDE_PLUGIN_ROOT}/servers/calendar/index.js auth，过程中会打开浏览器进行 OAuth 授权。认证完成后可用 ls ~/.gmail-mcp/credentials.json ~/.calendar-mcp/credentials.json 检查凭据是否生成，再运行 /mcp 重连两个服务器测试连通性，并向用户报告成功或失败。
故障排查：若端口 3000 被占用，可执行 lsof -ti:3000 | xargs kill -9 后重试；浏览器未自动打开时，从终端输出中手动复制认证 URL；出现 People API 错误时，确认 GCP 控制台中已启用 People API；令牌过期时重新运行此认证流程，正常使用中令牌会自动刷新，但长时间不活动后可能过期。
限制：具体收费、价格、支持平台及凭据有效期等细节暂未提供。