MCP Server 与外部 AI 客户端：AnQiCMS 如何被 Claude、Cursor 接入调用

AnQiCMS v3.6.5 版本引入了基于意图目录重建的 MCP Server，将系统内的各类操作接口统一收敛为标准化工具集。该 Server 支持 Bearer Token 鉴权，允许外部 AI 客户端（如 Claude Desktop、Cursor）通过标准 MCP 协议接入并调用系统功能。其核心设计包括意图目录的分类管理、回合级操作审批机制以及高危域的默认关闭策略，在提供强大自动化能力的同时保障系统安全。

MCP Server 的架构与意图目录

MCP（Model Context Protocol）是 Anthropic 提出的标准化协议，用于让大语言模型与外部系统交互。AnQiCMS v3.6.5 版本的 MCP Server 实现了这一协议，将系统内的操作接口按业务域划分为多个意图目录（内容域、SEO 域、用户域、运维域等），每个域包含若干具体工具。

Server 采用三层架构：意图目录层负责工具分类，鉴权层通过 Bearer Token 验证身份，执行层路由到对应业务逻辑。这种设计使得新增工具只需在意图目录中注册，不同域可设置不同的暴露范围与审批策略。

Bearer Token 鉴权与回合级审批

AnQiCMS 采用 Bearer Token 进行 MCP Server 鉴权。在后台生成访问令牌后配置到 AI 客户端，每次请求时客户端在 HTTP Header 中携带 Authorization: Bearer <token>。建议为不同客户端分配独立 Token，便于审计与撤销。

对于写操作，系统引入回合级审批机制：AI 发起请求后 Server 返回「待确认」状态及预览，人类用户审查后发送确认指令才执行。当需执行多个连续写操作时，可合并为一个确认请求批量批准，提升效率的同时保持安全控制。

Claude 与 Cursor 的接入步骤

接入 Claude Desktop：在设置的「MCP Servers」中添加新 Server，填写 AnQiCMS 的 MCP 端点 URL 与 Bearer Token。连接成功后 Claude 会自动加载可用工具列表。

接入 Cursor：在命令面板选择「Connect to MCP Server」，输入端点 URL 与 Token。连接后 Cursor 的代码补全与聊天功能可调用系统 API。

两种客户端的使用体验类似，Claude 更适合自然语言交互，Cursor 侧重于代码编辑场景。

高危域的默认关闭策略

出于安全考虑，AnQiCMS 将备份/恢复、升级、多站点管理等高危操作域设为默认关闭。这些域的工具不会出现在 list_tools 结果中，除非管理员显式开启暴露开关并二次确认。这种默认关闭的设计遵循最小权限原则，即使 Token 泄露也无法执行高危操作。

常见问题

问：MCP Server 是否支持 HTTPS？

答：支持。若站点已配置 SSL 证书，MCP 端点会自动使用 HTTPS 协议。建议在公网暴露时始终启用 HTTPS。

问：能否限制某个 Token 只能调用特定域的工具？

答：可以。生成 Token 时可绑定允许的域列表，即使 Token 泄露影响范围也被限定在授权域内。

问：回合级审批能否跳过？

答：读操作无需审批直接返回结果。写操作的审批不可完全跳过，但可通过合并确认减少确认次数。

问：MCP 工具的数量会随版本变化吗？

答：会。随着新功能加入，意图目录中的工具数量会增加。具体数量以当前版本的 list_tools 接口返回为准。