SuperAPI AI 工具集

resend-integration-skills

办公与效率

查看项目

更新于 10-15 15:43

技能介绍

该技能用于把 Resend 邮件服务通过 MCP(Model Context Protocol)协议接入 AI 智能体,使 AI 客户端能够以自然语言指令发送邮件。适用客户端包括 Claude Desktop、GitHub Copilot 与 Cursor。

主要能力 Resend MCP 服务器是一个本地 Node.js 应用,把 Resend 的邮件功能暴露为可供大语言模型调用的工具。据资料,智能体可以:通过自然语言命令发送纯文本或 HTML 邮件;将邮件定时到未来发送;添加收件人(To、CC、BCC);配置发件人信息(From、Reply-To);向受众群组广播邮件;管理受众,列出 Resend 受众以便定向发送;支持 HTML 与纯文本邮件正文。资料提到较新的补充功能包括面向营销活动的广播与受众管理工具,以及通过 Zod schemas 改善错误处理与校验。

使用方式 环境要求:Node.js 20 或更高版本(MCP 服务器指定 engines: { "node": ">=20" })、Resend 账号(提供免费套餐)、GitHub Copilot Pro 或启用了 Agent 模式的 Cursor、VS Code Insider(完整 MCP 支持所需)、npm 或 pnpm。

构建步骤:克隆 https://github.com/resend/mcp-send-email.git,进入目录后执行 npm install(或 pnpm install),再执行 npm run build。构建过程会将 TypeScript 编译为 JavaScript、在 Unix/macOS 上设置可执行权限,并在 build/index.js 生成 MCP 服务器可执行文件。

创建 API 密钥:访问 https://resend.com/api-keys 新建密钥并复制。域名验证为可选项,自定义域名需在 https://resend.com/domains 添加并验证。

客户端配置:GitHub Copilot Coding Agent 采用仓库级设置,在仓库 Settings → Copilot → Coding agent 填入 mcpServers JSON,需指定 tools 数组,并将 API 密钥以 COPILOT_MCP_ 前缀存为 GitHub Actions secret(如 COPILOT_MCP_RESEND_API_KEY),同时在 Settings → Environments 创建名为 copilot 的环境并添加该 secret。VS Code 本地开发在项目根创建 .vscode/mcp.json。Cursor 在 Cursor Settings 的 MCP 配置中填写。Claude Desktop 在设置 Developer 标签 → Edit Config 中配置。配置方式有 command 类型(VS Code/Cursor)、stdio 类型(Claude Desktop)、HTTP 类型(远程/云端)三种。

鉴权变量:RESEND_API_KEY(必需);SENDER_EMAIL_ADDRESS(可选,已验证域名的邮箱,未设置时 AI 会每次询问);REPLY_TO_EMAIL_ADDRESS(可选)。默认可用测试域名 onboarding@resend.dev 向自己账号邮箱发送;向其他地址发送需验证域名。

测试与示例:官方仓库提供 email.md 测试模式,文件含 to、subject、content 及可选的 cc、bcc 字段。资料给出多个示例:通过 Copilot Chat 发送简单邮件、发送带 HTML 表格的邮件、带 CC/BCC 的邮件、定时邮件,以及结合 CSV 数据处理批量发送个性化邮件;另有广播邮件与列出受众的调用示例。

适用场景 包括事务性邮件(如订单确认通知)、营销活动邮件(准备模板与收件人列表、AI 生成个性化内容、批量发送并监控)、通知类邮件,以及与数据处理流程结合的批量个性化邮件发送。

限制与注意事项 需 Node.js 20 及以上,需 VS Code Insider 才能获得完整 MCP 支持。GitHub Copilot Coding Agent 配置需仓库管理员权限,使用 tools 数组做工具白名单("*" 表示启用全部),配置后 Copilot 可自主执行而无需批准,存在安全考量;API 密钥不应提交到版本控制,应存为 GitHub Actions secret。邮件内容方面建议营销邮件包含退订链接、测试多客户端、使用移动端响应式模板、提供纯文本替代版本,并在发送前审查 AI 生成内容。资料还列出常见故障排查(Node 版本过低、未安装 node、缺少 RESEND_API_KEY、邮件未送达或 401、构建失败、MCP 服务器未出现在工具列表、AI 不主动使用 Resend MCP、无效发件人等)及对应解决办法。资料未提供该技能的具体收费或价格信息。