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