用途:xano-init 是 Xano 开发者 MCP 提供的交互式初始化流程,目的是让开发者在 Xano 工作区中安全、规范地开发,而不是简单罗列工作区内容。它通过环境检查、问答和冒烟测试,最终生成一份开发 playbook(.claude/xano-workspace-profile.md),并更新 CLAUDE.md 中的 Xano 指引。
主要能力:1)环境检查:检测 Xano MCP 工具与 CLI 是否安装、版本是否最新、sandbox 命令是否可用,以及登录状态和本地 xano/ 目录、.xs 文件、既往 profile 是否存在。2)交互式配置:确认目标工作区、分支、应用阶段(开发/测试/生产)、团队协作与命名约定、不可改动的表、端点、函数、环境变量和敏感集成,以及代码编辑与校验偏好。3)工作流验证:用 MCP 校验 XanoScript、做只读 Meta API 调用、确认分支可访问、验证 sandbox 是否可创建并返回 ok。4)生成开发手册:输出工作区信息、开发规则、sandbox 或 workspace push 的部署步骤、测试与重置命令、禁止区域和故障排查。
使用方式:先通过 npm install -g @xano/cli 安装 CLI,通过 claude mcp add xano -- npx -y @xano/developer-mcp 添加 MCP,登录使用 xano auth。所有 CLI 命令可配合 -p [profile] 指定专用 profile。sandbox 工作流命令包括 xano sandbox get、xano sandbox push ./xano、xano sandbox review、xano sandbox unit_test run_all、xano sandbox reset -p [profile] -f、xano sandbox env list 等;如需直接推送,可用 xano workspace push ./xano,并先加 --dry-run 预览。
适用场景与限制:适合需要理解 Xano 工作区约束、默认采用安全部署流程的开发者,尤其是多工作区或多分支场景。sandbox 是推荐默认方式,完全隔离,只有显式 promote 才影响真实工作区;workspace push 会直接作用到分支,表结构变更会立即影响真实数据库,且 allow_push 默认关闭,需在仪表盘开启。若未安装 CLI、未登录或 CLI 过旧不支持 sandbox 命令,必须先修复。资料未说明具体收费、价格、支持平台和性能指标。