联通企业邮箱 MCP 自动配置

解决什么问题

在 WorkBuddy 中接入联通企业邮箱并不是单纯填一个服务器地址。普通员工通常会卡在几个地方：不知道 IMAP 服务器和端口，分不清网页登录密码和客户端授权码；配置过程需要改多个本地文件，还要合并已有 MCP 配置，容易覆盖；写完脚本后也不知道是密码错了、网络不通，还是根本没在 WorkBuddy 里信任这个 MCP server。这个技能把对话变成配置入口，让 AI 在聊天窗口里逐步收集参数、生成文件、验证连接，并给出重启和信任指引。

核心能力与关键步骤

技能触发后，AI 先确认目标邮箱，询问邮箱地址、IMAP 服务器和端口，以及是否需要发邮件。默认使用 xcp.mail.chinaunicom.cn:993，但会保留用户填入的实际值。如果用户不知道参数，可以参考联通标准协议表：IMAP xcp.mail.chinaunicom.cn:993/SSL，POP3 xcp.mail.chinaunicom.cn:995/SSL，SMTP xcs.mail.chinaunicom.cn:465/SSL。注意，这个 skill 只负责读取邮件，发邮件需要额外 SMTP 配置。

接下来，AI 会明确告诉用户密码或授权码只写入本地 C:\\Users\\<user>\\.workbuddy\\mcp.json，不写入聊天记录或记忆文件。企业邮箱通常需要客户端授权码，而不是网页登录密码。用户可以选择一次性提供密码让 AI 完成配置和测试，也可以只给邮箱地址，后续自己手动填入 YOUR_PASSWORD_OR_AUTH_CODE 占位符。

然后是自动化部分：

• AI 用 PowerShell 安装依赖，并按实际 Node 版本执行。
• 生成 MCP server 脚本到 C:\\Users\\<user>\\.workbuddy\\mcp-servers\\custom_email\\imap_mcp_server.js。
• 把 server 配置合并进 C:\\Users\\<user>\\.workbuddy\\mcp.json 的 mcpServers 节点，而不是覆盖已有内容。
• 做语法检查，并通过 System.Diagnostics.Process 启动 server，发送 initialize 和 tools/list 请求，确认返回 3 个工具。
• 如果用户提供了密码，会真实读取最近 1 封邮件做连接验证。

最后，AI 会提醒用户重启 WorkBuddy，到侧边栏 → 插件 → MCP 服务器里找到 custom-email，点击启用或信任，状态变绿后再用“读取我最近 5 封邮件”做验证。

适用边界与注意点

这个技能面向 WorkBuddy 的 IMAP 读取场景，不是通用邮件客户端，也不负责发信。密码只应出现在本机 mcp.json 中，不应写进脚本、聊天记录或记忆文件；如果选择不直接给密码，最终配置里会保留占位符，需要用户自己替换。配置文件名必须是 mcp.json，不能写成 .mcp.json。

常见失败包括状态显示 disconnected，通常是授权码错误、IMAP 未开启或网络不通；找不到 server 多是配置未合并、文件名不对或未重启；提示 untrusted 说明还需要在 WorkBuddy 里点击信任；如果只能收到外部邮件警告，正文内容可能在附件中。