> 关键词：WorkBuddy · MCP · 自定义连接器 · 邮件自动化 · 个人 IP
>
> 用 20 分钟，把 WorkBuddy 从"办公/代码工具"升级成一台**有通讯能力的 AI 助理**：电脑端、手机端双端同步，随时随地用自然语言处理你自己的私人域名邮件事务——收发、总结、定时发送、邮件日报，都能一句话搞定。

---

## 引言：AI 为什么不能帮我管邮箱？

我每天都在跟邮件打交道，但一直有几个绕不过去的痛点：

1. **官方连接器绑定了平台邮箱**。WorkBuddy 内置的邮件连接器（如 QQ 邮箱）能收发，但发件身份是平台给的，没法用我自己注册的**个人域名邮箱**（`you@your-domain.com` 这种）。
2. **多设备不同步**。电脑上配好的 MCP 服务，手机端用不了；本地进程一关，服务就断了。
3. **AI 的能力被"预置"框住了**。官方给什么连接器，我就只能用什么。可我想要的是：接入我自己的域名、我自己的品牌、我自己的介绍页——把每封外发邮件都变成一次**个人 IP 的触点**。

于是我自己写了一个 MCP Server：**ai-mail-mcp**。它跑在云端，把我的私人域名邮箱能力暴露给 WorkBuddy，桌面端、移动端共用同一个端点。

这篇文章就是把整个方案完整拆开：为什么这么做、怎么部署、怎么玩出花样，以及最重要的——**所有敏感配置如何用环境变量隔离，做一个可以开源的通用模板**。

## 一、方案总览：ai-mail-mcp 是什么

一句话：**一个自建的、跑在云端的 MCP Server**，通过 SMTP/IMAP 协议对接你的私人域名邮箱，把 `发信 / 收信 / 读信 / 测连接` 四个能力暴露给任何 MCP 客户端。

它提供 4 个工具：

| 工具 | 作用 |
|---|---|
| `send_email` | 发送邮件，**自动追加个人签名 + 介绍页链接** |
| `get_recent_emails` | 获取最近 N 天邮件列表（主题 / 发件人 / 时间） |
| `get_email_content` | 按 UID 读取邮件完整正文与附件信息 |
| `test_email_connection` | 一键测试 SMTP / IMAP 连接 |

整体架构如下：

