把 Claude Code 连接到您的面板 — 文档

完成设置后，您在终端里工作时，Claude Code 就可以查看您的面板：“我的哪个账户最接近磁盘上限？”、 “显示 example.com 的 DNS 记录”。它只能读取您的令牌所允许的内容。任何删除或中断操作，都会变成一个等待您在面板中按下“批准”的请求。助手永远不能批准自己的请求。

这是在 Nimbopanel 中使用 AI 的第二种方式。第一种是面板内置的聊天侧边栏，详见 AI 助手。使用本文的方式并不需要先开启那一种。

开始之前

您面板的地址，例如 https://panel.yourdomain.com。请使用面板自己的地址，不要使用 IP。
您的电脑上已安装 Claude Code（在终端中可以运行 claude 命令）。
面板上的一个账户：管理员、经销商、客户或团队用户均可。

1. 管理员开启连接（只需一次）

打开系统 → 安全 → AI 助手连接（MCP），勾选允许 AI 助手连接，选择哪些角色可以连接，然后点击保存。卡片上会显示助手使用的地址：即您面板地址后加 /mcp。

全新安装时该开关是关闭的。在开启之前，/mcp 会返回 404，下面的步骤都无法进行。

2. 创建一个仅供助手使用的令牌

登录面板并打开 API 令牌：管理员和经销商在安全下，客户在高级下。打开连接 AI 助手（Claude 等）。

起一个您能认出的名字，例如 Claude Code on my laptop。
为面板的每个部分选择无权限、读取或读取和更改。建议先选读取：助手可以查看您勾选的所有内容，但不能修改任何东西。
**失效时间（天）**保持 90，或填入您自己的天数。
点击创建助手令牌。

面板此时只会显示令牌这一次。离开页面之前请先复制好。

3. 粘贴一条命令

面板会给出已经填好您的地址和令牌的命令。复制后在终端中运行即可。它的样子如下：

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

这条命令的意思是：添加一个名为 nimbopanel 的 MCP 服务器，通过 HTTP 访问面板的 /mcp 地址，并在每次调用时把您的令牌放在 Authorization 请求头中发送。

Claude Code 把它保存在哪里。 默认情况下，该服务器只为当前项目保存，存放在您电脑上的 ~/.claude.json 中，而不是项目文件夹里。加上 --scope user 即可在所有项目中使用。请不要在使用真实令牌时加 --scope project：那会把令牌写进 .mcp.json，而这个文件本来就是用来提交和共享的。如果团队要共用这个连接，请在 .mcp.json 中只写引用，让每个人把自己的令牌放在环境变量里：

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

每个人都应该创建自己的令牌，这样每个请求都能看出是谁发起的，也可以单独吊销某一个令牌。

4. 检查是否连通

claude mcp list

nimbopanel 应显示为已连接。在 Claude Code 里也可以输入 /mcp。然后用日常的话直接提问：

“列出我的托管账户，告诉我哪个占用的磁盘最多。”
“显示 example.com 的 DNS 记录。”
“我的哪些数据库最大？”
管理员：“所有服务都在运行吗？”、“邮件队列是不是在变长？”

助手可以查看账户及其用量、域名、DNS 记录、邮箱账户（绝不包括密码）、数据库、备份、服务器负载和服务、邮件队列、经销商和支持工单，范围限于您的令牌所指定的部分以及您自己的角色权限。

当您要求修改时

选择读取和更改后，在一个全新的普通名称上添加普通的地址记录（A 或 AAAA）或文本记录（TXT），会立即执行。
其他一切都要等待您：删除记录、暂停或恢复账户、邮件记录、域名本身、CNAME、SRV 和 CAA 记录、通配符，以及邮件程序会查询的名称。这些都会变成一个请求。

打开 API 令牌 → 助手的请求。每个请求都会用通俗的话说明将要发生什么。点击批准…，再点击是，立即执行。请求会在 30 分钟后过期。请看请求本身，而不是助手的消息：请求由面板撰写，会准确说明将要执行的内容。

由于这项更改是助手提出的，面板会先要求您用密码（若使用两步登录，还需验证码）确认是您本人；之后几分钟内不会再次询问。

如果无法使用

您看到的现象	含义	该怎么做
`/mcp` 返回 `404 Not found`，或显示一个提示该地址未配置任何网站的页面	连接已关闭，或您使用的不是面板自己的地址（例如 IP 或其他域名）	检查步骤 1；使用面板自己的地址，并以 `/mcp` 结尾
`403 forbidden_host`	该地址能到达面板，但面板不把它认作自己的地址	使用面板自己的地址，例如 `https://panel.yourdomain.com`
`401 Login required`	令牌缺失、输入有误、已过期或已被吊销	重新创建令牌并再次运行命令
`403 mcp_scope_required`	这是普通的 API 令牌，不是助手专用的令牌	在连接 AI 助手（Claude 等）下创建令牌
`403 mcp_off_for_role`	您这类账户不允许连接助手	请管理员处理（步骤 1）
`429 rate_limited`	短时间内调用次数过多	等待一分钟
面板的某个部分看不到	该部分被设为无权限	重新创建令牌，把该部分设为读取

如果 claude mcp list 显示失败，通常是网址缺少 /mcp，或者请求头不是严格的 Authorization: Bearer <token>。

撤销连接

claude mcp remove nimbopanel

这会把它从您的电脑上移除。若要让令牌在所有地方都失效，请在 API 令牌中删除它；它尚未处理的请求也会随之取消。管理员可以在步骤 1 中关闭整个连接，此后 /mcp 又会返回 404。

良好习惯

优先选择读取。只在确实需要的部分使用读取和更改。
每台电脑或每个人一个令牌，名称要能看出是谁的。
保持默认的 90 天，共用的电脑则设置得更短。
绝不要把令牌粘贴到聊天、工单或会提交的文件里。

暂不支持：只能通过 OAuth 登录方式连接的客户端。该端点接受放在请求头中的令牌。