怎么把 WorkBuddy 接入我的邮箱?SJ-Mail MCP 智能体接入配置指南

SJ-Mail v0.9.0+ 内置 stdio MCP 进程,WorkBuddy 连接器三步完成接入;AI 只能拟稿,发送永远由你确认。

现象

想让 WorkBuddy 直接读写 SJ-Mail 里的邮件(查文件夹、读邮件、检索联系人、起草回复),但不清楚如何配置 MCP 连接器,或者担心 AI 会绕过自己直接发信。

原因

SJ-Mail 从 v0.9.0 起内置独立的 sj-mail-mcp 进程,通过 stdio 暴露标准 MCP 协议(工具列表、邮件读写、搜索等),与主程序共享同一份本地加密数据。WorkBuddy 侧以「自定义连接器」承载 MCP——在连接器管理页按引导粘贴配置即可,无需改配置文件。

解决步骤

  1. 安装含 MCP 的 SJ-Mail 版本(v0.9.0+,安装目录主程序旁自带 sj-mail-mcp.exe)。
  2. 打开 SJ-Mail → 设置 → 常规 → MCP 访问级别 → 选择「对外开放」(一次设置持久生效)。
  3. 打开 WorkBuddy → 左侧导航「连接器」→ 右上角「自定义连接器」→ 按引导配置 MCP 连接器,命令指向安装目录下的 sj-mail-mcp.exe(如 C:\Users\<用户名>\AppData\Local\Programs\SJ-Mail\sj-mail-mcp.exe)。
  4. 完成连接器授权后,即可在 WorkBuddy 对话中使用 SJ-Mail 的邮件工具(列表/搜索/读正文/读附件/起草等)。对接效果如下:
WorkBuddy 通过 MCP 智能体接入 SJ-Mail 邮箱:查询文件夹、检索邮件、起草回复的实际对接界面
✓ 适用版本:v0.9.0 及以上。无需保持 SJ-Mail 主程序运行——读操作直读共享本地数据;需要主程序在场的写操作会自动拉起应用(冷启动至多 30 秒)。

发送安全:AI 只能拟稿,不能替你发信

常见问题

Q:SJ-Mail 的 MCP 接入需要保持 SJ-Mail 主程序一直运行吗?

A:不需要。sj-mail-mcp 独立常驻,读操作(搜索、读信、列表)直接读取共享本地数据;仅写操作(打开写信窗人工确认发送)会在调用时自动拉起 SJ-Mail,冷启动至多等待 30 秒。

Q:接入后 AI 能替我自动发送邮件吗?

A:不能,这是硬性安全规则。外部工具列表中不存在静默发送工具;AI 起草的邮件一律打开写信窗,由用户在窗口内点击发送完成投递。草稿的编辑(正文、收件人等)AI 可以正常进行。

Q:开启 MCP 对外开放有什么安全边界?

A:「对外开放」档位下,任何能启动 sj-mail-mcp 的本机进程都可读写邮件数据(读本地库 + 自建 IMAP/CAPI 连接)。请仅在可信环境开启;权限三档为 off / internal(默认)/ external。

Q:MCP 模式下能读取未缓存的历史邮件正文吗?

A:可以。标准链路为:list_emails 定位邮件 → read_email_body 提示未缓存时调用 fetch_email_body 单封拉取完整正文并缓存 → 重试读取。附件列表 list_attachments 使用返回的邮件 id。

相关