用途:该技能用于管理 CData Connect AI 平台本身(cloud.cdata.com),通过 /api/ui/* 管理 API 执行管理操作,不用于查询或写入已连接数据源中的数据。数据读写应使用 connect-ai-base 加对应连接器技能、connect-ai-direct 等。
主要能力:列出与创建、测试、删除连接;查看已安装驱动(约 200 个)并提取驱动的连接表单;管理工作区及其资产与发布;管理工具包、工具与 MCP URL;管理缓存任务与定时查询(列出、创建、运行、停止、更新、删除);管理用户与角色(列出、邀请、编辑、删除);管理个人访问令牌(列出、签发、撤销);查看订阅与用量等账单信息。
使用方式:仅在用户提出具体管理请求时执行,先做预检。在 Claude Code(有 shell)中运行 node scripts/connect-cli.mjs status 检查会话;无会话时运行 node scripts/connect-cli.mjs login 完成 Auth0 浏览器登录,再用 node scripts/connect-cli.mjs whoami 验证。令牌缓存在本地并自动刷新 24 小时。也可用 CLI 获取的 Auth0 令牌直接调用 REST 端点。创建连接的推荐流程:先 driver-form --driver D 了解认证方式与必填属性,再 connection-create 创建并自动验证。
限制:管理平面仅接受 Auth0 Bearer 令牌,个人访问令牌会被拒绝(401);无 shell 的界面(如 Claude Chat)不支持管理操作,不能通过浏览器 DevTools 抓取令牌绕过。删除连接、工作区、工具包、任务、用户,撤销 PAT 或删除账户等破坏性操作需每次显式确认,且 CLI 命令需加 --confirm。凭据不经过聊天传递,通过本地 HTML 表单收集。权限遵循登录用户自身权限,403 应如实反馈而非绕过。返回 HTML 表示访问了错误路径,应使用 /api/ui/* JSON 端点。
适用场景:平台层面的连接、驱动、工作区、工具包、任务、用户、令牌与账单管理。具体端点目录、认证细节、连接配方与错误处理等深入内容按需加载参考文档。