文档/如何接入/自建面板/AI 助手与 MCP·9 / 9

AI 助手与 MCP

面板可以通过 MCP 连接到 Claude Code、Cursor、VS Code 等 AI 助手:运营者用自然语言提问——“本周谁到期”“de-fra 节点怎么了”“给带 vip 标签的客户续期”——助手用您的令牌调用同一套 API。助手能看到的,恰好是令牌允许的。

  1. 创建令牌

    在面板服务器上运行 veli token add agent --rights read。先选“只读”:助手只能查看,不会改动任何东西。

  2. 连接面板

    只需一次:走 HTTPS——无需安装任何东西,或在 Linux 电脑上用 veli 命令。令牌放在文件或助手的密钥存储中,不要写进聊天。

  3. 提问

    助手有现成的场景:晨间巡检、节点状况、处理客户来信、清理不活跃客户、迁移后的报告。

给助手的令牌——只读
veli token add agent --rights read
走 HTTPS——有域名的面板直接回应助手,无需安装任何东西
claude mcp add --transport http veli-panel https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api/mcp --header "Authorization: Bearer $VELI_TOKEN"
在您自己的 Linux 电脑上用 veli 命令(令牌在文件 ~/.veli/panel.token 中)
claude mcp add veli-panel -- veli panel mcp --url https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api --token-file ~/.veli/panel.token
只读
客户、节点、分组、事件、流量、回收站。回答中不含客户链接。
客户
另可:新增、续期、修改字段和标签、停用与启用、显示客户链接、批量修改——先预览,再确认数量。
全部
另可:删除客户、更换链接、从回收站恢复、从回收站彻底删除——并且必须重复输入名称。用命令时需加 --destructive 参数。
  • 只有“客户”或“全部”令牌,并且您开启了 --write 参数,助手才能做修改。通过 HTTPS 时,工具集由令牌本身决定。
  • 客户链接是机密:普通回答里没有,只有 client_link 会给出,通过 HTTPS 时会在日志中记一行并带上令牌名称。用命令时没有这一行:需要留痕的地方,请通过 HTTPS 连接。
  • 客户的名称、备注和联系方式是客户写的文字。助手把它们当作数据,不会执行其中的内容。

给 AI 的提示词

一段现成的文字:连同 API 说明一起贴给 Claude 或其他 AI 助手,就能得到符合您需求的后台。

  1. 令牌

    veli token add cabinet --rights clients。店面和报表用 read 就够了。不要把令牌贴进聊天:只放进服务器的环境变量。

  2. 说明文件

    下载 openapi.json,附在与 AI 的对话里——或者把说明的地址给它。

  3. 提示词

    复制下面的文字,把方括号里那一行换成您自己的任务,连同说明文件一起发出。

  4. 检查

    问 AI 如何在您那里运行这个后台,并用测试客户试一试。然后确认链接和令牌没有出现在任何日志里。

令牌
veli token add cabinet --rights clients --days 90

VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -s "$VELI/openapi.json" \
  -H "Authorization: Bearer $VELI_TOKEN" -o veli-openapi.json
给 Claude 的提示词
请帮我基于 Veli 面板现成的 API,为我的 VPN 服务搭建一个后台。面板在浏览器里没有自带界面:所有操作都通过 HTTP API 完成。

你手头有:
- API 说明:文件 openapi.json(已附上)。调用和字段只能取自它,不要自己编造。
- API 地址:https://panel.example.com/<秘密路径>/api(请换成我的)。
- 令牌放在环境变量 VELI_TOKEN 里,通过 Authorization: Bearer 请求头传递。不要把令牌写进代码、日志或网页。

规则:
1. 任何会修改数据的调用都要带 Idempotency-Key 请求头(订单编号):系统可能把通知发两次,而客户只能出现一次。
2. 客户的订阅链接是秘密:只展示给该客户本人,不写进日志。
3. 上限为每个令牌每分钟 300 次请求。收到 429 时,按 Retry-After 指定的秒数等待。
4. 令牌绝不能出现在客户的浏览器里:后台从我的服务器调用 API,而不是从网页调用。
5. 事件(客户已添加、期限将尽、流量将用完、节点没了动静)以 Webhook 形式到达。验证 veli-signature 请求头里的 HMAC-SHA256 签名,先立即应答,之后再处理。
6. 用 external 字段把客户与我的系统关联起来(订单号或您系统中的用户 ID)。

我的任务:
[在此填写:例如——“下单”表单创建 30 天的客户并显示链接和二维码;按订单号查询的“我的订阅”页面;3 天内到期的名单,带“续期”按钮;节点概览。]

如果缺少信息,请先向我提问。然后给出方案,分步搭建后台,并说明如何在本地运行、如何用测试客户检查。