登录方式、邮件主机与传输安全性,以及真正让人搭上一下午的那个故障。选一家服务商即可查看逐步设置。
| 服务商 | 登录方式 | IMAP(接收) | SMTP(发送) | 常见故障 |
|---|---|---|---|---|
| Gmail(IMAP) | 专用应用密码 | imap.gmail.com993 · TLS | smtp.gmail.com465 · TLS | Google 账户没有开启两步验证时,根本不会出现应用专用密码这个选项;如果 Workspace 管理员在整个域上关闭了应用专用密码,账户同样无法生成。Google 会把密码分成四段显示,其中的空格只是排版,登录前会被去掉。 |
| Gmail(API) | Google OAuth | 服务商 API,不走 IMAP | 服务商 API,不走 IMAP | 传输层没有问题:这一行连的是 gmail.googleapis.com 而不是 IMAP。出问题的是授权。本应用未经 Google 验证,登录页会带一条必须点开的警告,而且 Google 规定未验证应用一生中最多只能获得 100 个账户的授权,这个计数无法重置。正是这个上限,让上面的应用专用密码成为默认方式。连上之后的限制是语义上的:用标签而不是文件夹,没有原生复制,也不支持彻底删除。 |
| Fastmail | 专用应用密码 | imap.fastmail.com993 · TLS | smtp.fastmail.com465 · TLS | 普通账户密码会被直接拒绝。Fastmail 会生成一个 16 位的应用密码,而提交登录密码是连接失败最常见的单一原因。 |
| iCloud Mail | 专用应用密码 | imap.mail.me.com993 · TLS | smtp.mail.me.com587 · STARTTLS | 必须先开启双因素认证,Apple 才会生成专用应用密码。Apple 会把密码显示为四组带连字符的字符;连字符只是显示用的,发送登录前会被去掉。 |
| Yahoo Mail | 专用应用密码 | imap.mail.yahoo.com993 · TLS | smtp.mail.yahoo.com465 · TLS | Yahoo 最多只允许 5 个并发连接。它的拒绝提示“Incorrect username or password”是故意把两者一起列出的,并不会告诉你错的是哪一个。 |
| Zoho Mail | 专用应用密码 | imap.zoho.com993 · TLS | smtp.zoho.com465 · TLS | Zoho 默认关闭 IMAP 访问,需要先手动开启。Zoho 还运营六个区域数据中心,付费的自有域名邮箱位于 imappro/smtppro 而非 imap/smtp,因此正确的主机同时取决于区域和账户类型。 |
| Yandex Mail | 专用应用密码 | imap.yandex.com993 · TLS | smtp.yandex.com465 · TLS | Yandex 未实现 RFC 4959 SASL-IR,因此内联登录形式返回的是命令语法错误,而不是凭据错误。需同时开启“IMAP”和“应用密码与 OAuth 令牌”,而 Yandex 360 自有域名账户的登录名可能并非邮箱地址。 |
| Microsoft 365 / Outlook | Microsoft OAuth | 服务商 API,不走 IMAP | 服务商 API,不走 IMAP | 个人 Microsoft 账户(outlook.com、hotmail.com、live.com、msn.com)可直接连接。工作和学校账户则不同:Microsoft 默认的同意策略不允许员工自行批准邮件权限,因此控制台会提供一个可分享的审批链接,供你发给 IT 管理员,由管理员为整个组织一次性批准该应用,管理员无需 MCP Emails 账户;之后所有人都可以正常连接。没有 Exchange Online 邮箱的 Microsoft 账户会被拒绝,并提示改用 IMAP 连接该地址。对于新注册且集中批量发信的 outlook.com 账户,Microsoft 可能出于其自身的反滥用检查而暂时阻止发信。 |
| 通用 IMAP | 邮箱密码 | 你的主机商设置993 / 143 · TLS / STARTTLS | 你的主机商设置465 / 587 · TLS / STARTTLS | 端口与安全模式对不上。端口仍为 993 却选了 STARTTLS,会对一个只说 TLS 的监听端口开启明文连接,连接只会一直等到超时。现在失败的传输会自动换另一种标准组合重试。 |
Gmail 的两种连接方式:Google 邮箱既可以用应用专用密码通过 imap.gmail.com 连接(默认方式),也可以用 Google 登录,走 Gmail API 而不是 IMAP。连接窗口里两种都提供,两种也都能继续使用。选哪一种决定了之后代理能做什么,所以下面的功能表为每一种各列一栏:Gmail(IMAP)对应应用专用密码,Gmail(API)对应 Google 登录。
传输自动检测:若一次连接始终未能建立会话,会换到另一种标准传输重试(IMAP 993/TLS 与 143/STARTTLS;SMTP 465/TLS、587/STARTTLS 与 25)。被拒绝的密码从不重试,因为每次尝试都会计入服务商自己的锁定。
登录机制:大多数服务器可以一次往返完成 AUTH PLAIN。只声明 GSSAPI、NTLM 和 LOGIN 的服务器(最常见的是 Microsoft Exchange)会回应 504 5.7.4,客户端会自行回退到 AUTH LOGIN。
其他主机商:IONOS、Hostinger、OVH、OVH Hosted Exchange、DreamHost、Titan Email、Namecheap Private Email、Migadu、InMotion Hosting、OpenSRS、GMX 和 mail.com 会根据你输入的地址或邮件主机自动识别,并为你填好主机、端口和传输安全性。
MCP 客户端在每家服务商上可执行的操作:读取、搜索、发送、回复、转发、移动、标记、文件夹、草稿、定时发送与附件。
Gmail(IMAP)、Fastmail、iCloud、Yahoo、Zoho、Yandex 和通用 IMAP 全部通过同一个 IMAP/SMTP 传输连接(Gmail、Fastmail 和 iCloud 使用应用专用密码),并共享完全相同的功能集,包括 IMAP 搜索语法。这些列分开展示只是为了清晰。Gmail(API)是唯一不走 IMAP 的 Gmail 列:同一个邮箱,改为通过 Google 登录和 Gmail API 访问。Outlook 同样不走 IMAP:它通过 Microsoft 登录连接,并经由 Microsoft Graph 工作。
exact 表示规范化后的操作保持原有含义,different 表示服务商使用有文档记录的替代语义,unavailable 表示 MCP Emails 不会在你不知情的情况下削弱该请求。配置文件只描述连接器的行为,不会检查或存储邮件。| 功能 | Gmail(IMAP) | Gmail(API) | Outlook | Fastmail | iCloud | Yahoo | Zoho | Yandex | 通用 IMAP |
|---|---|---|---|---|---|---|---|---|---|
| 核心 | |||||||||
| 下载原始邮件(.eml) | |||||||||
| 读取邮件 | |||||||||
| 搜索 | |||||||||
| 发送邮件 | |||||||||
| 回复 | |||||||||
| 转发 | |||||||||
| 标记与状态 | |||||||||
| 已读/未读 + 星标标记 | |||||||||
| 文件夹与标签 | |||||||||
| 文件夹 | |||||||||
| 标签 / 标记 | |||||||||
| 移动 | |||||||||
| 复制 | |||||||||
| 删除 | |||||||||
| 删除 / 移至回收站 | |||||||||
| 永久删除(彻底清除) | |||||||||
| 草稿 | |||||||||
| 草稿(创建 / 编辑 / 发送) | |||||||||
| 联系人 | |||||||||
| 联系人搜索(实时扫描) | |||||||||
| 定时 | |||||||||
| 定时发送 | |||||||||
| 签名 | |||||||||
| 签名(发送时自动应用) | |||||||||
| 搜索 | |||||||||
| 搜索语法 | IMAP | Gmail | KQL | IMAP | IMAP | IMAP | IMAP | IMAP | IMAP |
Gmail 的文件夹与标签:Gmail 使用扁平的标签系统而非分层的文件夹。“移动”是通过添加/移除标签来实现的。Gmail REST API 不提供原生复制。这些 Gmail 行描述的是 Gmail API 连接器:使用应用专用密码通过 IMAP 连接的 Gmail 邮箱适用 IMAP 各列,包括复制。
Outlook(Microsoft Graph):搜索使用 KQL。文本条件(from、to、cc、subject、body、text 或 query)不能与 unread、has_attachment、flagged 或日期筛选组合使用:两者同时发送时,这些筛选不会生效,结果会说明哪些被忽略;而会对每个匹配项执行操作的工具则会直接拒绝这种组合。Outlook 使用文件夹而非标签,因此标签工具仅适用于 Gmail;自动化的标签操作会应用 Outlook 类别。附件:发送时每封邮件最多 10 MB,下载附件或转发原始邮件时最多 25 MB。
永久删除:Gmail API 会把删除的邮件移到回收站,不提供永久彻底清除。Microsoft Graph 则提供:在 Outlook 邮箱上设置 permanent: true 会使用其 permanentDelete,跳过“已删除邮件”。所有 IMAP 邮箱(用应用专用密码连接的 Gmail、Fastmail、iCloud、Yahoo、Zoho、Yandex、通用)都同时支持回收站和硬性彻底清除。
联系人搜索(实时扫描):所有服务商都支持 contact_search,它通过对你近期一段匹配邮件进行实时、仅读取邮件头的扫描来查找匹配的联系人。不存在联系人表,在两次调用之间不存储任何内容,且数量仅反映所扫描窗口内匹配的邮件。
定时:通过服务器端的 scheduled_sends 队列为所有服务商提供支持。使用 schedule 工具的 create、list 和 cancel 操作。投递使用每个服务商现有的发送路径,无需服务商原生的定时 API。
签名:每个收件箱的签名会在每次发送、回复、转发、草稿和定时邮件时由服务器端追加,这适用于所有服务商。签名支持富文本 HTML 格式(粗体、斜体、标题、列表、颜色、对齐、链接)以及托管的徽标/图片;可在仪表盘的富文本编辑器或 signature MCP 工具(接受 signature_html)中设置。图片以托管的 https URL 引用,可在所有服务商中显示,不过某些客户端(如 Gmail)可能会先隐藏图片,直到收件人点击“显示图片”,对于任何含托管图片的签名,这都是正常现象。使用 signature_reply_mode 控制其是否出现在回复和转发中。按单次调用,在 email_compose 或 draft 上传入 include_signature: false 可跳过它。 仪表盘中的同一收件箱面板还提供“发件人名称”字段,即收件人在该收件箱发送的所有邮件中看到的地址旁名称。
转发:在所有服务商上,转发都会逐字节转发原始邮件:其 HTML、内嵌图片、附件和 MIME 结构会与发送时完全一致地到达,位于你的备注和常规的转发邮件头之下。原始邮件最大 25 MB。as_attachment 会改为把整封原始邮件作为 .eml 部分发送,include_attachments: false 则不带附件文件。