Qlik MCP 工具

Qlik MCP 服务器包含工具，可让您的 LLM 在您的 Qlik Cloud 租户中为您执行操作。您可以通过选择要提供的 Qlik MCP 工具来自定义您的体验。

访问权限和 Qlik MCP 工具

对 MCP 工具的访问由您的权限控制。您需要在自定义角色中拥有 Qlik MCP：允许权限，才能从您的 LLM 客户端访问 Qlik MCP 工具。

此外，由于 Qlik MCP 工具被授权为连接用户，它会使用您现有的用户角色和空间权限。您还需要在 Qlik Cloud 中拥有权限，才能使用工具所使用的功能或内容类型。例如，如果您没有在 Qlik Cloud 中访问世系的权限，您就无法使用 Qlik MCP 工具 Qlik get lineage。根据您的权限，如果您无法在 Qlik Cloud 中使用该功能或特性，某些工具可能会响应“无访问权限”。

工具的可用性也可能受限于您的租户的许可。

选择 Qlik MCP 工具

Qlik MCP 工具是一个专门构建的操作目录，LLM 可以调用这些操作在您的 Qlik Cloud 租户中执行操作。这些操作包括：

查找应用程序和数据集
检查字段和图表元数据
应用和清除筛选器
创建工作表和图表
管理受管资产，例如词汇表术语和数据产品。

每个工具都代表一种具有明确输入和输出的特定功能。

可用 Qlik MCP 工具

下表显示了当前 Qlik MCP 工具类别和工具名称的概览。


分类	汇总	工具名称
应用程序发现 & 元数据	查找应用程序，探索结构，了解可用数据。	qlik_search qlik_describe_app qlik_get_fields qlik_list_sheets qlik_get_sheet_details qlik_search_spaces qlik_semantic_search_app
商业术语表	管理业务术语、定义、类别以及与数据资产的关联。	qlik_create_glossary qlik_get_full_glossary_export qlik_get_glossary_categories qlik_create_glossary_category qlik_search_glossary_terms qlik_get_glossary_term qlik_create_glossary_term qlik_update_glossary_term qlik_update_glossary_term qlik_delete_glossary_term qlik_update_term_status qlik_get_glossary_term_links qlik_create_glossary_term_links
数据集 & 数据质量	检查数据集、架构、配置文件、信任分数和质量指标。	qlik_get_dataset qlik_get_dataset_schema qlik_get_dataset_profile qlik_get_dataset_sample qlik_get_dataset_freshness qlik_get_dataset_trust_score qlik_get_dataset_memberships qlik_update_dataset_metadata qlik_update_dataset_quality qlik_get_dataset_quality_computation_status
数据探索 & 分析	查询数据、构建计算、探索字段值。	qlik_create_data_object qlik_get_field_values qlik_search_field_values qlik_get_chart_data qlik_get_chart_info
数据产品	创建、管理、激活和分发精选数据产品。	qlik_create_data_product qlik_get_data_product qlik_get_data_product_documentation qlik_update_data_product qlik_update_data_product_space qlik_update_activate_data_product qlik_update_deactivate_data_product qlik_delete_data_product
世系	追踪数据来源和转换。	qlik_get_lineage
主项目（维度 & 度量）	管理可重用的受管维度和度量。	qlik_list_dimensions qlik_create_dimension qlik_update_dimension qlik_delete_dimension qlik_list_measures qlik_create_measure qlik_update_measure qlik_delete_measure
选择与筛选	应用和管理影响所有可视化项的筛选器。	qlik_select_values qlik_clear_selections qlik_get_current_selections qlik_update_filter
可视化 & 工作表	创建仪表板并添加图表、筛选器、KPI	qlik_create_sheet qlik_add_chart qlik_add_filter qlik_delete_object qlik_show_chart qlik_update_chart

这些工具各自能完成什么

应用程序发现和元数据

使用这些工具来查找正确的 Qlik 分析应用程序，并在构建图表或应用筛选器之前快速了解其内容。此类别支持端到端发现流程：搜索 Qlik 资源以查找相关应用程序。

以下工具可用：

Qlik_search：按名称或内容搜索Qlik资源（应用程序、数据集、数据产品、词汇表）。
Qlik_describe_apps：获取应用程序的综合元数据，包括字段、所有者、发布状态。
Qlik_get_fields：列出应用程序中所有可用的数据字段，用作维度。
Qlik_list_sheets：列出应用程序中的所有工作表。
Qlik_get_sheet_details: 获取特定工作表的详细信息，包括所有图表及其类型。
Qlik_search_spaces: 根据查询字符串搜索空间。
Qlik_semantic_search_app: 在 Qlik 应用程序中对相关资产执行语义搜索。

