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 取得譜系。根據您的權限，如果您無法使用Qlik Cloud中的功能或特性，某些工具可能會回應「無存取權限」。

工具可用性也可能受限於您的租用戶授權。

選取 Qlik MCP 工具

Qlik MCP 工具是專為 LLM 設計的動作目錄，LLM 可呼叫這些動作以在您的 Qlik Cloud 租用戶中執行動作。這些動作包括：

尋找應用程式和資料集
檢查欄位和圖中繼資料
套用和清除篩選條件
建立工作表和圖
管理受控管的資產，例如詞彙表詞彙和資料產品。

每個工具都代表具有定義完善的輸入和輸出的特定功能。

可用的 Qlik MCP 工具

下表顯示目前的 Qlik MCP 工具類別和工具名稱的概述。


類別	摘要	工具名稱
應用程式探索 & 中繼資料	尋找應用程式、探索結構、了解可用的資料。	qlik_search qlik_describe_app qlik_取得_欄位 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 尋找與「客戶流失」或「客戶保留」相關的應用程式。
為獲得最佳匹配，請執行 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：更新術語狀態（草稿、已驗證、已棄用）。只有管理員才能驗證術語。一旦術語經過驗證，只有管理員才能修改該術語
資訊備註
此操作有三種狀態：
- 草稿：術語處於草稿狀態。
- 已驗證: 該術語已由管理員驗證。
- 已淘汰: 該術語已淘汰，不應使用。
狀態名稱區分大小寫，且必須完全如上所示提供。
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：取得圖表的後設資料，而不擷取其資料

提示範例：

「協助我調查上個月北部地區營收下降的原因。首先，查看現有的「依地區劃分的營收」圖表：顯示其後設資料 (維度、量值、篩選器、列計數)，然後提取過去兩個月的圖表資料。在套用任何選取項目之前，列出「區域」的相異值，並搜尋欄位值以確認是否使用「North」、「NORTH」或「Northern」。然後建立一個臨時計算，以比較「北部」與其他區域的月度營收和利潤，並突顯哪些產品類別對此變化貢獻最大。”

資料產品

這些工具將資料產品作為受控管、可共用的資料集套件來管理其完整生命週期：

建立它。
檢查其詮釋資料和文件。
維護其定義 (名稱、描述以及其包含的資料集)
透過在空間之間移動並啟用或停用它來控制其可用位置和是否可用。

它們也支援在資料產品不再需要時將其刪除，以進行生命週期結束清理。

下列工具可用：

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 文件，以便我檢閱消費者將看到的內容。更新描述以新增使用指南，並同時新增退貨資料集。將資料產品移至我們的共用「分析」空間，在那裡啟用它以供更廣泛的存取，如果我們稍後用新版本取代它，則停用舊版本。最後，如果產品已完全淘汰且不再被參考，請將其刪除。」

譜系

此工具可讓使用者透過擷取資料集或應用程式的上游譜系，追蹤資料來源及其流動方式。由於每個呼叫只會傳回一個步驟，因此您通常會遞迴重複執行以建立完整的鏈結。這對於以下情況很有用：

影響分析。
疑難排解非預期的數字。
治理或稽核。
識別饋送報表或資料集的真正來源。

下列工具可用：

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、顯示依月份劃分收入的折線圖，以及顯示依地區劃分收入的長條圖 (依降冪排序)。然後新增一個包含年份、地區和產品類別的篩選面板，以便使用者可以調整檢視。確保視覺效果標題清晰，且工作表已準備好供高階主管檢閱。」

此頁面是否對您有幫助？

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們！

在此留下意見回饋