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 MCP 服务器进行身份验证之前，新工具在您的客户端中不可用。如果您想刷新可用的工具，请在您的 LLM 客户端中退出并重新登录 Qlik MCP 服务器。


类别	摘要	工具名称
App Discovery & Metadata	查找应用程序、探索结构、了解可用数据。	qlik_search qlik_describe_app qlik_get_fields qlik_list_sheets qlik_get_sheet_details
Bookmarks	查看、创建、更新和删除应用程序中的书签。	qlik_list_bookmarks qlik_create_bookmark qlik_select_bookmark qlik_delete_bookmark
Business Glossary	管理业务术语、定义、类别以及与数据资产的链接。	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 qlik_get_glossary_term_links qlik_create_glossary_term_links
Datasets & Data Quality	检查数据集、架构、概要文件、信任分数和质量指标。	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
Data Exploration & Analysis	查询数据、构建计算、探索字段值。	qlik_create_data_object qlik_get_field_values qlik_search_field_values qlik_get_chart_data qlik_get_chart_info
Data Products	创建、管理、激活和分发精选数据产品。	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
Knowledge bases	搜索知识库并使用其内容获取答案。	qlik_search_knowledgebase_chunks
Lineage	追踪数据来源和转换。	qlik_get_lineage
Master Items (Dimensions & Measures)	管理可重复使用的受管维度和度量。	qlik_list_dimensions qlik_create_dimension qlik_update_dimension qlik_delete_dimension qlik_list_measures qlik_create_measure qlik_update_measure qlik_delete_measure
Selections & Filtering	应用和管理影响所有可视化的筛选器。	qlik_select_values qlik_clear_selections qlik_get_current_selections
Visualization & Sheets	创建仪表板并添加图表、筛选器、KPI	qlik_create_sheet qlik_add_chart qlik_add_filter

每个工具可以实现的目标

App Discovery and Metadata

在构建图表或应用筛选器之前，使用这些工具查找合适的 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 并总结已有哪些图表以及还存在哪些差距。

Bookmarks

这组工具允许用户查看和应用应用程序中已添加书签的选择项。用户还可以根据当前选择项创建自己的书签，从而能够从其 LLM 客户端快速重新应用选择项。使用 Qlik MCP 工具创建的书签也可以被删除。

以下是可用的工具：

Qlik_list_bookmarks：列出应用程序中的所有书签。
Qlik_create_bookmark：使用当前选择项创建新书签。
Qlik_select_bookmark：选择一个书签。这将更改应用于数据模型的筛选器，并返回生成的选择项状态。
Qlik_delete_bookmark：删除书签。

信息注释
您只能删除使用 Qlik MCP 工具创建的书签。

提示示例：

“将当前选择项保存为 EMEA Q1 2026。”

Business Glossary

这组工具允许用户端到端地设置和维护受管业务术语表：

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

以下是可用的工具：

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 主条目。”

Datasets and Data Quality

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

以下是可用的工具：

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）进行健全性检查。运行数据集概要文件以发现缺失值和异常值，如果质量指标看起来陈旧，请触发数据质量计算并持续检查作业状态，直到其完成。最后，更新数据集描述以记录已知限制和推荐用途。”

Data Exploration & Analysis

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

以下是可用的工具：

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”。然后创建一个临时计算来比较北部地区与其他地区的月度环比收入和利润率，并突出显示哪些产品类别对这一变化贡献最大。”

Data Products

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

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

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

以下是可用的工具：

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 数据集。将数据产品移动 to 我们的共享“Analytics”空间，在其中激活它以获得更广泛的访问权限，如果我们稍后用新版本替换它，请停用旧版本。最后，如果该产品已完全退役且不再被引用，请将其删除。”

Knowledge bases

此工具允许您查找知识库并搜索其内容以获取答案。该工具允许您搜索特定知识库的内容。

以下是可用的工具：

Qlik_search_knowledgebase_chunks：在知识库的索引内容中进行搜索，并使用知识库内容接收答案。

提示示例：

“我正在准备与潜在客户的会议。查看我的客户信息、产品用例和竞争分析知识库，看看哪些用例最符合我客户的需求，同时展示我们如何超越竞争对手。”

Lineage

此工具允许用户通过检索数据集或应用程序的上游世系来追踪数据的来源和流向。因为每次调用只返回上一步，所以您通常需要递归重复它以构建完整的链。这适用于：

影响分析。
排查异常数字。
治理或审计。
识别为报告或数据集提供数据的真实源。

以下是可用的工具：

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

提示示例：

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

Master Items (Dimensions & Measures)

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

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

您只能更新和删除使用 Qlik MCP 工具创建的主条目。

以下是可用的工具：

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 %”。创建它们后，告诉我构建图表时应该引用的确切主条目名称，以便所有仪表板都使用相同的逻辑。”

Selections & Filtering

这些工具控制 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），最后清除所有选择项以将应用程序重置回未筛选状态。”

Visualization & Sheets

这些工具允许用户在 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 的筛选器面板，以便用户可以调整视图。确保视觉效果标题清晰，并且工作表已准备好供高管受众使用。”

本页面有帮助吗？

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

在此处留下您的反馈