用途:把 Kuroco 管理画面操作(等同 admin_api)以 Model Context Protocol 服务器形式提供给 AI 代理,是推荐的管理操作接入方式。工具并非预先注册,而是由管理画面控制器与服务模型在运行时动态生成,管理画面能做的操作原则上可原样作为 MCP 工具使用。
主要能力:支持对内容定义(topics_group)、内容记录(topics_group_<N>)、会员、文件上传及各类模块的增删改查;支持 whoami 查看实效权限、tools/list 查阅工具、topics-describe 查看字段定义;update 系工具支持字段级与行级(patch.<列名>,配合 base_hash 乐观锁)部分更新;多记录可用同一 update/delete 工具的 ids/filter/set 参数批量处理,支持 dry_run 与 expected_cnt 保护。
使用方式:端点为 POST https://<site_key>.g.kuroco.app/direct/rcms_api/admin_mcp/x/<module>[,<module>][/readonly],须使用 API 域名而非管理域名,且 /x/<scope> 必填,base path 末尾需斜杠。认证有三种:OAuth 2.0 授权码流程(推荐)、特权静态令牌(Bearer)、管理会话(仅供管理画面内部)。CLI 示例:claude mcp add --transport http kuroco https://<site_key>.g.kuroco.app/direct/rcms_api/admin_mcp/x/all 后执行 claude mcp login kuroco。连接后应先运行 whoami 确认实效范围再操作。
限制:权限分 mcp:tools.read / write / all / admin 四级,为上限而非授权,实效权限为成员权限与上限的交集;静态与特权令牌不支持 CIMD,需手动注册客户端;DCR 不支持;group/batch 及超级用户组赋予、特权静态令牌发行等需 mcp:admin;多条写入应逐条执行以免 429;lightweight_mode 会跳过触发器与通知;部分事实(如具体收费、支持平台细节)暂未提供。