GuanCLI 与 GuanMCP 对比
本章适合谁阅读
本章帮助 BI 使用者、数据分析师、IT 管理员和 AI 平台负责人判断：当企业希望 AI 使用观远 BI 能力时，应该优先接入 GuanCLI 还是 GuanMCP。
如果你还不确定两者差异，可以先记住一句话：
GuanCLI 是给 AI Agent 和技术人员使用的 BI 工具箱；GuanMCP 是把 BI 查询能力接入企业已有 AI 助手的 BI 连接器。
核心区别
GuanCLI 和 GuanMCP 都能让 AI 使用观远 BI 能力，但它们的定位和能力边界不同。
- GuanCLI 是给 AI Agent 和技术人员使用的 BI 工具箱。它对执行环境要求更高，需要支持安装和运行本地命令，但有完整的 Skill 生态，查资源、查数据、查指标、建看板、建 ETL 等任务全部支持，适配的 BI 版本也更完整。
- GuanMCP 是面向企业 AI 助手的 BI 连接器。它把观远 BI 的查询能力封装为标准 MCP 工具，定位是让已有 AI 助手连接 BI，只支持查资源、查数据、查指标等查询类操作，不作为资源创建、修改和发布入口。
简单判断：
- 如果环境支持安装和运行 GuanCLI，始终优先推荐 GuanCLI。
- 只有在企业 AI 助手无法安装或调用 GuanCLI，只能通过 MCP 接入外部工具时，才推荐 GuanMCP。
- 两者可以同时使用：GuanCLI 服务分析、交付、运维自动化和资源建设，GuanMCP 服务已有 AI 助手中的查询类 BI 连接。
和观远 BI 的关系
GuanCLI 和 GuanMCP 都不是重新建设一套数据系统，而是复用观远 BI 已有的数据资产与权限体系：
- 数据资产：数据集、指标、指标树、仪表板、卡片、ETL、ChatBI 主题等。
- 权限体系：用户身份、组织权限、空间权限、数据权限和资源访问权限。
- 管理能力：资源目录、任务运行状态、操作记录和安全审计。
因此，BI 资产越清晰、指标口径越规范、权限配置越完整，AI 使用 BI 的效果越好。接入前建议先梳理试点部门、核心指标、常用看板和测试账号权限。
适用场景对比
| 判断项 | GuanCLI | GuanMCP |
|---|---|---|
| 主要定位 | 给 AI Agent 或技术团队使用的 BI 工具箱 | 接入企业 AI 助手的 BI 查询连接器 |
| 使用入口 | 终端、脚本、本地 Agent、交付环境 | 飞书 Aily、Decidex、企业自研 AI 助手等平台 |
| 典型用户 | AI 工程师、实施、运维、解决方案团队 | 一线业务人员、企业 AI 平台用户 |
| 接入方式 | 执行本地命令 | 通过 MCP Tool 或 HTTP 调用 |
| 参数表达 | 命令参数、脚本参数、Agent 自行组织 | Schema 化参数，由平台校验和编排 |
| 常见任务 | 查资源、查数据、查指标、排查问题、操作表单、建看板、建 ETL | 查资源、查数据、查指标等查询类操作 |
| 是否适合资源写入 | 适合部分资源创建、修改和发布 | 不作为资源创建、修改、保存和发布入口 |
| 部署依赖 | 需要可安装、可执行 CLI 的本地或服务端环境 | 需要 MCP Server 或 HTTP 服务接入 AI 平台 |
| BI 版本适配 | 适配版本更完整，适合作为优先方案 | 受 MCP Server 能力和目标 BI 版本约束 |
能力边界
GuanCLI 更适合做什么
GuanCLI 适合需要“动手处理 BI 资产”的场景：
- 查询 BI 资源、数据集、页面、卡片和任务状态
- 预览数据、排查数据链路和定位异常
- 配合 Skill 让 Agent 调用 BI API
- 操作表单填报数据
- 调用 ChatBI 问数
- 配合 GuanVis 生成仪表板
- 修改或调试 ETL、页面等资源
当任务需要在交付、实施或运维环境中自动化执行，GuanCLI 通常更直接。
GuanMCP 更适合做什么
GuanMCP 适合把 BI 查询能力注册到企业 AI 平台：
- 让业务人员在已有 AI 助手中查询 BI 数据
- 搜索卡片、仪表板、数据集和 ETL 资产
- 读取数据集字段、卡片来源和仪表板结构
- 查询指标口径、指标数据和指标树归因结果
- 调用 ChatBI 问数类能力
- 按当前用户权限返回 BI 结果
GuanMCP 当前聚焦只读查询能力。它不创建、编辑、保存或发布 BI 资源，也不绕过 GuanBI 权限。
怎么选
| 客户需求 | 推荐方案 | 原因 |
|---|---|---|
| 环境支持安装和运行 GuanCLI | GuanCLI | 能力更完整，支持 Skill 生态和更多 BI 版本，作为默认优先方案 |
| 在飞书 Aily 或企业 AI 助手里直接问经营数据，且无法安装或调用 GuanCLI | GuanMCP | 只能通过 MCP 接入外部工具时，GuanMCP 可作为查询类 BI 连接器 |
| 让 AI 帮实施人员排查数据集、页面、ETL 或任务问题 | GuanCLI | 本地命令和 Skill 更适合受控排查流程 |
| 让 AI 自动生成看板初稿 | GuanCLI + GuanVis | 需要读取数据集结构并发布页面，属于资源生成场景 |
| 企业已有统一 AI 平台，希望把 BI 作为一个查询工具接入，且无法安装或调用 GuanCLI | GuanMCP | MCP 提供 Schema 化查询工具，便于平台编排 |
| 客户没有 AI 助手，只想先让 AI 工具访问 BI | GuanCLI | CLI 更容易从本地环境开始验证 |
| 客户已有 BI 资产，也已有 AI 助手，希望业务人员低成本问数，但不具备 GuanCLI 运行条件 | GuanMCP | 复用已有 BI 数据、指标、页面和权限做查询类连接 |
| 需要批量管理、迁移或修改 BI 资产 | GuanCLI 或 BI 产品界面 | GuanMCP 不作为资源管理入口 |
不同角色怎么读
| 角色 | 建议先看 | 关注重点 |
|---|---|---|
| 业务分析师 | GuanMCP 使用指南 | 能在 AI 助手里问什么、答案来自哪里、权限如何生效 |
| IT 管理员 / 平台管理员 | GuanMCP 部署指南 | 服务部署、入口鉴权、用户身份传递、权限验收 |
| 数据分析师 / 实施顾问 | GuanCLI 使用指南 | 查询资源、预览数据、排查任务、调用 ChatBI |
| BI 开发人员 | GuanVis 使用指南、GuanETL 使用指南 | 生成看板、修改 ETL、检查结果、保存前确认 |
推荐组合
在成熟环境中，GuanCLI 和 GuanMCP 可以共同使用。
GuanMCP 面向业务侧，把观远 BI 的可信查询能力接入已有 AI 助手。业务人员继续在原工作入口提问，答案来自 BI，权限仍按 BI 原规则生效。
GuanCLI 面向建设侧，帮助实施、运维和技术团队完成分析、排查、生成和配置工作。它适合在测试环境、交付环境和受控自动化流程中使用。
试点建议
首次接入建议从一个边界清晰的业务主题开始，例如销售经营、门店运营或财务分析：
- 选择一组已在 BI 中稳定使用的数据集、指标和看板。
- 准备高权限、普通权限、低权限三个测试账号。
- 先用 GuanCLI 检查资源是否可搜索、字段和指标口径是否清楚。
- 再用 GuanMCP 接入 AI 助手，验证业务用户能否在原入口中问到正确结果。
- 对权限、口径、返回内容和审计记录做验收后，再扩大到更多部门。