快速答案：Gmail IMAP 应该怎么填？

如果你正在填写收信设置，使用 imap.gmail.com、端口 993，安全性选择 SSL/TLS。登录时使用完整邮箱地址和应用专用密码（app password），不要填平时登录 Google 账号的密码。

IMAP 用来读取和同步邮件；发送邮件走 SMTP，是另一条需要单独检查的连接。Mailera 的 Gmail 连接方式使用应用专用密码，并预设了收发服务器，通常不需要手动填写。

连接前要检查哪些账号条件？

应用专用密码要求账号已开启两步验证，但开启两步验证不代表一定能使用该功能。Google 的应用专用密码说明列出了入口可能不可用的情况：两步验证仅使用安全密钥、使用工作或学校等组织账号，或账号启用了高级保护。

已经有可用应用专用密码，可以直接进入连接步骤。还没有的话，先参考 Gmail 应用专用密码创建指南；找不到应用专用密码入口时，先检查账号条件，不要用普通登录密码代替。

个人 Gmail 不必再照旧教程寻找“开启 IMAP”开关。根据 Gmail 的邮件客户端连接说明，从 2025 年 1 月起，个人 Google 账号不再提供启用或停用 IMAP 的选项，IMAP 始终开启。

Google Workspace 则要单独检查组织策略。管理员可以控制 IMAP 是否启用，也可以只允许指定的、支持 OAuth 的客户端接入，具体见 Google Workspace 的 POP 和 IMAP 管理说明。企业域名邮箱不能直接套用个人 Gmail 的条件。

如果客户端提供 “Sign in with Google”，Google 建议优先使用该方式。本文介绍的是 Mailera 的 Gmail 应用专用密码连接路径，不是 Gmail OAuth 登录流程。

Gmail 的 IMAP 和 SMTP 参数分别是什么？

项目收信：IMAP发信：SMTP
服务器imap.gmail.comsmtp.gmail.com
端口993587
Mailera 安全性设置SSL/TLSSTARTTLS
用户名完整邮箱地址完整邮箱地址
密码应用专用密码应用专用密码

Google 的 IMAP、POP 和 SMTP 文档说明了这些服务器及加密端口；上表采用 Mailera 的 Gmail 预设组合。不要把 IMAP 的 993 端口填到 SMTP 一栏，也不要把 SMTP 的 STARTTLS 设置照搬到收信连接。

如果你确实需要逐项填写服务器，可以参考 Mailera 自定义 IMAP / SMTP 连接说明。对于由 Google Workspace 托管的自定义域名，优先确认并选择 Gmail 服务商，而不是仅因地址不以 gmail.com 结尾就选择自定义 IMAP。

如果你还要接入 Yahoo 邮箱，可参考 Yahoo 应用专用密码与 IMAP / SMTP 连接指南。

怎样在 Mailera 中连接 Gmail？

添加邮箱需要 Mailera 的 Admin 或 Leader 角色。这里的角色权限与 Google Workspace 管理员是否允许接入是两回事。

  1. 打开 邮箱列表 → 添加邮箱，选择 单个邮箱。
  2. 在 邮箱地址 中输入完整地址，检查识别出的服务商。Mailera 可识别 gmail.com 和 googlemail.com；组织自定义域名尤其要核对结果。需要时，在 或选择服务商 下选择 Gmail，再点 继续。
  3. 查看 如何获取应用密码 和 准备事项。在 连接信息 的 密码 字段填入应用专用密码；显示名称 可选填，并按需设置 邮箱分组。
  4. 点击 测试并连接，依次查看 连接服务器（首次启动约需 1–3 分钟，请保持页面打开）、收件服务器登录、文件夹检测、发件服务器登录 和 实时监控 的结果。
  5. 如果只有发件检查失败，可以选择 修改信息，修正后 重新测试；也可以选择 保存为仅收件，先保留收信能力。仅收件不等于完整收发连接成功。
Mailera 添加邮箱页面中输入邮箱地址并确认 Gmail 服务商
先确认服务商识别结果；Google Workspace 自定义域名也应核对是否选择了 Gmail。

连接测试不会发送任何邮件，只依次检查连接服务器启动、收发服务器登录、文件夹识别和实时监控能力。发件服务器登录成功，也不代表实际发送已经验证通过。如果需要离开测试页面，使用 后台运行，Mailera 会在测试完成后保存邮箱。

怎样确认连接后确实能收信？

