跳到主要内容
abnormal.

Claude connector

Claude 连接器:Abnormal Mail。

让 Claude 帮你打理 Abnormal 管理控制台里的工作区:域名、邮箱、转发、别名、邮件列表等,说一句话就行。这里说明需要什么、怎么连接、Claude 能做什么不能做什么,以及怎么断开。

最后更新:

这是什么

这个连接器通过 Model Context Protocol(MCP)把 Claude 接到 Abnormal 管理控制台的管理 API 上。你批准之后,Claude 就能在你授予的权限范围内,查询和修改你在控制台里管理的内容(域名、邮箱、转发、别名、邮件列表、法律保留、跟进任务、Webhook 和抑制列表),并追踪一封邮件的投递经过。

  • 连接器地址:https://console.abnormalhq.com/api/mcp
  • 登录方式:OAuth 2.0。由你本人登录管理控制台,并在它的授权页上批准权限;Claude 永远看不到你的控制台密码。
  • 规则与 API 相同:每一次工具调用就是一次管理 API 调用,权限检查、限制和操作日志都与使用 API 密钥的调用一样。

需要什么

  • Abnormal 管理控制台(console.abnormalhq.com)的管理员账号。操作员和只读成员不能授权这个连接器。
  • 在商店购买邮箱不会开通管理控制台账号;本站的我的账户是另一套登录,不能用来登录控制台。如果你的组织在用 Abnormal 的邮件服务、却没有控制台账号,请写信到 support@abnormalhq.com。
  • 网页版、桌面或手机 App 中的 Claude,或者 Claude Code。能添加哪些连接器,可能取决于你的 Claude 套餐;在组织中使用时,还取决于组织所有者的设置。

在 Claude 中连接

  1. 在网页版或桌面 App 的 Claude 中,打开「Settings → Connectors」。
  2. 在目录中找到 Abnormal Mail,选择「Connect」。如果你这里没有列出它,选择「Add custom connector」,地址填 https://console.abnormalhq.com/api/mcp。
  3. 管理控制台会打开。用你的管理员账号登录。
  4. 检查授权页(见下文),为每类资源选好权限后批准。随后会回到 Claude,连接器显示为已连接。

连接之后,凡是用同一个账号使用 Claude 的地方都能用这个连接器,手机 App 也一样。在对话里直接用平常的话提出需求,Claude 会自己选用需要的工具。

在 Claude Code 中连接

在终端中运行

claude mcp add --transport http mailhq https://console.abnormalhq.com/api/mcp

  1. 运行上面的命令,以 mailhq 为名添加这个服务器。
  2. 启动 Claude Code,输入 /mcp,选择 mailhq,再选择进行认证。浏览器会打开管理控制台:像在 Claude 中一样登录并批准。
  3. 回到 Claude Code,mailhq 显示为已连接,它的工具就可以用了。

其他支持 OAuth 的 MCP 客户端,也用同一个地址、同样的方式连接。不能使用 OAuth 的客户端,可以改用控制台「设置 → API 密钥」中创建的 API 密钥,放在 Authorization: Bearer 请求头里发送。

授权页会问什么

在共享任何内容之前,控制台会显示一个授权页,写明申请权限的应用名称,以及批准后会把你送回的地址。只批准你自己发起的连接,并确认返回地址是你预期的:Claude 是 claude.ai,Claude Code 是你自己电脑上的 localhost。

  • 按资源选择权限:域名、邮箱、转发、别名、邮件列表、法律保留、跟进任务、Webhook、抑制列表和邮件追踪,每一类都可以选「无权限」「只读」或「读写」。邮件追踪默认关闭,除非你主动选择,因为追踪结果会显示谁给谁写了信。
  • 需要刚刚登录过:批准时,你必须在最近 10 分钟内登录过或重新输入过密码。
  • 只对一个工作区:权限只适用于你批准时所登录的那个工作区。
  • 你的角色依然有效:Claude 能做的永远不会超过你的管理员角色所允许的范围。你失去管理员角色或离开工作区时,连接随即结束。

Claude 能做什么

这些工具就是管理 API 的各项操作,下面按授权页上的资源分组。「只读」可以列出和查看;「读写」再加上修改。

  • 域名:读取域名列表与详情、DNS 与连接状态、接入申请、别名域名、全收(catch-all)设置和可用的服务器;写入:发起并验证域名接入、导入域名、启用或停用域名、添加或移除别名域名、设置全收、移除域名的本地记录。
  • 邮箱:读取邮箱列表与详情、已删除的邮箱、每日发信上限,以及报表(不活跃邮箱、存储用量、发信最多的邮箱);写入:创建、删除和恢复邮箱,修改密码、状态、容量、备注或发信上限。
  • 转发:读取一个域名的转发规则;写入:创建和删除转发规则。
  • 别名:读取一个域名的普通别名;写入:创建、修改和删除别名。
  • 邮件列表:读取邮件列表及其成员;写入:创建、改名和删除列表,添加和移除成员。
  • 法律保留:读取邮箱和域名上的法律保留;写入:设置和解除法律保留。
  • 跟进任务:读取任务、任务时间线、任务跟进的对话和等待批准的邮件;写入:创建任务、给任务留言、把一段对话交给任务、修改任务的限制、暂停、继续或取消任务,以及批准或拒绝一封邮件。
  • Webhook:读取 Webhook 及其投递记录;写入:创建、修改、删除和测试 Webhook,以及重新发送一次投递。
  • 抑制列表:读取列表、查询某个地址;写入:添加和移除地址。
  • 邮件追踪:只读,按发件人、收件人或 Message-ID 查询本工作区邮件的投递经过。邮件追踪还需要 Abnormal 团队为工作区开启;开启之前,这个工具会回答不允许使用。