提示示例：

"我需要分析客户流失。" 这个简单的提示允许：

使用 qlik_search 查找与“churn”或“customer retention”相关的应用程序。
为获得最佳匹配，运行 qlik_describe_app 以确认它是正确的应用程序并查看其元数据（所有者和发布状态）。
使用 qlik_get_fields 列出可用字段，并识别候选维度和度量，例如 Customer、ChurnFlag、SubscriptionType、Region 和 ChurnDate。
使用 qlik_list_sheets 查看已存在哪些仪表板。
对于任何有前景的工作表，例如“Churn Overview”，调用 qlik_get_sheet_details 并总结已有哪些图表以及还存在哪些差距。

商业术语表

这套工具让用户能够端到端地设置和维护受管的商业术语表：

创建术语表
按类别组织
添加和管理术语（包括编辑、删除和管理生命周期状态，例如草稿-已验证-已弃用）
将这些术语连接到真实的分析资产（应用程序、数据集、字段、主条目）。

提供以下工具：

Qlik_create_glossary：创建新的业务词汇表
Qlik_get_full_glossary_export：获取包含所有术语、类别、链接的完整词汇表（开销大的操作）
Qlik_get_glossary_categories：检索词汇表的所有类别
Qlik_create_glossary_category：在词汇表中创建新类别
Qlik_search_glossary_terms：在词汇表中搜索术语
Qlik_get_glossary_term：从词汇表中获取特定术语
Qlik_create_glossary_term：创建新的词汇表术语，包含描述、标签和关系
Qlik_update_glossary_term：修改现有词汇表术语
Qlik_delete_glossary_term：删除词汇表术语
Qlik_update_term_status：更新术语状态（草稿、已验证、已弃用）。只有管理员才能验证术语。一旦术语被验证，只有管理员才能修改该术语
信息注释
此操作有三种状态：
- draft：该术语处于草稿状态。
- verified: 该术语已由管理员验证。
- deprecated: 该术语已弃用，不应使用。
状态名称区分大小写，必须与上述内容完全一致。
Qlik_get_glossary_term_links: 获取链接到词汇表术语的资源

此函数支持两种模式：
- 单链接模式：为实例 resource_id 或 resource_type 提供单独的参数。
- 批量模式：通过“links”参数提供链接字典列表
信息注释
链接到子资源时，每个链接必须同时提供所有三个子资源字段（subResourceId、subResourceName 和 subResourceType）。
Qlik_create_glossary_term_links：将术语链接到应用程序、数据集、字段、主条目

提示示例：

帮助我为我们的销售领域构建和管理业务词汇表。创建一个名为“销售词汇表”的词汇表，添加“收入”、“客户”和“销售渠道”类别。然后创建“年度经常性收入 (ARR)”和“客户流失”的术语，并附带清除定义和标签（例如财务和销售运营），将其设置为草稿，并将每个术语链接到相关数据集字段和 KPI 主条目。

数据集和数据质量

这些工具通过检查数据集是什么（元数据和数据产品成员资格）、它包含什么（架构）、数据是什么样子（分析统计数据分布和快速行样本）来帮助用户理解、验证和管理数据集。这些工具还支持管理工作流：改进数据集文档（名称-描述），以及触发和监控数据质量计算，以随时间刷新质量指标。

提供以下工具：

Qlik_get_dataset：加载数据集的元数据，包括信任分数
Qlik_get_dataset_schema：加载数据集的架构（列定义）
Qlik_get_dataset_profile：加载数据集的配置文件数据（统计信息、分布）
Qlik_get_dataset_sample：加载数据集的前 10 行以供预览
Qlik_get_dataset_freshness：获取数据集的上次更新时间戳
Qlik_get_dataset_trust_score：获取数据集的信任分数
Qlik_get_dataset_memberships：获取数据集的数据产品成员资格
Qlik_update_dataset_metadata：更新数据集的名称和描述
Qlik_update_dataset_quality：请求对数据集进行数据质量计算
Qlik_update_dataset_quality：请求对数据集进行数据质量计算
Qlik_get_dataset_quality_computation_status：检查质量计算的状态

提示示例：

“评估我们的客户订单数据集是否已准备好用于新仪表板。显示其元数据和当前信任分数，确认上次刷新时间，并列出它所属的数据产品。然后加载架构和 10 行样本，以健全性检查 order_date、customer_id 和 net_amount 等关键字段。运行数据集配置文件以发现缺失值和异常值，如果质量指标看起来过时，则触发数据质量计算并持续检查作业状态直到完成。最后，更新数据集描述以记录已知约束和推荐用途。”

数据探索与分析

