在 AI 编程助手（Claude…

当需要让 AI Agent 通过 MCP 协议调用 Resend 发送事务性/营销邮件时，按此流程搭建本地 MCP 服务器并配置各客户端。

适用场景

解决思路

1. 环境准备：安装 Node.js 20 或更高版本（MCP 服务器要求 engines node>=20）、注册 Resend 账号（有免费额度）、准备 GitHub Copilot Pro 或启用 Agent 模式的 Cursor、安装 VS Code Insider（完整 MCP 支持）、准备 npm 或 pnpm。
2. 克隆并构建 Resend MCP 服务器：执行 `git clone https://github.com/resend/mcp-send-email.git`，`cd mcp-send-email`，`npm install`（或 `pnpm install`），`npm run build`。构建过程会编译 TypeScript、在 Unix/macOS 上设置可执行权限，并生成 `build/index.js` 可执行文件。
3. 创建 Resend API Key：访问 https://resend.com/api-keys 新建密钥并复制（配置时使用）。
4. （可选）验证自有域名：访问 https://resend.com/domains 添加并验证域名，然后在 MCP 配置中用 `--sender` 参数指定发件人。
5. 配置 GitHub Copilot Coding Agent（仓库级，推荐团队协作）：在 GitHub 仓库 Settings → Copilot → Coding agent 添加 JSON 配置，mcpServers.resend 使用 type=local、command=node、args 指向 build/index.js 绝对路径、env 中 RESEND_API_KEY 填 `COPILOT_MCP_RESEND_API_KEY`、tools 填 `["*"]`；再到 Settings → Environments 新建名为 `copilot` 的环境，添加 secret `COPILOT_MCP_RESEND_API_KEY` 为真实密钥值，保存后 Copilot 会校验配置。
6. 配置 VS Code 本地开发：在项目根目录创建 `.vscode/mcp.json`，servers.resend 使用 type=command、command=node、args 指向 build/index.js 绝对路径、env 中直接填 RESEND_API_KEY 值；绝对路径可在 VS Code 中右键 build/index.js → Copy Path 获取。
7. 配置 Cursor Agent 模式：打开 Cursor Settings（Cmd+Shift+P → "Cursor Settings"），在 MCP 配置中添加 mcpServers.resend，type=command，command 为 `node /absolute/path/to/mcp-send-email/build/index.js --key=re_xxxxxxxxxxxxxx`。
8. 配置 Claude Desktop：打开设置 → Developer 标签 → Edit Config，添加 mcpServers.resend，command=node，args 指向 build/index.js，env 中设置 RESEND_API_KEY、SENDER_EMAIL_ADDRESS（如 onboarding@resend.dev）、REPLY_TO_EMAIL_ADDRESS。
9. 用 email.md 模式测试连接：在项目中创建 email.md，写入 `to:`、`subject:`、`content:` 字段（可加 cc/bcc 注释）；在 Cursor 中全选后按 Cmd+L 并说 "send this as an email"（需处于 Agent 模式）；在 Claude Desktop 中粘贴内容并说 "Send this email using the resend tool"；在 GitHub Copilot 中用 `@email.md send this email using resend` 引用。配置正确会立即发送并返回确认。
10. 理解 MCP 配置类型：GitHub Copilot Coding Agent 为仓库级配置（需仓库管理员、需显式 tools 数组、密钥存为 GitHub Actions secret 且前缀 COPILOT_MCP_、无需审批自主执行）；VS Code 本地开发为 `.vscode/mcp.json` 配置（密钥直接写在配置或环境变量中，适合个人开发与测试）。
11. 了解 Resend MCP 服务器能力：通过自然语言发送纯文本或 HTML 邮件、定时发送、添加收件人（To/CC/BCC）、配置发件人信息（From/Reply-To）、向受众群发（Broadcast）、管理受众列表；近期新增广播与受众管理工具，并用 Zod schema 做校验和错误处理。
12. 了解三种运行方式：command 类型（VS Code/Cursor，直接 Node.js 执行带内联参数）、stdio 类型（Claude Desktop，通过环境变量处理 I/O）、HTTP 类型（远程/云端，通过 HTTP 端点暴露）。
13. GitHub Copilot Coding Agent 的 tools 数组必须显式指定：用 `"tools": ["send_email", "schedule_email"]` 白名单化具体工具，或用 `"tools": ["*"]` 启用全部；配置后 Copilot 会自主使用这些工具而不再询问，因此只启用需要的工具。
14. 认证配置：RESEND_API_KEY 必填（来自 https://resend.com/api-keys）；SENDER_EMAIL_ADDRESS 可选（已验证域名邮箱，不设置则每次发信时 AI 会询问）；REPLY_TO_EMAIL_ADDRESS 可选（回复地址）。
15. 域名验证策略：默认可用测试域名 `onboarding@resend.dev` 向自己账号邮箱发信；向其他地址发信需在 https://resend.com/domains 验证自有域名，创建发件邮箱并配置到 SENDER_EMAIL_ADDRESS。
16. 安全最佳实践：只启用 Copilot 需要的工具而非 `"*"`；绝不把 API Key 提交到版本控制，用 GitHub Actions secret（名称以 COPILOT_MCP_ 开头）存储；尽量使用受限的 Resend API Key；审查 Copilot 创建的 PR 确认邮件发送合理；用 `copilot` 环境隔离可访问发信能力的仓库/工作流。
17. 配置管理实践：开发用 `.env.local`（不提交）存 RESEND_API_KEY 与 SENDER_EMAIL_ADDRESS；按环境分离配置（开发用测试 Key 和受限收件人，生产用完整 Key）；在 README.md 中记录所需环境变量。
18. 邮件内容实践：营销邮件必须包含退订链接；在 Gmail/Outlook/Apple Mail 等多客户端测试；模板保持移动端响应式；主题行清晰描述用途；为 HTML 提供纯文本替代以保障可访问性。
19. AI Agent 使用实践：提供收件人上下文；初始配置时指定发件人信息；发送前审查 AI 生成的邮件内容；复杂多步流程用 Agent 模式；先发给自己测试再发给他人。
20. 排障 Node 版本：若报 "Node version too old" 或 "Node 20+ required"，用 `node --version` 检查需 v20.0.0+；从 https://nodejs.org 安装 LTS，macOS 可 `brew install node@20`，Linux 可 `nvm install 20`，安装后重启终端/IDE。
21. 排障 node 命令缺失：若报 "Command not found: node"，说明未安装或不在 PATH，从 https://nodejs.org 安装 20+ 后验证并重启终端/IDE。
22. 排障 API Key：若报 "RESEND_API_KEY is required"，到 https://resend.com/api-keys 重新生成（以 re_ 开头），检查配置中环境变量名正确、无多余空格。
23. 排障投递失败/401：核对 API Key 有效、域名已在 https://resend.com/domains 验证、发件邮箱匹配已验证域名，并检查 Resend 面板是否有速率限制或投递错误。
24. 排障构建失败：执行 `rm -rf node_modules package-lock.json && npm install && npm run build`；TypeScript 编译错误检查依赖是否装全；Unix/macOS 权限拒绝可换目录运行（构建脚本含 chmod +x）；Module not found 则删 node_modules 重装。
25. 排障 MCP 服务器未出现在 IDE 工具列表：Copilot 检查 `.vscode/mcp.json` 在项目根目录、build/index.js 绝对路径正确、重载 VS Code 窗口、确认 Agent 模式开启；Cursor 在 Cursor Settings 的 MCP 标签检查 JSON 语法、路径可读并重启 Cursor；Claude Desktop 完全关闭后检查 claude_desktop_config.json 语法与文件存在，重开后在 Developer 标签查看 resend 工具。
26. 排障 AI 不主动调用 Resend MCP：切换到 Claude Sonnet 4 或 GPT-4.1（工具理解更好）、显式开启 Agent 模式、用明确指令如 "use the resend MCP tool to send..."、检查 MCP 服务器控制台输出确认在运行。
27. 排障 invalid sender：到 https://resend.com/domains 验证自定义域名，测试时用默认 onboarding@resend.dev，更新 SENDER_EMAIL_ADDRESS 后重启 MCP 服务器。
28. 高级配置——HTTP 传输：团队共享或云端场景可在配置中用 type=http 与 url 指向自建 MCP 服务器端点，由该服务器转发请求到 Resend API。
29. 高级配置——按环境切换：准备 `.mcp.dev.json` 与 `.mcp.prod.json`，用 `cp .mcp.dev.json .vscode/mcp.json` 或 `cp .mcp.prod.json .vscode/mcp.json` 切换。
30. 高级配置——同时接入 Claude Desktop 与 GitHub Copilot：两者可共用同一个本地 MCP 服务器实例，分别在 claude_desktop_config.json 和 `.vscode/mcp.json` 中配置相同路径与密钥。
31. 工作流示例——事务性邮件：部署带生产 Key 的 MCP 服务器 → 在 Claude Desktop 或 Copilot 中配置 → 在应用逻辑中通过 AI Agent 集成（如 "订单确认时用 Resend MCP 发送含订单详情的确认邮件"）→ 在 Resend 面板监控投递状态。
32. 工作流示例——营销活动：准备模板与收件人列表 → 用 AI Agent 生成个性化内容 → 发送前审查 → 通过 Resend MCP 分批发送 → 监控打开率与互动。
33. 工作流示例——通知：为通知服务配置 Resend MCP → 为不同通知类型创建模板 → 用 AI Agent 格式化为邮件 → 通过 Resend MCP 发给订阅者 → 跟踪投递并处理退信。

适用边界 · 注意事项

• 不依赖 AI 编程助手或 MCP 协议、只想用普通后端代码直接调用 Resend REST API 的场景。
• 无法安装 Node.js 20+ 或无法使用 VS Code Insider / Copilot Pro / Cursor Agent 模式的环境。
• 对邮件发送有严格合规审计要求、不允许 AI Agent 自主无审批发信的场景（Copilot Coding Agent 配置后无需审批即会自主发信）。