全部文档
07DOCS / 产品文档
AI 与接入
用 MCP、CLI、OpenAPI 或企业微信操作后台;令牌绑权限,动作进日志。
后台除了给人点,也给 AI 客户端和脚本用。三条路:
1. MCP
在「系统 → 访问令牌」里签一个 Agent Token,填名字、绑定管理员、风险上限、每分钟限流、每日 token 预算和有效期。把 token 配到支持 MCP 的客户端(Claude、Cursor 等),客户端就能调用后台工具。
- 工具数量目前是 30 多个,覆盖用户、商品、订单、评论、统计等。
- token 绑在某个管理员身上,他不能做的事,token 也不能做。
- 删除用户、改订单状态这类破坏性操作,会受风险上限约束。
- 每次调用都进操作日志,能看到是哪个 token、哪个管理员做的。
token 只显示一次,丢了就重新签。不用了就撤销,不要共用。
2. CLI
不支持 MCP 的客户端或 shell 脚本,用 CLI 调同一套 /api/admin/agent/* 接口。适合定时任务、CI、批量操作。
3. OpenAPI
服务启动后会生成 OpenAPI 文档,地址是 /api/docs。每个接口带 summary 和所需权限码,可以直接导入 Postman、Apifox 或代码生成器。
企业微信
「系统 → 企微 AI」里填企业微信机器人的 Bot ID 和 Secret,再配一个模型服务(OpenAI 兼容协议)。配好以后,在企业微信里给机器人发消息,就能查数据、改状态。
机器人用的是后台的权限体系,不是另一个账号。谁在企微里问,就按谁的权限回。
建议的边界
- 给 AI 的 token 单独签,不要拿管理员密码。
- 风险上限从低往高开;先只读,确认稳定再放开写操作。
- 每日预算和限流先设小,观察日志再加。
- 定期看操作日志里 token 的动作,发现不对先撤销 token。