AI 助手与 MCP
面板可以通过 MCP 连接到 Claude Code、Cursor、VS Code 等 AI 助手:运营者用自然语言提问——“本周谁到期”“de-fra 节点怎么了”“给带 vip 标签的客户续期”——助手用您的令牌调用同一套 API。助手能看到的,恰好是令牌允许的。
创建令牌
在面板服务器上运行 veli token add agent --rights read。先选“只读”:助手只能查看,不会改动任何东西。
连接面板
只需一次:走 HTTPS——无需安装任何东西,或在 Linux 电脑上用 veli 命令。令牌放在文件或助手的密钥存储中,不要写进聊天。
提问
助手有现成的场景:晨间巡检、节点状况、处理客户来信、清理不活跃客户、迁移后的报告。
给助手的令牌——只读
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 助手,就能得到符合您需求的后台。
令牌
veli token add cabinet --rights clients。店面和报表用 read 就够了。不要把令牌贴进聊天:只放进服务器的环境变量。
说明文件
下载 openapi.json,附在与 AI 的对话里——或者把说明的地址给它。
提示词
复制下面的文字,把方括号里那一行换成您自己的任务,连同说明文件一起发出。
检查
问 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 天内到期的名单,带“续期”按钮;节点概览。] 如果缺少信息,请先向我提问。然后给出方案,分步搭建后台,并说明如何在本地运行、如何用测试客户检查。