关于 Groundmail
Groundmail 的 MCP 服务让团队可通过 MCP 客户端管理事务邮件。它涵盖邮件发送与投递检查,以及域名、模板、Webhook、抑制名单和投递能力监控,并提供托管 OAuth 或本地 API 密钥接入方式。
主要功能
- 01发送、列出和查看邮件
- 02管理发件域名与 DNS
- 03管理模板和 Webhook
- 04处理抑制名单与地址验证
- 05监控投递能力和 DMARC
- 06导入服务商并管理租户
适用场景
- 01发送密码重置邮件和事务通知
- 02查看邮件投递状态与退信
- 03设置并验证发件域名
- 04监控邮件业务的投递能力
MCP 相关
MCP 服务向 MCP 客户端提供邮件发送和管理工具。可通过使用 OAuth 的托管 HTTP 服务接入,也可使用 API 密钥运行 stdio 或本地 HTTP 模式。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.groundmail.dev/mcpclaude mcp add --transport http groundmail-groundmail https://mcp.groundmail.dev/mcp{"mcpServers":{"groundmail-groundmail":{"type":"http","url":"https://mcp.groundmail.dev/mcp"}}}在 Cursor 中打开{"servers":{"groundmail-groundmail":{"type":"http","url":"https://mcp.groundmail.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"groundmail-groundmail":{"type":"http","url":"https://mcp.groundmail.dev/mcp"}}}{"mcpServers":{"groundmail-groundmail":{"serverUrl":"https://mcp.groundmail.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Groundmail MCP 服务
从 Claude、Claude Code、ChatGPT、Cursor 及任何其他 MCP 客户端发送事务性电子邮件,并管理域名、模板、Webhook 和抑制名单。
文档 · 免费注册 · groundmail.dev
快速开始
最快的方式是使用托管服务。添加 URL,通过浏览器登录即可完成。无需复制 API 密钥。
https://mcp.groundmail.dev/mcp
| 客户端 | 连接方式 |
|---|---|
| Claude Code | claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp,然后运行 /mcp,选择 groundmail 并选择 Authenticate |
| Cursor | 将 { "mcpServers": { "groundmail": { "url": "https://mcp.groundmail.dev/mcp" } } } 添加到 .cursor/mcp.json;Cursor 会显示“需要登录” |
| Claude.ai | Settings → Connectors → Add custom connector → 粘贴 URL |
| ChatGPT | Settings → Apps & Connectors → Create(开发者模式)→ 粘贴 URL,并选择 OAuth 身份验证 |
连接时,你可以选择访问权限:完整、仅发送或只读。随时可以在 Groundmail 的 Settings → CLIs & agents 下撤销授权。
你可以这样提问
“向 [email protected] 发送一封密码重置邮件,发件地址为 [email protected]。”
“我最近发送的 10 封邮件都送达了吗?显示所有退信。”
“将 mail.acme.com 添加为发信域名,并在 Cloudflare 上应用 DNS 记录。”
“过去 7 天我的送达情况如何?”
工具涵盖邮件(发送、列出、查询)、域名(添加、通过 Cloudflare、Vercel、GoDaddy、Netlify、DigitalOcean 或 DNSimple 应用 DNS、验证)、模板、Webhook、抑制名单、地址验证、送达情况、DMARC 监控、邮件测试(每次运行使用一个测试地址,然后等待邮件并读取其中的代码和链接)、从其他服务提供商导入,以及租户(每个为其发送邮件的客户对应一个租户:创建、更新、暂停、恢复、查看统计信息;发送邮件、域名和抑制名单均可指定 tenant)。每个工具都带有只读和破坏性操作注释以及输出架构。完整列表:docs.groundmail.dev/ai/mcp。
传输方式
| 模式 | 命令 / URL | 身份验证 |
|---|---|---|
| HTTP(托管) | https://mcp.groundmail.dev/mcp | OAuth(推荐)或 Authorization: Bearer gm_… |
| stdio | npx -y groundmail-mcp | GROUNDMAIL_API_KEY=gm_… |
| HTTP(本地) | npx -y groundmail-mcp --http --port 3000 | 每次请求都需提供 Authorization: Bearer gm_… |
可选:GROUNDMAIL_API_URL(例如,连接本地 API 时使用 http://localhost:3003/api)。
本地 HTTP 端点:http://127.0.0.1:3000/mcp · 健康检查:GET /health
托管服务健康检查:GET https://mcp.groundmail.dev/health
使用 API 密钥的 Cursor(stdio)
.cursor/mcp.json:
{
"mcpServers": {
"groundmail": {
"command": "npx",
"args": ["-y", "groundmail-mcp"],
"env": {
"GROUNDMAIL_API_KEY": "gm_your_key_here"
}
}
}
}
使用 API 密钥的 Cursor(本地或托管 HTTP)
npx -y groundmail-mcp --http --port 3000
{
"mcpServers": {
"groundmail": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer gm_your_key_here"
}
}
}
}
若要在托管服务中使用密钥而非 OAuth,请使用 "url": "https://mcp.groundmail.dev/mcp",并设置相同的标头。
使用 API 密钥的 Claude Code
# Hosted, API key
claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp \
--header "Authorization: Bearer $GROUNDMAIL_API_KEY"
# Local stdio
claude mcp add groundmail --env GROUNDMAIL_API_KEY=gm_your_key_here -- npx -y groundmail-mcp
想让你的编码 Agent 也了解 Groundmail?安装 Agent 技能:npx skills add Groundmail/groundmail-skills -y。
为什么选择 Groundmail
- 自有邮件服务器和 IP 地址段。 你的密码重置邮件和收据不会与批量营销邮件共用发送池。
- 仅发送事务性邮件。 平台不发送新闻简报或冷邮件,确保发送信誉良好。
- 免费起步。 免费额度每月可发送 3,000 封邮件。超出后按量付费:每 1,000 封 $0.70,使用量越大,单价越低。定价
- 为代码和 Agent 打造。 提供 REST API、SMTP、适用于 Node、Python、Go、PHP 和 Ruby 的 SDK、命令行工具,以及适用于 Claude、ChatGPT 和 Cursor 的 MCP 服务。
所有 Groundmail 库
| 用途 | 软件包 |
|---|---|
| Node.js / TypeScript | npm 上的 groundmail |
| Python(Django)、Go、Ruby(Rails Action Mailer) | Groundmail/groundmail-sdks |
| PHP | Groundmail/groundmail-php |
| Laravel | Groundmail/groundmail-laravel |
| Symfony Mailer | Groundmail/groundmail-symfony-mailer |
| Nodemailer | Groundmail/groundmail-nodemailer |
| NestJS | Groundmail/nestjs-groundmail |
| Strapi | Groundmail/strapi-provider-email-groundmail |
| Medusa | Groundmail/medusa-notification-groundmail |
| AdonisJS | Groundmail/adonisjs-groundmail |
| Phoenix(Swoosh) | Groundmail/swoosh_groundmail |
| 命令行工具 | npm 上的 groundmail-cli |
| MCP 服务(Claude、ChatGPT、Cursor) | Groundmail/groundmail-mcp |
| Agent 技能和 Claude Code 插件 | Groundmail/groundmail-skills |
| 邮件模板(React Email、MJML、HTML) | Groundmail/email-templates |
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。