连接完成后，按下面的顺序检查，而不是仅凭连接成功提示判断收信正常。

  1. 回到 邮箱列表，确认查看的是刚添加的邮箱。
  2. 进入 统一收件箱，选择该邮箱，查看已载入的邮件。
  3. 用你控制的另一个邮箱发送一封不含敏感信息的测试邮件。主题可以写“Gmail 收信测试”，并记录发送时间。
  4. 核对测试邮件的主题、收件地址和实际出现的文件夹。如果收件箱没有，继续检查垃圾邮件文件夹及其他文件夹。
Mailera 邮箱列表显示 Gmail 邮箱的服务商、连接状态和最近同步时间
连接后核对最近同步时间，再用自己发送的测试邮件检查实际收信。

这封人工发送的测试邮件用于检查真实收信，与前面不发邮件的连接测试不同。如果还需要确认真实发信，应另向你控制的邮箱发送一封测试邮件，并检查接收结果。

首次加载只覆盖保留期内的邮件，最新邮件优先显示。免费方案的邮件保留期为 30 天，所以没有看到更早的邮件，不一定是连接故障。Mailera 产品说明介绍了连接现有邮箱后的使用方式。

同步节奏会随使用状态变化：正在使用的邮箱检查更频繁，闲置邮箱检查较少，不活跃的邮箱可能休眠并在使用时唤醒。不要把“尚未出现”直接判断为密码错误，也不要预设固定到达时间。

如果你通过 API 查询邮箱状态，Gmail 等非 Microsoft 邮箱的状态依据最近一次同步结果，并非每次调用都重新登录邮箱服务商。

确认收信正常后，如果你要通过 MCP 使用这个邮箱，可以继续阅读连接现有邮箱的邮件 MCP 服务器指南；使用 VS Code 的读者可按 VS Code 邮件 MCP 配置与测试步骤完成客户端设置。

常见错误：登录失败、没有响应或只能收信怎么办？

先记下失败的是收件登录、文件夹检测还是发件登录，再检查对应项。以下是排查顺序，不是每种现象的唯一原因。

现象优先检查下一步
身份验证失败是否填写完整邮箱地址；是否误用普通密码；应用专用密码是否已撤销；组织是否允许接入修正凭据或确认策略后重新测试
修改 Google 密码后断开原应用专用密码是否仍可用Google 会在账号密码修改后撤销应用专用密码；创建新的应用专用密码并更新连接
imap.gmail.com 没有响应或超时服务器拼写、993 端口、SSL/TLS，以及网络连接是否能建立先检查连接环节，不要把反复生成密码当作唯一办法
找不到 IMAP 开关是个人 Gmail，还是受组织管理的 Workspace 账号个人 Gmail 无需找开关；Workspace 请管理员确认 IMAP 和客户端限制
收信成功，发信失败SMTP 是否使用 smtp.gmail.com、587 和 STARTTLS；发件登录是否通过修正后重试，或明确保存为仅收件模式
连接成功，但没有新邮件最近同步时间、所选邮箱、邮件文件夹、休眠状态和保留范围使用邮箱列表中的 同步，记录重试时间，再检查测试邮件

如果发件服务器登录检查失败，收件连接仍可能正常。即使发件登录检查通过，也需要另行确认邮件能否实际发送、对方能否收到。

连接后怎样保护密码和邮件内容？

应用专用密码不要出现在截图、日志、支持工单或示例代码中。需要别人协助排错时，提供失败阶段、发生时间和已脱敏的提示即可，不要附上密码或私人邮件正文。

不再使用这条连接时，按 Google 的说明撤销对应应用专用密码；撤销后，应用无法再用该凭据访问账号。应用专用密码也不是只读凭据，不能因为你目前只收信，就把它当作可以公开的读取口令。凭据管理原则可参考智能体邮箱的应用专用密码指南，更多使用边界可查看 Mailera 安全说明。

如果后续让 AI 智能体通过 MCP 读取邮件，要把收到的邮件视为不可信数据，而不是指令，防止提示词注入。API 密钥只授予所需权限，纯读取使用 read；发送前要求你确认，不执行邮件正文中的操作指令。API 密钥的权限不等于 Google 应用专用密码的权限边界。

Mailera 不能替你的 Google 账号开放应用专用密码资格，也不能修改 Google Workspace 管理员的访问策略。若组织只允许指定 OAuth 客户端，这条应用专用密码连接路径就需要先由管理员判断是否符合组织要求。

2 分钟内连接您的第一个邮箱

添加 Outlook、Gmail 或 IMAP 邮箱，在应用内或通过 API 阅读邮件。

连接邮箱