GuanCLI and GuanMCP Comparison

Last updated: 2026-08-27 11:15:30

Who Should Read This Chapter

This chapter helps BI users, data analysts, IT administrators, and AI platform owners decide whether to use GuanCLI or GuanMCP first when an enterprise wants AI to use Guandata BI capabilities.

If you are not sure about the difference, remember this:

GuanCLI is a BI toolbox for AI Agents and technical users. GuanMCP is a connector that gives MCP-compatible AI clients read-only BI query capabilities.

Core Differences

Both GuanCLI and GuanMCP let AI use Guandata BI capabilities, but their positioning and boundaries are different.

• GuanCLI is a BI toolbox for AI Agents and technical users. It requires an environment that can install and run local commands, but it has a complete Skill ecosystem and supports resource search, data query, metric query, dashboard creation, ETL creation, and more. It also supports a broader range of BI versions.
• GuanMCP is a BI connector for MCP-compatible AI clients and enterprise AI assistants. It supports individual access with PAT and centralized enterprise access. It focuses on read-only resource, data, and metric queries.

Simple decision rules:

• Choose GuanCLI to create, modify, or publish BI resources or use the complete Skill ecosystem.
• Choose GuanMCP for read-only BI queries from MCP clients or enterprise AI assistants.
• They can be used together: GuanCLI supports analysis, delivery, O&M automation, and resource construction; GuanMCP supports read-only BI queries inside existing AI assistants.

Relationship with Guandata BI

GuanCLI and GuanMCP do not build a new data system. They reuse existing Guandata BI assets and permission systems:

• Data assets: datasets, metrics, metric trees, dashboards, cards, ETL, ChatBI topics, and more.
• Permission system: user identity, organization permissions, workspace permissions, data permissions, and resource access permissions.
• Management capabilities: resource catalogs, task status, operation records, and security audit.

The clearer the BI assets, metric definitions, and permissions are, the better AI can use BI. Before integration, sort out pilot departments, core metrics, common dashboards, and test-account permissions.

Use Case Comparison

Item	GuanCLI	GuanMCP
Primary positioning	BI toolbox for AI Agents or technical teams	BI query connector for enterprise AI assistants
Entry point	Terminal, scripts, local Agent, delivery environment	MCP clients and enterprise-built assistants
Typical users	AI engineers, implementation, O&M, solution teams	Data analysts, business users, and enterprise AI platform users
Integration method	Run local commands	Local MCP or remote Streamable HTTP
Parameter expression	Command parameters, script parameters, organized by Agent	Schema-based parameters validated and orchestrated by the platform
Common tasks	Search resources, query data and metrics, troubleshoot, manage forms, build dashboards, build ETL	Read-only operations such as resource, data, and metric queries
Resource writes	Suitable for some creation, modification, and publishing tasks	Not used for resource creation, modification, saving, or publishing
Runtime dependency	Requires a local or server environment that can install and run CLI	Runs a local MCP server or uses a remote administrator-provided service
BI version coverage	Broader coverage and recommended as the default option	Constrained by MCP Server capabilities and target BI version

Capability Boundaries

What GuanCLI Is Better For

GuanCLI is suitable when the task needs to work with BI assets directly:

• Query BI resources, datasets, pages, cards, and task status.
• Preview data, troubleshoot data lineage, and locate exceptions.
• Let Agents call BI APIs through Skills.
• Operate form-entry data.
• Call ChatBI.
• Generate dashboards with GuanVis.
• Modify or debug ETL, pages, and other resources.

For delivery, implementation, or O&M automation in a controlled environment, GuanCLI is usually more direct.

What GuanMCP Is Better For

GuanMCP is suitable for registering BI query capabilities into enterprise AI platforms:

• Let business users query BI data in existing AI assistants.
• Search cards, dashboards, datasets, and ETL assets.
• Read dataset fields, card sources, and dashboard structures.
• Query metric definitions, metric data, and metric-tree attribution results.
• Call ChatBI-style Q&A capabilities.
• Return BI results according to the current user's permissions.

GuanMCP currently focuses on read-only query capabilities. It does not create, edit, save, or publish BI resources, and it does not bypass Guandata BI permissions.

How to Choose

Customer Need	Recommended Option	Reason
Create, modify, or publish BI resources, or use the complete Skill ecosystem	GuanCLI	Supports resource development, troubleshooting, and automation.
Query BI from an MCP client such as Cursor using a personal account	GuanMCP + PAT	Uses personal permissions with independently managed configuration and revocation.
Ask business data questions in an enterprise AI assistant that cannot install or call GuanCLI	GuanMCP	Provides a read-only BI connector through MCP.
AI helps implementation users troubleshoot datasets, pages, ETL, or tasks	GuanCLI	Local commands and Skills better support controlled troubleshooting.
AI automatically drafts dashboards	GuanCLI + GuanVis	This requires reading dataset structure and publishing pages, which is resource generation.
The enterprise has a unified AI platform and wants BI as a query tool, but cannot install or call GuanCLI	GuanMCP	MCP provides schema-based query tools for platform orchestration.
Query BI locally without an enterprise AI assistant	GuanMCP + PAT or GuanCLI	Use GuanMCP for read-only queries and GuanCLI when more operations are needed.
Existing BI assets and AI assistant are both available, and business users need low-cost Q&A but cannot run GuanCLI	GuanMCP	Reuses BI data, metrics, pages, and permissions for read-only connection.
Batch manage, migrate, or modify BI assets	GuanCLI or BI product UI	GuanMCP is not a resource management entry.

Reading Guide by Role

Role	Start With	Focus
Business analyst	GuanMCP Integration and User Guide	What can be asked, where answers come from, and how permissions work.
MCP client user	GuanMCP Integration and User Guide	Choose centralized or individual access, configure it, and troubleshoot.
Enterprise AI platform administrator	Custom Enterprise MCP Integration Guide	Register services, map users, and validate permissions.
Data analyst / implementation consultant	GuanCLI User Guide	Query resources, preview data, troubleshoot tasks, and call ChatBI.
BI developer	GuanVis User Guide, GuanETL User Guide	Generate dashboards, modify ETL, check results, and confirm before saving.

Recommended Combination

In mature environments, GuanCLI and GuanMCP can be used together.

GuanMCP serves the business side by connecting trusted BI query capabilities to existing AI assistants. Business users keep asking questions from their usual work entry, while answers still come from BI and BI permissions still apply.

GuanCLI serves the construction side by helping implementation, O&M, and technical teams analyze, troubleshoot, generate, and configure resources. It is suitable for test environments, delivery environments, and controlled automation workflows.

Pilot Suggestions

For first integration, start with a clearly scoped business subject such as sales operations, store operations, or financial analysis:

1. Select a group of datasets, metrics, and dashboards that are already used stably in BI.
2. Prepare three test accounts with high, normal, and low permissions.
3. Use GuanCLI to check whether resources are searchable and whether field and metric definitions are clear.
4. Connect GuanMCP to the AI assistant and verify whether business users can ask correct questions in the original entry.
5. Validate permissions, definitions, returned content, and audit records before expanding to more departments.