开发者

通过 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_mailboxessend_emailget_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_deliverability7 天发送量、平均垃圾邮件评分、主要特征、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 访问一样,参见价格