邮件 MCP 配置

邮件 MCP 用于让 Poco Agent 通过 SMTP 发送纯文本、HTML 或带附件的邮件。Poco 执行器镜像已预装 mcp-email，该 npm 包提供的可执行命令是 universal-email-mcp，不需要在任务启动时通过 npx 下载 npm 包。

本文介绍邮件发送所需的 stdio MCP 配置。读取邮件、动态配置邮箱服务器等其他能力，请查看 TimeCyber/email-mcp 项目文档。

配置前检查

配置邮件 MCP 前，先确认下面几点：

在邮箱设置中开启 SMTP 服务。
获取客户端授权码或应用专用密码，不要直接使用邮箱登录密码。
确认 Executor 容器可以访问对应 SMTP 主机和端口。
只给确实需要发送邮件的任务或 Agent 启用该 MCP。

保存邮箱环境变量

先在能力配置的环境变量页面保存以下变量：

变量	示例	说明
`EMAIL_USER`	`sender@example.com`	发件邮箱账号
`EMAIL_PASSWORD`	`your-auth-code`	邮箱授权码，保存时应标记为敏感变量
`EMAIL_TYPE`	`auto`	邮箱类型，个人邮箱通常使用 `auto` 自动识别

腾讯企业邮箱等自定义域名无法根据邮箱后缀自动识别时，需要把 EMAIL_TYPE 设置为对应类型。例如腾讯企业邮箱使用 exmail。

使用后文的手动 SMTP 参数时，不需要设置 EMAIL_TYPE。

添加邮件 MCP

打开能力配置中的 MCP 管理页面，点击“添加连接”。
选择“导入 JSON”。
填写下面的配置并执行连接测试。
测试通过后保存并启用该连接。

{
  "mcpServers": {
    "email": {
      "command": "universal-email-mcp",
      "env": {
        "EMAIL_USER": "${EMAIL_USER}",
        "EMAIL_PASSWORD": "${EMAIL_PASSWORD}",
        "EMAIL_TYPE": "${EMAIL_TYPE}"
      }
    }
  }
}

页面连接测试只确认 MCP 进程可以启动并返回工具列表，不会登录 SMTP。保存后，可以在任务中调用 test_email_connection 测试 SMTP 登录；该测试只校验连接，不会发送邮件：

请使用邮件 MCP 测试 SMTP 连接，只测试发送服务器。

常用邮箱类型

邮箱服务	`EMAIL_TYPE`	说明
QQ 邮箱	`auto`	开启 SMTP 服务并使用邮箱授权码
163/126 邮箱	`auto`	开启 SMTP 服务并使用客户端授权密码
Outlook	`auto`	根据账号安全策略使用应用专用密码
腾讯企业邮箱	`exmail`	自定义企业域名需要明确指定邮箱类型
阿里云邮箱	`aliyun`	自定义域名无法自动识别时需要明确指定该类型

如果邮箱不在自动识别范围内，可以在 MCP 配置中手动提供 SMTP 参数：

{
  "mcpServers": {
    "email": {
      "command": "universal-email-mcp",
      "env": {
        "EMAIL_USER": "${EMAIL_USER}",
        "EMAIL_PASSWORD": "${EMAIL_PASSWORD}",
        "EMAIL_SMTP_HOST": "smtp.example.com",
        "EMAIL_SMTP_PORT": "465",
        "EMAIL_SMTP_SECURE": "true"
      }
    }
  }
}

端口和加密方式必须与邮箱服务商提供的 SMTP 配置一致。

发送邮件

连接启用后，在新任务入口、会话能力栏或场景专家中选择该邮件 MCP。发送前建议让 Agent 展示收件人、主题和正文，确认无误后再调用工具：

请先生成一封项目周报邮件，收件人为 manager@example.com，主题为“本周项目进展”。
先向我展示完整邮件内容，得到确认后再通过邮件 MCP 发送。

邮件 MCP 支持多个收件人、抄送、密送、HTML 正文和附件。附件路径必须是 Executor 容器内可访问的工作区路径，不能使用本地电脑上的文件路径。

安全建议

不要在 MCP JSON、任务消息或 Agent 默认指令中写入明文授权码。
为 EMAIL_PASSWORD 开启敏感变量标记，并限制环境变量的可见范围。
使用专门的发件账号，并按业务需要限制账号权限和收件范围。
发送外部邮件前检查收件人、抄送人、附件和敏感信息。
授权码泄露后立即在邮箱后台撤销并重新生成。

更多邮箱类型、工具参数和故障排查说明，请查看 mcp-email 上游文档。