这些工具支持对数据和现有分析内容进行快速且临时的调查，而无需用户永久构建新的可视化。您可以创建临时计算或查询对象以回答“假设”问题，通过列出不同的值来检查字段，或搜索特定值。

以下工具可用：

Qlik_create_data_object：创建用于临时分析查询的临时计算对象

信息注释
在应用选择之前，使用 get_field_values() 或 search_field_values() 来验证值是否存在。
警告注释
Qlik 执行所有计算，因此：
- 切勿对返回的数据进行聚合、求和、平均或计算：值是最终的。
- 对于不同的计算，请使用新表达式再次调用工具。
- 始终应用适当的筛选器选择以限制数据大小并提高性能。
Qlik_get_field_values：获取特定字段的非重复值（在筛选前使用）

信息注释
对于高基数字段，请始终使用 qlik_search_field_values()。

警告注释
在创建选择筛选器之前，请使用此工具或 qlik_search_field_values() 来验证值是否存在。这有助于避免在应用包含不存在值的筛选器时出现错误。
Qlik_search_field_values：搜索跨字段的特定值（在集合分析之前验证）
警告注释
在使用集合分析或选择创建数据对象之前：使用 qlik_search_field_values 来验证值是否存在。这可以防止因不存在的筛选值而导致的错误，对于年份、日期、货币代码、产品名称尤其重要。

