将 Mail-in-a-Box 连接到 Claude，
以及 Cursor、ChatGPT 和任意 MCP 客户端
你自建邮件服务器，就是为了不让别人掌握你的邮件。加入 AI 代理不必改变这一点：mcpemails 通过 IMAP 连接你的服务器，实时获取每封邮件，一封都不存储。
Claude 无法自行访问 Mail-in-a-Box 服务器。mcpemails 是一个托管 MCP 服务器，通过端口 993 的 IMAP 连接你的服务器，使用设置指南让你使用的主机名（通常是 box.yourdomain.com），并以在管理控制面板中创建的邮件用户的密码进行认证。这样 Claude、Cursor 或任意 MCP 客户端就能读取、搜索、发送并整理你服务器上的邮件。服务器必须能从互联网访问，并持有有效的 Let's Encrypt 证书，控制面板会为你配置该证书。1 个收件箱免费。
Mail-in-a-Box 如何连接：用服务器主机名，而不是你的域名
Mail-in-a-Box 会在一台 Ubuntu 机器上安装 Postfix、Dovecot、Nginx 和一个小型管理控制面板，所以底层的 IMAP 行为就是普通的 Dovecot。人们出错的地方是主机名。设置指南建议把服务器命名为 box 加一个点再加你的域名，即 box.yourdomain.com，证书上写的就是这个名称，你的邮件客户端也应该使用它。你的裸域名是邮件的收件地址，而不是客户端连接的地方。文档中列出的防火墙端口是：22、25、53（TCP 和 UDP）、80、443、465（提交）、993（IMAP）、995（POP）和 4190（Sieve）。凭据是邮件用户自己的密码，在控制面板的 Mail、Users 下设置；控制面板的管理员其实就是一个拥有管理员权限的邮件用户，所以它有自己的邮箱，连接方式与其他用户相同。
一个代理真正能用的 Mail-in-a-Box 收件箱
十七个基于动作的 MCP 工具：发送、回复、转发、定时和整理。代理在 Mail-in-a-Box 内即可完成整件事。
- 01读取
读取与搜索邮件
跨文件夹列出、读取和搜索，找到那张发票、总结一个会话，或拉取某发件人的最新邮件。
- 02发送
发送、回复与转发
撰写并发送真实邮件、在会话中回复并转发，直接从你的邮箱完成，而不是留下需要你手动发送的草稿。
- 03定时
定时稍后发送
将邮件排入队列在合适时间发出，代理现在撰写、按计划发送。
- 04整理
移动、复制、标记、归档、删除
保持收件箱整洁：将邮件归入文件夹、标记重点、归档其余，或按需删除。
四步连接 Mail-in-a-Box
从注册到第一封 AI 邮件，仅需几分钟。
创建免费账户
注册 mcpemails，无需信用卡。免费套餐可永久连接一个收件箱。
从控制面板获取正式证书
登录你服务器的管理控制面板，依次打开 System、TLS (SSL) Certificates。新装的服务器在你从该页面配置免费的 Let's Encrypt 证书之前，使用的是自签名证书，而在你早已不再注意浏览器警告之后很久，严格的 IMAP 客户端仍会拒绝这张自签名证书。
确认邮件用户及其密码
在 Mail、Users 下确认该地址存在，并设置一个你知道的密码。然后在 mcpemails 中添加收件箱：选择 IMAP / SMTP，服务器填 box.yourdomain.com，并输入完整地址和该密码。
将 MCP URL 粘贴到你的 AI
把 https://mcpemails.com/api/mcp 粘贴到 Claude、Cursor 或 ChatGPT 中，完成授权，代理便拥有该收件箱。
想先比较各家服务商？ 查看邮箱服务商兼容性对照表
公司在 Mail-in-a-Box 上的每一个邮箱，都在同一个智能体上
如果你的公司在 Mail-in-a-Box 上有不止一个地址，例如 info@、sales@ 和 invoices@，请把每个地址都连接到同一个 mcpemails 工作区。这样你的 AI 客户端就能通过同一个 MCP URL 访问所有邮箱，无论是在 Claude、ChatGPT、Cursor 还是其他 MCP 客户端中。每次工具调用都会指明它操作的邮箱，每个邮箱保留自己的发件人名称和签名，回复从该邮件所属的邮箱发出。
免费版连接一个邮箱，Personal 连接三个，Pro 连接你管理的所有邮箱，只需一个登录。
Mail-in-a-Box 真正容易出问题的地方
测试错误密码会让 fail2ban 封禁你
Mail-in-a-Box 默认开启 fail2ban 并监视邮件服务，这也是它能安全地放在公网上的原因之一。但这也意味着，用带错字的密码保存两三次连接，就会让连接地址被封禁，之后的每次尝试都会超时或被拒绝，而不是返回认证错误。症状看起来像是服务器宕机了。请先把密码弄对；如果已经触发了封禁，请先在服务器上解除封禁再重试。
这里的提交端口是 465，而 587 不在文档列出的端口中
互联网上的大多数邮件设置说明都会用 587 加 STARTTLS。Mail-in-a-Box 自己的指南在必须开放的端口中把 465 列为提交端口，并没有列出 587。用 465 加隐式 TLS 配置发信，第一次就能成功；如果因为其他地方都用 587 就想当然地用 587，你得到的是一个卡住的连接，而不是明确的错误。
服务器的名称不能与你在别处托管的网站共用
指南直截了当地指出，服务器的名称不能是你打算在另一台主机上用来提供网站的域名，因为服务器需要在 80 和 443 上响应，用于自身的证书续期和控制面板。把 box.yourdomain.com 指向 CDN 或反向代理的运维人员，会在不造成任何可见故障的情况下破坏 Let's Encrypt 续期，几周后 IMAP 证书就会悄悄过期。
Mail-in-a-Box 的已知限制
- 你的服务器必须接受来自外部的 993 入站连接，托管 MCP 服务器才能访问它。位于 NAT 之后的家庭网络上的 Mail-in-a-Box，或者被云安全组限制为只允许你自己地址访问的服务器，都无法连接。如果你希望 IMAP 会话留在自己的网络内，mcpemails 可以自托管。
- Mail-in-a-Box 希望自己掌管服务器主机名的 DNS 和 TLS，所以在标准的、未经修改的安装上效果最好。经过大量定制的服务器，出示的证书可能与控制面板以为的不一样。
Mail-in-a-Box 与 AI：常见问题解答
Claude 能用于 Mail-in-a-Box 吗？
不能直接使用。Claude 没有针对你自己运行的邮件服务器的连接器。通过 IMAP 将 mcpemails 这样的 MCP 服务器连接到你的服务器后，Claude 就能读取、搜索、发送、回复、定时和整理其上邮箱中的邮件，同一个收件箱随后也可在 Cursor 或 ChatGPT 中使用。
Mail-in-a-Box 的 IMAP 和 SMTP 设置是什么？
服务器是你的服务器主机名，通常是 box.yourdomain.com。IMAP 为端口 993，使用隐式 TLS。提交为端口 465，使用隐式 TLS，这是官方指南列出的端口。请用某个邮件用户的完整邮箱地址和该用户的密码登录。
为什么我的 Mail-in-a-Box 密码被拒绝？
请检查你用的是邮件用户，而不是一个只作为别名存在的名称，因为别名既没有密码也没有邮箱。如果密码正确而连接仍然失败，可能是 fail2ban 因之前的失败尝试封禁了连接地址，其表现是连接被拒绝或超时，而不是登录错误。
我必须把服务器暴露在互联网上吗？
对于托管服务来说，是的：mcpemails 需要从外部连入端口 993。无论如何这都是 Mail-in-a-Box 的正常状态，因为它本来就必须在端口 25 上接收来自全世界的邮件。如果你特意把访问限制为只允许你自己的地址，请改为自托管 mcpemails，让 IMAP 连接始终不离开你的网络。
我的邮件会存储在你们的服务器上吗？
不会。每次请求都通过 IMAP 从你的服务器实时获取邮件，并传给你的 AI 客户端。凭据静态加密存储，邮件正文不会保留，这也正是你当初自建服务器的原因。
我可以把多个 Mail-in-a-Box 邮箱连接到同一个 AI 智能体吗？
可以。把每个 Mail-in-a-Box 地址连接到同一个 mcpemails 工作区，你的 AI 客户端就能通过同一个 MCP URL 访问所有邮箱。每次工具调用都会指明它操作的邮箱，所以对 sales@ 中邮件的回复会从 sales@ 发出。免费版连接一个邮箱，Personal 连接三个，Pro 连接你管理的所有邮箱。