AI 助手——面板内置的助手，以及把 Claude 连接到您的面板 — 文档

Nimbopanel 提供两种使用 AI 的方式。两种方式都在您开启之前保持关闭，而且在两种方式下，助手只能看到使用它的那个人本来就有权看到的内容。

	内置助手	连接您自己的助手（MCP）
位置	Nimbopanel 内的侧边面板	使用者电脑上的 Claude Code / Claude Desktop 或其他 MCP 客户端
谁付费	您（运营方），使用您为所选服务商准备的自己的 API 密钥	运行该助手的人
开关	系统 → 安全 → 面板内的 AI 助手	系统 → 安全 → AI 助手连接（MCP）
能否修改内容？	只能提议：由使用者按下“批准”	小的、可撤销的修改会直接执行；任何删除或中断操作都要等待批准

内置助手

用户用自己的语言提问——“为什么我的邮件收不到？”、“还剩多少磁盘空间？”—— 助手会读取面板信息来回答。

开启方法（管理员）：

打开系统 → 安全 → 面板内的 AI 助手。
选择 AI 服务商（见下方列表）。选项旁边有一个链接，会带您前往该服务商生成密钥的页面。
粘贴您在该服务商处获得的 API 密钥。它保存在您服务器上一个仅 root 可读的文件中，之后不会再显示——不会显示给您，也不会显示给任何人。更换服务商时，旧服务商的密钥不会被沿用。
选择模型。列表会给出该服务商的几个常用名称，您也可以按服务商列出的名称原样输入任何模型名称。
选择谁可以使用：管理员、经销商、客户、团队用户。
设置限额：每人每天的提问次数，以及整台服务器的每月令牌预算。预算用完后，助手会暂停到下个月。
勾选开启助手并保存。

可选择的服务商。 其中十个按名称列出，另有两个用于任何其他地址：

选项	需要密钥吗？
Anthropic (Claude)	需要
OpenAI (ChatGPT)	需要
Google (Gemini)	需要
Mistral AI	需要
Groq	需要
DeepSeek	需要
xAI (Grok)	需要
OpenRouter（多种模型，一个密钥）	需要
Together AI	需要
Ollama（在本服务器上）	不需要
其他——兼容 OpenAI	可选
其他——兼容 Anthropic	可选

对于两个其他选项，您需要按服务商文档所给的形式，自行输入该服务商的 API 地址。地址必须以 https:// 开头。只有指向本服务器或私有网络（您自己运行的模型服务器）时，才接受普通的 http://。带有用户名、查询参数或片段的地址，以及位于云元数据范围内的地址，都会被拒绝。

坦率的局限。 助手是用一个行为类似各协议的替身服务商测试的，尚未针对每家厂商的线上服务测试过，因此在您开启助手之后、告诉客户之前，请先试问一两个问题。模型名称经常变化；如果服务商回答说不认识该模型，请输入当前的名称。

选择 AI 提供商并控制账单

按使用量向提供商付费 — 费用随提问数量和回答长度增加。价格经常变动，所以决定前请查看提供商的价格页面，并在提供商自己的控制台里也设置支出上限。Nimbopanel 不额外收费。
选哪一个？ — 想用最少的功夫得到好答案，请选托管的提供商，如 Anthropic、OpenAI 或 Google。想用一个密钥访问多种模型，请选 OpenRouter。想让每个问题都留在自己的服务器上，就在服务器上运行 Ollama：没有按问题计费，但需要足够的内存，而且较小的模型回答较差。以后可以随时更换提供商。
从小处开始 — 保留初始限额（每人每天 30 个问题，整台服务器每月 2,000,000 个令牌），起初只让管理员使用。0 表示不限，请留到以后再用。
决定 AI 可以读取什么 — 如果不希望客户的留言发送给提供商，请勾选“不让 AI 服务接触支持工单”。每个人在第一次提问前都会看到隐私声明。
先试用，再告诉客户 — 在测试账户上问几个问题，并试一次提议的更改：批准时会要求批准者输入自己的密码。

它能做什么、不能做什么

它以提问者本人的权限读取信息：客户的助手只能看到该客户的账户，其他一概看不到；经销商的助手也受经销商权限的限制。
它不能自行修改任何内容。对于少数几种修改（添加或删除 DNS 记录、暂停账户或恢复账户），它会在回答下方准备一张卡片。卡片由面板生成——而不是由 AI 撰写——会准确说明将要发生什么。在使用者按下批准…再按下是，立即执行之前，什么都不会发生。使用者也可以按下拒绝。由于这项更改是助手提出的，面板会先要求您用密码（若使用两步登录，还需验证码）确认是您本人；之后几分钟内不会再次询问。
如果助手在提出建议之前读过其他人写的消息（例如支持工单），卡片会注明这一点。只批准您真正要求的操作。
请求会等待 30 分钟，之后过期。关闭助手会取消所有尚未处理的提议。
通过 API 令牌或在“以…身份登录”打开的标签页中无法使用助手——只能在用户本人的会话中使用。

隐私。 每个人在第一次提问前都会看到一条提示：问题本身，以及助手为回答而读取的面板数据，都会以您的账户发送给您所选的服务商。凡是面板能识别出的密码和密钥，都会从发送内容中删除，但用户绝不应该在助手中输入密码。管理员或经销商的助手可能会读取他们有权查看的其他客户的数据。

连接 AI 助手（MCP）

这让用户可以通过 Model Context Protocol，把自己的助手（例如 Claude）与面板配合使用。

管理员： 打开系统 → 安全 → AI 助手连接（MCP），勾选允许 AI 助手连接，选择哪些角色可以连接，然后保存。
使用者（管理员、经销商、客户或团队用户）打开 API 令牌 → 连接 AI 助手（Claude 等）。为面板的每个部分选择无权限、读取或读取和更改——如果助手只需要查看，请选择读取—— 然后点击创建助手令牌。除非您在**失效时间（天）**中填写其他数字，令牌会在 90 天后失效。
面板会显示要粘贴的命令。对于 Claude Code：
```
claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"
```
其他 MCP 客户端使用相同的地址，并把令牌放在 Authorization: Bearer 请求头中。

已连接的助手可以做什么： 读取其令牌所指定的部分；为一个新的普通名称添加地址记录或文本记录。其他所有操作——删除记录、暂停或恢复账户、邮件记录、域名本身、CNAME/SRV/CAA 记录、通配符，以及邮件程序会查询的名称（autodiscover、autoconfig、mail 等）——都会变成一个请求。令牌的所有者会在 API 令牌 → 助手的请求中看到它，并决定批准或拒绝。助手永远不能批准自己的请求。

暂不支持： 只能通过 OAuth 登录方式连接的客户端（该端点接受放在请求头中的令牌）。您可以随时在 API 令牌中吊销令牌；它尚未处理的请求会随之取消。

良好习惯

每个助手令牌只授予它需要的部分，并尽量选择读取而不是读取和更改。
仔细阅读每一张批准卡片。说明将要发生什么的是卡片——而不是助手的消息。
保持每日提问限额和每月预算的设置；本月的用量可以在同一张卡片上查看。