通过 MCP 工具管理 CloudBase…

当 Agent 需要通过 MCP 工具（queryMysqlDatabase、manageMysqlDatabase、queryPermissions、managePermissions）操作 CloudBase 关系型数据库时使用。

适用场景

解决思路

1. 识别 MCP 上下文：如果能调用 queryMysqlDatabase、manageMysqlDatabase、queryPermissions、managePermissions 等工具，就处于 MCP 上下文，此时绝不要初始化 CloudBase 关系型数据库 SDK，应改用 MCP 工具。
2. 按任务选择正确工具：只读 SQL 与开通状态检查用 queryMysqlDatabase；MySQL 开通、销毁、写 SQL、DDL、schema 初始化用 manageMysqlDatabase；查看权限用 queryPermissions(action="getResourcePermission")；修改权限用 managePermissions(action="updateResourcePermission")。
3. 始终明确安全边界：在执行 DELETE、DROP 等破坏性操作前，先说明将要运行什么以及为什么；写入前优先用 queryMysqlDatabase(action="getInstanceInfo") 或只读 SQL 检查；开通或销毁 MySQL 必须获得显式确认，因为两者都会影响整个环境。
4. 使用 queryMysqlDatabase 查询数据与开通状态：用 action="runQuery" 执行 SELECT 等只读 SQL；用 action="getInstanceInfo" 检查 MySQL 是否已存在（仅生命周期，不返回连接凭据）；用 action="describeCreateResult" 或 action="describeTaskStatus" 查看异步开通进度；仅在迁移已有 TCP/ORM 客户端时例外使用 action="getConnectionInfo" 获取原始连接/集群信息（可能含凭据），新业务 CRUD 不要用它，应优先用 Web/Node SDK 或 runQuery/runStatement。
5. 使用 manageMysqlDatabase 管理生命周期与执行变更 SQL：用 action="provisionMySQL" 开通 MySQL；用 action="destroyMySQL" 销毁 MySQL；用 action="runStatement" 执行 INSERT、UPDATE、DELETE、CREATE TABLE、ALTER TABLE、DROP TABLE；用 action="initializeSchema" 初始化表与索引。
6. 创建新表时必须包含 _openid 列以支持按用户访问控制：_openid VARCHAR(64) DEFAULT '' NOT NULL；用户登录时 _openid 由服务端根据已认证会话自动填充，正常插入时不要手动填写。
7. 调用 manageMysqlDatabase 前确认：当前环境已有就绪的 MySQL 实例或刚开通了一个；目标表与条件正确；必要时已先运行对应的只读查询。
8. 销毁 MySQL 前确认：当前环境确实应失去该 SQL 实例；已获得对该破坏性操作的显式确认；并准备好之后查询 describeTaskStatus 检查销毁结果。
9. 使用 queryPermissions 读取指定 SQL 表的权限配置，用于了解谁可读写表、审计敏感表权限，调用形式为 queryPermissions(action="getResourcePermission", resourceType="sqlDatabase", resourceId="<tableName>")。
10. 使用 managePermissions 设置或更新指定 SQL 表的权限，用于加固敏感数据访问、开放读而限制写、更新资源级权限配置，调用形式为 managePermissions(action="updateResourcePermission", resourceType="sqlDatabase", resourceId="<tableName>", permission="READONLY")。
11. 注意兼容性：规范插件名为 permissions，旧别名 security-rule、security-rules、secret-rule、secret-rules、access-control 仍会路由到 permissions；旧工具 readSecurityRule 与 writeSecurityRule 已移除，始终使用 queryPermissions 与 managePermissions。
12. 场景一（MySQL 尚未开通）：先调用 queryMysqlDatabase(action="getInstanceInfo")；若无实例，调用 manageMysqlDatabase(action="provisionMySQL", confirm=true)；用 queryMysqlDatabase(action="describeCreateResult") 和 queryMysqlDatabase(action="describeTaskStatus") 轮询开通状态；仅当返回的生命周期状态为 READY 时才继续；MySQL 开通优先用 describeCreateResult，describeTaskStatus 保留给销毁流程（其任务响应带 TaskName）。
13. 场景二（安全查看表中数据）：用 queryMysqlDatabase(action="runQuery") 执行带 LIMIT 的 SELECT，并加上相关过滤条件；在任何写操作前先审查结果集并确认符合预期。
14. 场景三（开通后应用 schema 初始化）：确认 MySQL 已就绪；准备有序的 DDL 语句；通过 manageMysqlDatabase(action="initializeSchema") 运行；建表后用 queryPermissions 或 managePermissions 验证权限。
15. 场景四（执行定向写入或 DDL 变更）：必要时先用 queryMysqlDatabase(action="runQuery") 查看当前数据或 schema；用 manageMysqlDatabase(action="runStatement") 执行一次变更；再用另一次只读查询或检查安全规则进行验证。
16. 场景五（环境不再需要时销毁 MySQL）：用 queryMysqlDatabase(action="getInstanceInfo") 确认当前环境仍有 SQL 实例；调用 manageMysqlDatabase(action="destroyMySQL", confirm=true)；反复查询 queryMysqlDatabase(action="describeTaskStatus") 直到销毁任务完成或失败；若成功，可选调用 queryMysqlDatabase(action="getInstanceInfo") 确认实例已不存在；若失败，将返回的错误视为最终结果，由调用方决定是否重试。
17. 遵循 MCP 工具与 SDK 的分工原则：MCP 工具用于 Agent 操作与数据库管理（开通/销毁 MySQL、轮询生命周期状态、运行临时 SQL、查看与修改资源权限，不依赖应用认证状态）；SDK 用于应用代码（前端 Web 应用见 Web 关系型数据库技能，后端 Node 应用见 Node 关系型数据库快速开始）；作为 MCP Agent 时始终优先使用这些 MCP 工具，避免在同一流程中混入 SDK 初始化。
18. 引用同族技能时使用本地相对路径（如 ../auth-tool-cloudbase/SKILL.md）；若引用的同族技能文件在本环境中缺失，请让用户安装完整的 CloudBase 插件（或缺失的技能），不要通过 HTTP 把远程技能或协议 markdown 拉取到 Agent 上下文中。

适用边界 · 注意事项

• 不要用于应通过 SDK 而非 MCP 操作的前端或后端应用代码。
• 不要用于认证流程或用户身份管理。
• 不要用于文档数据库任务（不要把它当作 MySQL 管理任务处理）。