![ai-mail-mcp 双端同步架构](https://developer.qcloudimg.com/http-save/yehe-9551184/385c250bf033d317b93e2673637bf5ac.svg)

*（若阅读端不支持 SVG，可用浏览器打开 architecture.svg 后截图上传）*

架构里有三个关键设计：

- **云端部署是双端同步的前提**：一个 HTTPS 端点，桌面端和移动端都能连，电脑不开机、手机照样收发。
- **Bearer Token 鉴权**：端点不是裸奔的，调用方必须携带你自定义的令牌。
- **凭据全走环境变量**：源码里没有任何真实账号密码，任何人都能安全地二次部署。

## 二、第一步：准备你的个人域名邮箱

这一步和 WorkBuddy 无关，但它是整件事的根基。

1. 注册一个域名（比如 `your-domain.com`），买企业邮箱服务（阿里云邮、腾讯企业邮、Zoho 等任选，一般几十到几百元一年）。
2. 在邮箱管理后台创建账号，例如 `you@your-domain.com`。
3. 记下四个参数：
   - **SMTP**：发信服务器地址、端口（通常 465 或 587）、账号、授权码
   - **IMAP**：收信服务器地址、端口（通常 993）、账号、授权码

> 提醒：很多邮箱服务要用"授权码"而不是登录密码做第三方接入，记得在后台开启 IMAP/SMTP 服务并生成授权码。

为什么值得多这一步？因为收件人看到的发件人是 `you@your-domain.com`，而不是一串数字开头的平台号。**邮箱就是你的数字名片**——这是后面"个人 IP"那一节的地基。

## 三、第二步：部署 ai-mail-mcp 到云端（全环境变量）

### 3.1 源码结构

开源版基于 `@modelcontextprotocol/sdk` 实现，核心是一个 `server.js`（约 400 行），支持两种传输模式：

- **stdio**：本地进程，适合调试；
- **sse**：云端远程部署，WorkBuddy 双端接入走这个。

### 3.2 所有凭据走环境变量

这是通用模板最关键的部分。源码里**没有任何硬编码的账号密码**，全部从环境变量读取：

```bash
# .env.example（节选）
# ---- 必填 ----
EMAIL_USER=you@your-domain.com                  # 邮箱账号
EMAIL_PASSWORD=your-smtp-authorization-code     # SMTP/IMAP 授权码

# ---- 可选：发件身份与签名 ----
ASSISTANT_NAME=AI 助手
SIGNATURE_URL=https://your-domain.com/about     # 个人介绍页，签名自动带上

# ---- 可选：服务模式 ----
MCP_TRANSPORT=sse
PORT=3100
MCP_BEARER_TOKEN=change-me-to-a-long-random-string  # 端点鉴权令牌
```

部署时只需三步：

```bash
cp .env.example .env     # 填入你的真实配置
npm install
docker compose up -d     # 云端部署
```

### 3.3 Docker + nginx + HTTPS

`docker-compose.yml` 做了两件重要的事：

1. **端口只绑定 `127.0.0.1`**，不直接暴露公网；
2. 容器 `restart=always`，服务器重启自动拉起。

对外访问靠 nginx 反向代理 + HTTPS（证书用 acme.sh / certbot 自动签发续期）。nginx 关键配置有三点必须注意：

```nginx
location /mail-mcp/ {
    proxy_pass http://127.0.0.1:3100/;
    proxy_buffering off;      # SSE 必须关闭缓冲
    proxy_read_timeout 3600s; # 长连接
    proxy_set_header Connection "";
}
```

部署完成后，你得到一个形如 `https://mcp.your-domain.com/mail-mcp/sse` 的端点。可以用 `curl` 快速验证：

```bash
curl -N -H "Authorization: Bearer 你的Token" https://mcp.your-domain.com/mail-mcp/sse
# 期望输出：event: endpoint / data: /message?sessionId=xxx
```

> 源码已完全开源（MIT），地址见文末。里面附带 `.env.example`、`docker-compose.yml`、`README.md`，克隆后填上自己的 `.env` 即可跑起来。

## 四、第三步：在 WorkBuddy 接入（双端配置）

### 4.1 桌面端

编辑用户级配置文件 `~/.workbuddy/mcp.json`：

```json
{
  "mcpServers": {
    "ai-mail-mcp": {
      "type": "sse",
      "url": "https://mcp.your-domain.com/mail-mcp/sse",
      "headers": {
        "Authorization": "Bearer 你的随机Token"
      }
    }
  }
}
```

然后打开 WorkBuddy → 连接器管理 → 找到「ai-mail-mcp」→ 点击 **Trust / 启用**，重启会话，工具就加载好了。

### 4.2 移动端

移动端登录**同一个 WorkBuddy 账号**，按同样方式配置同一个端点即可——这正是云端部署的红利：**手机端不需要任何本地进程**，只要能联网就能调用。至此双端同步完成。

### 4.3 验证

对话里说一句："给 xx@example.com 发一封测试邮件，主题是 hello"。几秒后对方就能收到一封带统一签名的邮件，说明全链路打通。

## 五、第四步：实战玩法——自然语言驱动，想象力即边界

接入之后，下面的玩法都可以直接说出来，不用写代码：

### 玩法 1：收发邮件

> "看看我最近 3 天的邮件，哪些需要回复？"

AI 会调用 `get_recent_emails` 拉列表，再按需用 `get_email_content` 读正文，给你一份分类清单。

### 玩法 2：邮件总结

> "把今天收到的 5 封邮件总结成一段话，标出哪封最紧急。"

### 玩法 3：定时发送邮件（WorkBuddy 自动化）

WorkBuddy 自带「自动化」能力，可以按时间周期自动执行任务。在侧边栏进入「自动化」→ 新建，配置：

| 配置项 | 示例值 |
|---|---|
| 名称 | 每周周报 |
| 频率 | 每周一 09:00 |
| 任务内容 | 用 ai-mail-mcp 的 `send_email` 给 team@your-domain.com 发送邮件，主题《本周工作周报》，正文按「本周进展 / 下周计划 / 需要协调」三部分组织 |

到点后，AI 自动生成并发送，全程无需人工介入。

### 玩法 4：每日邮件总结日报（定时 + 读信 + 发信的组合拳）

这是我最常用的一个自动化，把"收信 → 总结 → 发信"串成闭环：

| 配置项 | 示例值 |
|---|---|
| 名称 | 每日邮件简报 |
| 频率 | 每天 09:00 |
| 任务内容 | 用 `get_recent_emails` 获取最近 24 小时邮件（limit 20, days 1），用 `get_email_content` 读取需关注邮件的正文，整理成简报：① 待回复（发件人 / 主题 / 建议要点）② 通知类（一句话概括）③ 紧急重要（标红提醒）；最后用 `send_email` 把简报发送到 my@your-domain.com，主题《每日邮件简报 日期》 |

从此每天早上打开邮箱，看到的是一份已经替你整理好的"今天该干什么"，而不是 30 封待读的邮件。

### 玩法 5：更多脑洞

- **智能回复草稿**：读邮件 → 让 AI 起草回复 → 你确认后发送；
- **按规则归档**："把含发票的邮件单独列出来"；
- **紧急提醒**："如果收到某关键词的邮件，立刻总结并提醒我"；
- **个人 IP 触达**："每周给订阅者发一封精选内容邮件"。

WorkBuddy 本身具备自然语言理解 + 定时自动化能力，ai-mail-mcp 只是把"邮箱"这条通道接了进来——**具体能玩出什么花样，取决于你的想象力**。

## 六、进阶：让它成为你的"通讯 AI"与个人 IP 入口

聊到这里，你应该已经感受到：这不再是一个"邮件工具"，而是一台**有通讯能力的 AI**。

- **统一签名 = 品牌触点**：每次外发邮件自动带上"此邮件由 you@your-domain.com 通过 XX 自动发送"和介绍页链接。收件人点开链接，看到的是你的个人主页。一封邮件，一次曝光。
- **主动触达 = 关系经营**：早安简报、每周复盘、节日关怀，AI 到点自动发。你不只是被动收件，而是主动经营关系。
- **自定义域名 = 数字名片**：发件人是 `you@your-domain.com`，天然带有专业感和辨识度，这是平台邮箱给不了的。

自定义连接器的本质，就是**脱离官方预置能力的边界，接入你自己的域名、品牌和服务**。你不只是 WorkBuddy 的用户——你在用它搭建自己的"通讯基础设施"。

## 七、安全与隐私

| 风险点 | 应对 |
|---|---|
| 端点被陌生人调用 | `MCP_BEARER_TOKEN` 设为足够随机的长字符串（`openssl rand -hex 32`），妥善保管 |
| 凭据泄露进仓库 | `.env` 加入 `.gitignore`；仓库只提交 `.env.example` |
| 邮箱账号被滥用 | 使用独立账号 + 最小权限（仅收发，不开删除/管理权限） |
| 数据被第三方收集 | 自托管：邮件数据全程在自己的服务器，不上交任何第三方 |

## 八、总结：从"用工具"到"造设施"

回看整件事：

- **双端同步**：云端部署一个端点，桌面端、移动端随时可用；
- **自然语言**：收发、总结、定时、日报，全是一句话的事；
- **定时自动化**：WorkBuddy 自动化 + ai-mail-mcp，形成"收信 → 总结 → 发信"的闭环；
- **个人 IP**：自定义域名邮箱 + 统一签名 + 介绍页，把每封邮件变成品牌触点。

ai-mail-mcp 不只是一个 MCP，它是把 WorkBuddy 变成"通讯 AI"的那块拼图。而它背后真正想说的是：**连接器的边界，就是你可以自定义的边界**。去接入你自己的服务，拓展你自己的 IP——WorkBuddy 给了你能力，剩下的交给想象力。

---

### 附录

- **开源仓库**：https://github.com/dongjunke/ai-mail-mcp
- 仓库内容：`server.js`（stdio / SSE 双模式）、`package.json`、`.env.example`、`docker-compose.yml`、`architecture.svg`、`README.md`
- 技术栈：Node.js ≥ 18 · `@modelcontextprotocol/sdk` · `nodemailer` · `imap` · `mailparser`
- 排查速查：
  - 连接失败：先跑 `test_email_connection`，确认 SMTP/IMAP 参数和授权码；
  - 工具没被调用：检查 WorkBuddy 连接器是否已 Trust 并重启会话；
  - 收到 401：确认 `MCP_BEARER_TOKEN` 与 `mcp.json` 中的 Bearer 一致。


关键词：WorkBuddy · MCP · 自定义连接器 · 邮件自动化 · 个人 IP

脱离官方连接器：自建 ai-mail-mcp，给 WorkBuddy 装上"社交能力"

自建 ai-mail-mcp，把 WorkBuddy 变成一台有通讯能力的 AI：双端同步、自然语言收发邮件、定时自动化，源码全开源。

人工智能

开发工具

后端

用20分钟把WorkBuddy升级为自带通讯能力的AI助理：自建ai-mail-mcp云端服务，通过SMTP/IMAP接入私人域名邮箱，实现收发、总结、定时发送与日报自动化。桌面端与手机端共用同一HTTPS端点，BearerToken鉴权，全凭据环境变量隔离。一句话指令驱动邮件事务，每封外发邮件自动附加个人签名与介绍页，将邮箱转化为个人IP触点。

自然语言处理

腾讯企业邮

代码解释

服务器

WorkBuddy 

容器

Docker

JSON

2026上云采购 | AI焕新·智启新局

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

用20分钟把WorkBuddy升级为自带通讯能力的AI助理：自建ai-mail-mcp云端服务，通过SMTP/IMAP接入私人域名邮箱，实现收发、总结、定时发送与日报自动化。桌面端与手机端共用同一HTTPS端点，BearerToken鉴权，全凭据环境变量隔离。一句话指令驱动邮件事务，每封外发邮件自动附加个人签名与介绍页...

脱离官方连接器：自建 ai-mail-mcp，给 WorkBuddy 装上"社交能力"-腾讯云开发者社区-腾讯云

脱离官方连接器：自建 ai-mail-mcp，给 WorkBuddy 装上"社交能力"

脱离官方连接器：自建 ai-mail-mcp，给 WorkBuddy 装上"社交能力"

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