EngageLab Agent Email MCP Server 是 EngageLab 官方的邮件项目，以本地 stdio MCP 服务器的形式分发，不提供托管式 OAuth 或 HTTP MCP 端点，需在本地通过安装命令运行。它让 AI 智能体通过 Model Context Protocol 发送、接收和回复邮件。
用途：每个智能体分配独立邮箱（真实地址，可收发），对话按线程分组，使智能体掌握完整历史上下文。适用于需要邮件对话的场景，如客服、日程安排、审批等。
主要能力：
- 发送与接收：智能体拥有专用邮箱，而非外挂解析 webhook。
- 线程感知：回复自动归入同一对话，智能体可见完整历史。
- 沙盒模式：不向真实用户发送邮件即可测试智能体流程。
- 单环境变量：本地使用无需 OAuth，区域根据密钥前缀自动推断。
使用方式：
- 获取 Secret Key：创建 EngageLab 账户，在控制台生成密钥（格式 sk_sg_xxx，前缀决定区域）；或使用 CLI：engagelab-email-cli login 通过浏览器创建。
- 创建邮箱：在控制台为智能体创建邮箱（共享子域即时可用；自定义域名需 DNS 验证）。程序化创建邮箱在路线图中。若 list_mailboxes 返回空，说明账户尚无邮箱。
- 注册服务器：在 Claude Desktop 的 claude_desktop_config.json 中添加配置块。 安装命令（构建 MCPB 包）：生成的包位于 dist/engagelab-agent-email.mcpb，可通过 Smithery 发布上传。 该服务器也已列入官方 MCP Registry，服务器名为 io.github.Metaverse-Cloud/engagelab-email，npm 包为 @engagelabemail/mcp。
适用场景：兼容 Claude Desktop、Claude Code、Cursor、Cowork 及任何 MCP 兼容客户端。典型循环例如客服机器人。
限制：每条消息最多 10 个附件，总计 10MB（工具 schema 中为 base64 编码）。
故障排除：
- list_mailboxes 返回空列表：账户无邮箱，需在控制台创建（智能体尚不能自行开通邮箱）。
- 401 / code 100101：Secret Key 错误或已撤销，检查 ENGAGELAB_EMAIL_SECRET_KEY 及区域前缀（sk_sg_ / sk_tr_）是否与所用端点匹配。
- 无法确定 API base URL：密钥区域前缀无法识别，需显式设置 ENGAGELAB_EMAIL_BASE_URL。
- 回复显示为新对话：应使用 reply_email（而非 send_email）以保留 In-Reply-To 头及线程。
路线图：托管式 MCP（OAuth）零配置远程使用；通过 Secret Key 程序化创建邮箱；Webhook 推送（无需轮询）用于 check_new_messages；基于 URL 的附件引用（无需在上下文中使用 base64）。
其他：可从源码运行；EngageLab Agent Email CLI 提供终端操作同一邮箱，--json 输出便于智能体使用；EngageLab Node SDK / Python SDK 可从代码发送邮件。