最佳实践示例工作流：
1. qlik_search_field_values(fieldName="payment_year", searchTerms=["2022"])
2. 验证“2022”存在于结果中
3. 使用 {payment_year={2022} 创建数据对象。
Qlik_get_chart_data：从现有图表可视化中检索分页数据
Qlik_get_chart_info：获取图表的元数据，而不检索其数据

提示示例：

“帮我调查上个月北部地区收入下降的原因。首先，查看现有的“按区域划分的收入”图表：显示其元数据（维度、度量、筛选器、行数），然后提取过去两个月的图表数据。在应用任何选择之前，列出 Region 的不同值，并搜索字段值以确认是否使用了‘North’、‘NORTH’或‘Northern’。然后创建一个临时计算，以比较 North 与其他区域的月度收入和利润，并突出显示哪些产品类别对变化贡献最大。”

数据产品

这些工具管理数据产品的完整生命周期，作为受管的、可共享的数据集包：

创建它。
检查其元数据和文档。
维护其定义（名称、描述以及包含的数据集）
通过在空间之间移动并激活或停用它来控制其可用位置和是否可用。

当数据产品不再需要时，它们还通过删除数据产品来支持生命周期结束清理。

以下工具可用：

Qlik_create_data_product：创建新的数据产品
Qlik_get_data_product：获取特定数据产品的元数据
Qlik_get_data_product_documentation：获取数据产品的 Markdown 文档
Qlik_update_data_product：更新数据产品的属性（名称、描述、数据集）
Qlik_update_data_product_space：将数据产品移动到其他空间
Qlik_update_activate_data_product：在特定空间中激活数据产品
Qlik_update_deactivate_data_product：停用数据产品
Qlik_delete_data_product：删除数据产品

提示示例：

“创建一个名为“销售分析 – 精选”的数据产品，附带清除描述，并包含以下数据集：订单、客户和产品。然后向我展示数据产品元数据，并拉取其 Markdown 文档，以便我查看消费者将看到的内容。更新描述以添加使用指南，并添加 Returns 数据集。将数据产品移动到我们的共享“分析”空间，在那里激活它以获得更广泛的访问权限，如果我们以后用新版本替换它，则停用旧版本。最后，如果产品完全停用且不再被引用，请将其删除。”

世系

此工具允许用户通过检索数据集或应用程序的上游世系来追溯数据来源和数据流向。由于每次调用只返回一步，因此通常需要递归重复此操作以构建完整的链条。这对于以下方面很有用：

影响分析。
排查意外数字。
治理或审计。
识别为报表或数据集提供数据的真实来源。

以下工具可用：

Qlik_get_lineage：加载数据集或应用程序的世系历史记录（递归调用以获取完整链）

提示示例：

“显示客户订单数据集的完整上游世系。从数据集开始，并递归地回溯，直到您到达原始源系统。对于每个步骤，总结其直接父级是什么，并注明涉及的任何关键转换、中间数据集或应用程序。然后告诉我，如果 net_amount 字段发生变化，哪个上游数据流最有可能影响它。”

主项（维度与度量）

这些工具通过处理主（库）维度和度量，帮助用户在应用程序中标准化和重用关键业务逻辑。您可以清点现有内容（以避免复制并鼓励一致性），并且可以创建新的可重用维度和度量，以便多个工作表中的图表使用相同的字段定义和计算表达式，从而改进治理、可维护性和指标对齐。

以下工具可用：

Qlik_list_dimensionst：列出应用程序中所有可用的库维度
Qlik_create_dimension：创建一个可重用的库维度
Qlik_update_dimension：更新Qlik应用程序中一个现有的库维度
Qlik_delete_dimension：从Qlik应用程序中删除一个库维度
Qlik_list_measures：列出应用程序中所有可用的库度量
Qlik_create_measure：创建带表达式的可重用库度量
Qlik_update_measure：更新 Qlik 应用程序中的现有库度量
Qlik_delete_measure：从 Qlik 应用程序中删除库度量

提示示例：

“帮我标准化销售绩效应用程序中的指标。首先，列出现有的库维度和度量，这样我们就不会复制任何内容。然后根据适当的细分字段创建一个新的库维度“客户细分”，并使用我们的标准定义（毛利润除以收入，格式化为百分比）创建一个可重用的度量“毛利率 %”。创建它们之后，请告诉我构建图表时应引用的确切主条目名称，以便所有仪表板都使用相同的逻辑。”

选择与筛选

这些工具控制 Qlik 应用程序的交互式筛选状态：

应用选择到一个或多个字段（使用精确值或模式谓词式匹配）。
检查当前有哪些过滤器处于激活状态。
清除全局或针对特定字段的选择。

它们共同支持引导式分析流程和可重现的调查步骤。

以下工具可用：

Qlik_select_values：将选择（筛选器）应用于字段 - 支持精确值和模式匹配
信息注释
何时使用选择而非集合分析：
- 当您想要为多个后续操作筛选整个应用程序或会话时，请使用select_values()。
- 当您需要针对特定计算进行一次性筛选时，请在表达式中使用集合分析
选择在所有操作中持续存在，直到清除为止，它们会影响所有后续数据检索。作为最佳实践，对于单个分析查询，优先使用集合分析而非选择，以避免状态管理开销。
警告注释
- 首先使用 qlik_get_field_values() 或 qlik_search_field_values() 以验证您要选择的值是否存在。选择不存在的值将静默失败。
- 返回的选择是实际当前应用的选定项，是真实的。任何选择失败的字段，例如：值不存在的字段，将不会出现在返回列表中。
Qlik_clear_selections: 清除选择 - 全部或特定字段

警告注释返回的选择是实际当前已应用的选择，它们是真实情况。任何选择失败的字段（例如，值不存在）都不会出现在返回列表中。
Qlik_get_current_selections: 获取应用程序中当前激活的选择或筛选器
Qlik_update_filter: 更新 Qlik 应用程序中现有的筛选器面板

提示示例：

“为执行销售应用程序设置我的分析上下文：选择年份 = 2025 和区域 = EMEA，并对产品类别应用基于模式的选择，以仅包含以“Cloud”开头的类别。然后向我显示当前选择，以便我确认哪些是激活的。在我查看 KPI 后，仅清除产品类别选择（保留年份和区域），最后清除所有选择，以将应用程序重置回未筛选状态。”

可视化 & 工作表

这些工具让用户可以在 Qlik 应用程序中组装仪表板：

创建新的工作表作为画布。
添加可视化（图表、表格、KPI），并使用维度、度量和显示选项进行配置。
将筛选器窗格放置在工作表上，以便用户可以交互式地切片分析。

它们共同涵盖了构建可用自助服务仪表板页面的基本工作流程。

以下工具可用：

Qlik_create_sheet：在应用程序中创建新的空工作表（仪表板）
Qlik_add_chart：向工作表添加可视化（条形图、折线图、饼图、表格、KPI 等）
信息注释
- 在进行工具调用之前，请规划您的查询结构。
- 首先使用 qlik_search_field_values 或 qlik_get_field_values 测试日期值是否存在
- 对应用程序级选择使用集合分析进行一次性查询
Qlik_add_filter：向工作表添加筛选器窗格以进行用户驱动的筛选
Qlik_delete_object：从 Qlik 应用程序中删除对象（图表、工作表、筛选器等）
Qlik_show_chart：将渲染的可视化显示为 Qlik 快照
Qlik_update_chart：更新 Qlik 应用程序中现有的图表可视化

提示示例：

“在我们的分析应用程序中创建一个名为“销售概览”的新工作表。添加一个用于总收入和总订单的KPI，一个显示按月收入的折线图，以及一个显示按区域收入的条形图（按降序排序）。然后添加一个包含年份、区域和产品类别的筛选器窗格，以便用户可以调整视图。确保可视化效果标题清晰，并且工作表已准备好供高管受众使用。”

本页面有帮助吗？

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们！

在此处留下您的反馈