用途：自动化操作 Metabase，包括创建与更新问题（卡片）、仪表盘、集合、权限与元数据刷新，并覆盖跨环境推广、嵌入式分析、多租户及面向 AI 的语义查询场景。
主要能力：经典 REST API 管理卡片/仪表盘/集合/权限；Agent API（带版本）用于语义化 AI 查询，返回按行数上限并需处理 continuation_token 分页；MCP 服务器（v60+）连接 Claude、Cursor、VS Code；官方 CLI（npm install -g @metabase/cli）；Remote Sync/序列化用于 Git 驱动的跨环境推广；嵌入 + 租户 + 嵌入权限实现多租户分析。
使用方式：先确认 API 可用性（GET /api/util/health），优先用 METABASE_API_KEY 认证，回退会话认证。环境变量包括 METABASE_URL、METABASE_API_KEY、可选 METABASE_SESSION、回退 METABASE_USERNAME/METABASE_PASSWORD。可用脚本执行健康检查、whoami、列出数据库与集合、导出卡片/仪表盘、upsert 卡片/仪表盘、布局写入、运行查询、同步 schema 等。配合 OpenAPI 文档 /api/docs 确认请求结构。
限制与护栏：不要硬编码跨环境数字 ID；不要提交 API 密钥或会话令牌；批量跨环境推广优先用 Remote Sync 或序列化；变更前先导出并记录可逆操作，按依赖顺序应用；生产变更前在暂存环境演练。序列化与 Remote Sync 不含用户、组、权限，Remote Sync 另不含表元数据、告警与订阅。嵌入 SDK、自定义可视化、Metabot 治理等属付费计划，具体版本与价格需查官方文档，资料未提供具体价格。