# Claude 连接器：Abnormal Mail

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

最后更新：2026-11-12

## 这是什么

这个连接器通过 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）的**管理员**账号。操作员和只读成员不能授权这个连接器。
- 在商店购买邮箱不会开通管理控制台账号；本站的[我的账户](https://abnormalhq.com/zh/shop/account/)是另一套登录，不能用来登录控制台。如果你的组织在用 Abnormal 的邮件服务、却没有控制台账号，请写信到 [support@abnormalhq.com](mailto: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 中连接

在终端中运行

```sh
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 中移除

```sh
claude mcp remove mailhq
```

## 安全与你的数据

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

## 常见问题

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

## 获取帮助

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

- [阅读隐私政策](https://abnormalhq.com/md/zh/privacy/)
- [安全与隐私概览](https://abnormalhq.com/md/zh/security/)