开发者
通过 MCP 使用 adbtd
在 Claude Code、Claude Desktop、Cursor 或任何兼容 MCP 的智能体中,将 adbtd 添加为 Model Context Protocol 服务器。您的智能体可以列出邮箱、发送邮件、读取送达率指标,无需您手动封装 REST API。
一个服务器 URL:https://mcp.adbtd.com。OAuth 授权,可在控制台随时撤销。
第 1 步
添加服务器
在智能体的 MCP 配置里加一行,各客户端的写法见下文。
第 2 步
在浏览器中授权
首次连接时,您会被带到 adbtd 进行批准。我们会在您的账户下自动生成一个带有该智能体名称的 API 密钥。
第 3 步
使用工具
您的智能体现在可以调用 list_mailboxes、send_email、get_deliverability 等工具。
安装
Claude Code
在终端中:
claude mcp add --transport http adbtd https://mcp.adbtd.com--transport http 参数是必需的,否则 Claude Code 会把它当作基于 stdio 的本地服务器而连接失败。
首次使用时,Claude Code 会打开浏览器完成 OAuth 流程。在 adbtd 控制台中批准后,连接即就绪。
如果您之前运行命令时没有带该参数,请先删除损坏的条目:claude mcp remove adbtd。
Claude Desktop
Claude Desktop 在本地运行 MCP 服务器。使用 mcp-remote 桥接,让它能与我们这样的远程 HTTP 服务器通信。编辑您的配置(macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json;Windows 上为 %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"adbtd": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.adbtd.com"]
}
}
}重启 Claude Desktop。第一次用到该服务器的对话会打开浏览器进行 OAuth 流程。
Cursor
在 ~/.cursor/mcp.json(或项目级的对应文件)中:
{
"mcpServers": {
"adbtd": {
"url": "https://mcp.adbtd.com"
}
}
}其他兼容 MCP 的智能体
任何支持 MCP over Streamable HTTP 的智能体都可以使用 https://mcp.adbtd.com。服务器支持带动态客户端注册的 OAuth 2.1,您的智能体会通过标准的 /.well-known/oauth-protected-resource 元数据发现授权服务器。
不原生支持远程 MCP 的智能体,可以使用上文 Claude Desktop 部分展示的 mcp-remote 桥接。
工具
所有工具都限定在工作区范围内:智能体持有的 OAuth 令牌将其绑定到一个 adbtd 工作区。跨工作区访问在设计上就不可能。工具集与面向客户的 REST API 一一对应,能通过 /api/v1/* 做的,都能通过 MCP 做。
| 工具 | 作用 |
|---|---|
| get_me | 工作区信息 + 订阅状态,等同于 GET /v1/me。 |
| list_mailboxes | 列出邮箱,可按域名或状态筛选。 |
| get_mailbox | 按 id 获取一个邮箱。 |
| create_mailbox | 在已验证的域名上开通一个邮箱。返回可直接使用的 SMTP/IMAP 信息。 |
| delete_mailbox | 按 id 彻底删除一个邮箱。不可逆,磁盘上的 maildir 会被删除。 |
| send_email | 通过您的某个邮箱经 SMTP 提交发送邮件。 |
| list_messages | 通过 IMAP 获取邮箱中的最近邮件。分页。 |
| get_message | 按 IMAP UID 获取一封邮件的完整正文和附件。 |
| list_domains | 列出工作区中的域名及其 SPF/DKIM/DMARC 状态。 |
| add_domain | 向工作区添加一个(自有)域名。需要发布的 DNS 记录在 list_domains 中返回。 |
| delete_domain | 删除一个域名及其上的所有邮箱。不可逆。 |
| list_ips | 列出专用 IP 及其 RBL 列入情况。 |
| add_ips | 订购 N 个额外的专用 IP。如需操作,可能返回 Stripe 结账 URL。 |
| release_ip | 将专用 IP 释放回池中。释放最后一个 IP 会取消订阅。 |
| get_deliverability | 7 天发送量、平均垃圾邮件评分、主要特征、RBL 状态,与 /dashboard/deliverability 数据相同。 |
授权
- 自动开通。 您永远不需要粘贴 API 密钥。智能体首次连接时,浏览器会打开 adbtd.com/oauth/authorize,您批准后,我们在您的账户下生成一个密钥。
- 在控制台中可见。 每个连接都会显示在 /dashboard/api-keys 的“mcp 连接”下,带有智能体自报的名称(例如“Claude Code”)。
- 随时撤销。 “断开连接”只是切换一个标志:该智能体的下一次 MCP 调用就会返回 401。无需重启,没有传播延迟。
- 限定工作区范围。 令牌绑定到一个工作区。智能体永远无法查看、列出或操作属于其他工作区的数据,即使尝试也不行。
- 基于标准。 OAuth 2.1 + 动态客户端注册 + PKCE(仅 S256)。参见 /.well-known/oauth-authorization-server。
- 像对待密码一样对待访问令牌。 它保存在智能体的本地配置中,切勿粘贴到聊天窗口、问题跟踪器或公开脚本里。如果泄露,请在控制台中断开连接并重新授权。
价格
MCP 不单独收费。您工作区现有的按邮箱 + 按 IP 订阅同样涵盖 MCP 使用,就像它涵盖 REST API 和 IMAP/SMTP 访问一样,参见价格。