Claude 还可以把最多 25 项邮箱、域名和别名的修改作为一批来执行;其中每一项都会按你授予的权限单独检查。

读取操作直接执行,不会询问。所有会做出修改的工具都标记为破坏性操作,所以 Claude 在运行之前会先问你:允许之前请看清它要做什么。有些修改无法撤销。删除邮箱会连同其中的邮件一起删除(默认先进入「已删除的邮箱」,在清除之前还可以恢复;永久删除则无法挽回)。批准一封跟进邮件会立即发出;跟进任务会以它所属的邮箱自行发信,除非创建时选择了需要批准的发送方式。

Claude 看不到什么

  • 看不到邮箱里的邮件:没有任何工具可以读取、搜索或删除邮箱里的邮件,也没有工具能让 Claude 自己发出一封邮件。邮箱密码永远不会返回。
  • 跟进任务里的内容除外:有跟进任务的只读权限时,Claude 能看到任务里保存的内容:任务说明、它跟进的对话的主题和发件人、它收到的每封邮件的开头(在时间线里),以及它写出的邮件全文。如果不想让 Claude 看到任何邮件内容,请把跟进任务设为「无权限」。
  • 邮件追踪显示谁在什么时候给谁写了信、投递结果如何,不显示邮件写了什么。
  • 你输入的内容在对话里:你让 Claude 设置的密码,和你写的其他内容一样,都是你与 Claude 对话的一部分。

示例

  • 「example.com 下有哪些邮箱被停用了?」
  • 「把 help@example.com 转发到 support@example.com。」
  • 「给 anna@example.com 建一个别名 sales@example.com。」
  • 「哪些邮箱 90 天里没有登录、也没有邮件?」
  • 「bounce@example.net 在不在我们的抑制列表里?在的话把它移除。」
  • 「昨天 alice@example.com 发给 bob@example.org 的那封邮件送到了吗?」
  • 「给 dana@example.com 设置法律保留,原因:案件 2026-114。」
  • 「列出等待批准的跟进邮件。」

断开与撤销

  • 在 Claude 中:打开「Settings → Connectors」,选中这个连接器并断开。
  • 在管理控制台中:「账号设置 → 已连接的应用」列出连接到你账号的应用,撤销后它会在下一次请求时被拒绝。管理员还能在「设置 → API 密钥 → 已连接的应用」中看到整个工作区的连接,并撤销其中任何一个。
  • 以下情况也会自动结束:你修改了控制台密码或登录邮箱、失去管理员角色或离开工作区,以及连续 30 天没有使用。

从 Claude Code 中移除

claude mcp remove mailhq

安全与你的数据

  • 令牌:Claude 拿到的访问令牌有效 1 小时,刷新令牌有效 30 天,每使用一次就换一个新的。控制台只保存它们的 SHA-256 哈希。
  • 控制台保存什么:这个连接本身(应用名称、客户端 ID 和返回地址、你授予的权限、工作区、你的账号,以及创建和最后使用的时间)。Claude 做出的每一项修改都会记入工作区的操作日志,并注明是哪个连接;每一次调用都会像 API 密钥的调用一样计入 API 调用统计(路径、状态和耗时,不含请求内容)。
  • 控制台收到什么:只有 Claude 每次调用工具时发送的参数,从来不包括你的对话。Anthropic 如何处理你的对话,适用 Anthropic 的隐私政策。
  • 不交给其他人:除了我们的隐私政策已经列出的服务商,不会传给任何人;政策中关于已连接应用的一节有详细说明,包括记录保存多久。

常见问题

  • 又被要求输入密码:批准需要最近 10 分钟内登录过或输入过密码。输入密码后再批准即可。
  • 无法批准:只有管理员能授权这个连接器。请工作区的管理员来连接,或请管理员给你管理员角色。
  • Claude 看到的是另一个工作区:连接属于你批准时所登录的工作区。在 Claude 中断开连接,在控制台的用户菜单里切换到正确的工作区,然后重新连接。
  • 工具回答不允许:这类资源没有授权,或者只授予了只读。断开后重新连接,选择你需要的权限。邮件追踪还需要 Abnormal 团队为工作区开启。
  • 请求太多:每个连接每分钟最多 300 个请求,与用同一个连接发出的管理 API 调用合并计算。超出的请求会被拒绝,直到这一分钟结束;被拒绝的请求什么也没有改:稍等后再试,或者让 Claude 把多项修改合成一批。
  • 修改可能没有完成:遇到超时或「结果不确定」的回答时,先让 Claude 查一下当前状态再重试,以免重复创建。
  • 突然不能用了:连接可能已被撤销、因修改密码而结束,或连续 30 天未使用而过期。重新连接即可。

获取帮助

连接器的使用问题、故障或安全疑虑,请写信到 support@abnormalhq.com,附上你的工作区、时间和 Claude 的回答。不要附上密码或令牌。正在发生的故障可以先看服务状态页。