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 分析应用程序，并在构建图表或应用筛选器之前快速了解其中的内容。此类别支持端到端的发现流程：在 Qlik 资源中搜索以定位相关的应用程序。

提供以下工具：

• Qlik_search：按名称或内容搜索 Qlik 资源（应用程序、数据集、数据产品、词汇表）。

• Qlik_describe_apps：获取应用程序的全面元数据，包括字段、所有者、发布状态。

• Qlik_get_fields：列出应用程序中可用作维度的所有数据字段。

• Qlik_list_sheets：列出应用程序中的所有工作表。

• Qlik_get_sheet_details：获取有关特定工作表的详细信息，包括所有图表及其类型。

• Qlik_search_spaces：根据查询字符串搜索空间。

提示示例：

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

• 使用 qlik_search 查找与“流失”或“客户保留”相关的应用程序。

• 为了获得最佳匹配，运行 qlik_describe_app 以确认它是正确的应用程序并查看其元数据（所有者和发布状态）。

• 使用 qlik_get_fields 列出可用字段并识别候选维度和度量，如 Customer、ChurnFlag、SubscriptionType、Region 和 ChurnDate。

• 使用 qlik_list_sheets 查看已存在哪些仪表板。

• 对于任何有希望的工作表（例如“流失概览”），调用 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：将术语链接到应用程序、数据集、字段、主条目

提示示例：

“帮我为我们的销售领域构建和管控业务词汇表。创建一个名为‘Sales Glossary’的词汇表，添加类别‘Revenue’、‘Customers’和‘Pipeline’。然后为‘Annual Recurring Revenue (ARR)’和‘Customer Churn’创建术语，并提供清晰的定义和标签（例如 finance 和 sales-ops），将它们设置为草稿，并将每个术语链接到相关的数据集字段和 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_get_dataset_quality_computation_status：检查质量计算的状态

提示示例：

“评估我们的 Customer Orders 数据集是否已准备好用于新仪表板。向我显示其元数据和当前信任分数，确认上次刷新时间，并列出它属于哪些数据产品。然后加载架构和 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：获取有关图表的元数据而不检索其数据

提示示例：

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

数据产品

这些工具将数据产品作为受管控的、可共享的数据集包来管理其整个生命周期：

1. 创建它。

2. 检查其元数据和文档。

3. 维护其定义（名称、描述以及它包含哪些数据集）

4. 通过在空间之间移动它并激活或停用它来控制它在何处以及是否可用。

它们还支持生命周期结束时的清理，在不再需要数据产品时将其删除。

提供以下工具：

• 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：删除数据产品

提示示例：

“创建一个名为‘Sales Analytics – Curated’的数据产品，并提供清晰的描述，包含以下数据集：Orders、Customers 和 Products。然后向我显示数据产品元数据并提取其 markdown 文档，以便我可以查看消费者将看到的内容。更新描述以添加使用指南，并添加 Returns 数据集。将数据产品移动到我们的共享‘Analytics’空间，在那里激活它以获得更广泛的访问权限，如果我们稍后用新版本替换它，请停用旧版本。最后，如果该产品已完全停用且不再被引用，请将其删除。”

世系

此工具允许用户通过检索数据集或应用程序的上游世系来追踪数据的来源和流动方式。由于每次调用仅返回后退一步，因此您通常会递归重复调用它以构建完整的链。这对于以下方面很有用：

• 影响分析。

• 排查意外数字。

• 管控或审计。

• 识别提供给报告或数据集的真实来源。

提供以下工具：

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

提示示例：

“向我显示 Customer Orders 数据集的完整上游世系。从数据集开始，递归向后追溯，直到到达原始源系统。对于每一步，总结直接父级是什么，并注意涉及的任何关键转换或中间数据集或应用程序。然后告诉我，如果发生更改，哪个上游源最有可能影响 net_amount 字段。”

主条目（维度和度量）

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

您可以使用新定义更新您的主条目，从而允许快速优化。您还可以删除主条目。例如，您可以要求您的 LLM 客户端清理应用程序中未使用的任何主条目。

提供以下工具：

• 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 应用程序中删除库度量

提示示例：

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

选择项和筛选

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

• 将选择项应用于一个或多个字段（使用精确值或模式谓词样式的匹配）。

• 检查当前激活了哪些筛选器。

• 全局或针对特定字段清除选择项。

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

提供以下工具：

• Qlik_select_values：将选择项（筛选器）应用于字段 - 支持精确值和模式匹配

  信息注释

  何时使用选择项而不是集合分析：

  • 当您想要为多个后续操作筛选整个应用程序或会话时，请使用 select_values()。

  • 当您需要对特定计算进行一次性筛选时，请在表达式中使用集合分析

  选择项在所有操作中持续存在，直到被清除，它们会影响所有后续的数据检索。作为最佳实践，对于单个分析查询，首选集合分析而不是选择项，以避免状态管理开销。

  警告注释

  • 首先使用 qlik_get_field_values() 或 qlik_search_field_values() 验证您要选择的值是否存在。选择不存在的值将静默失败。

  • 返回的选择项是实际当前应用的选择项，它们是真实的。任何选择失败的字段（例如：值不存在的字段）都不会出现在返回的列表中。

• Qlik_clear_selections：清除选择项 - 全部或特定字段

  警告注释返回的选择项是实际当前应用的选择项，它们是真实的。任何选择失败的字段（例如，值不存在）都不会出现在返回的列表中。

• Qlik_get_current_selections：获取应用程序中当前激活的选择项或筛选器

提示示例：

“为 Executive Sales 应用程序设置我的分析上下文：选择 Year = 2025 和 Region = EMEA，并对 Product Category 应用基于模式的选择项，以仅包含以‘Cloud’开头的类别。然后向我显示当前选择项，以便我可以确认激活了什么。在我查看 KPI 后，仅清除 Product Category 选择项（保留 Year 和 Region），最后清除所有选择项以将应用程序重置回未筛选状态。”

可视化和工作表

这些工具允许用户在 Qlik 应用程序中组装仪表板：

• 创建一个新工作表作为画布。

• 添加配置了维度、度量和显示选项的可视化（图表、表格、KPI）。

• 在工作表上放置筛选器面板，以便用户可以交互式地切片分析。

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

提供以下工具：

• Qlik_create_sheet：在应用程序中创建一个新的空工作表（仪表板）

• Qlik_add_chart：将可视化（条形、折线、饼图、表格、KPI 等）添加到工作表

  信息注释

  • 在进行工具调用之前规划您的查询结构。

  • 首先使用 qlik_search_field_values 或 qlik_get_field_values 测试日期值是否存在

  • 对于一次性查询，使用集合分析而不是应用程序级别的选择项

• Qlik_add_filter：将筛选器面板添加到工作表以进行用户驱动的筛选

提示示例：

“在我们的分析应用程序中创建一个名为‘Sales Overview’的新工作表。添加 Total Revenue 和 Total Orders 的 KPI，显示 Revenue by Month 的折线图，以及显示 Revenue by Region 的条形图（降序排列）。然后添加包含 Year、Region 和 Product Category 的筛选器面板，以便用户可以调整视图。确保视觉对象标题清晰，并且工作表已准备好供高管受众使用。”