Qlik MCP 工具

上次更新：2026/9/30

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分析應用程式，並在建立圖或套用篩選器之前快速了解其內容。此類別支援端對端探索流程：搜尋 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：更新術語狀態（草稿、已驗證、已棄用）。只有管理員才能驗證術語。一旦術語經過驗證，只有管理員才能修改該術語

  資訊備註

  此操作有三種狀態：

  • 草稿：術語處於草稿狀態。

  • 已驗證: 該術語已由管理員驗證。

  • 已淘汰: 該術語已淘汰，不應使用。

  狀態名稱區分大小寫，且必須完全如上所示提供。

• 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_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」。然後建立一個臨時計算，用於比較北部地區與其他地區的月度營收和利潤，並突顯哪些產品類別對此變化貢獻最大。”

資料產品

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

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：刪除資料產品

提示範例：

建立一個名為「銷售分析 – 精選」的資料產品，附帶清除的描述，並包含這些資料集：訂單、客戶和產品。然後給我看資料產品的中繼資料，並提取其 Markdown 文件，以便我能審閱消費者將會看到什麼。更新描述以新增使用指南，並新增退貨資料集。將資料產品移至我們的共用「分析」空間，在該處啟用以供更廣泛存取，如果我們稍後以新版本取代它，則停用舊版本。最後，如果產品已完全停用且不再被引用，請將其刪除。”

血統

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

• 影響分析。

• 疑難排解非預期的數字。

• 治理或稽核。

• 識別饋送報表或資料集的真正來源。

以下工具可用：

• Qlik_get_lineage：載入資料集或應用程式的譜系歷史記錄 (遞迴呼叫以取得完整鏈結)

提示範例：

顯示客戶訂單資料集的完整上游譜系。從資料集開始，並遞迴地回溯，直到您到達原始來源系統。對於每個步驟，總結其直接父項是什麼，並註明任何關鍵轉換或涉及的中間資料集或應用程式。那麼請告訴我，如果發生變更，哪個上游來源最有可能影響 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 應用程式刪除物件庫量值

提示範例：

協助我標準化我們銷售績效應用程式中的指標。首先，列出既有的物件庫維度與量值，以免我們重複複製任何項目。然後建立一個新的物件庫維度「客戶區隔」，根據適當的區隔欄位，並建立一個可重複使用的量值「毛利率 %」，使用我們的標準定義（毛利除以營收，格式化為百分比）。建立它們之後，請告訴我確切的主項目名稱，我應該在建立圖表時參考這些名稱，以便所有儀表板都使用相同的邏輯。

選取與篩選

這些工具可控制 Qlik 應用程式的互動式篩選狀態：

• 將選取項目套用到一或多個欄位 (使用精確值或樣式述詞樣式比對)。

• 檢查目前有哪些篩選器是作用中的。

• 清除全域或特定欄位的選取項目。

它們共同支援引導式分析流程、可重現的調查步驟。

以下工具可用：

• Qlik_select_values：將選取項目 (篩選器) 套用至欄位 - 支援精確值和模式比對

  資訊備註

  何時使用選取項目而非集合分析：

  • 當您想要篩選整個應用程式或工作階段以進行多個後續作業時，請使用 select_values()。

  • 當您需要針對特定計算進行一次性篩選時，請在運算式中使用集合分析

  選取項目會持續存在於所有作業中，直到清除為止，它們會影響所有後續的資料擷取。最佳實務上，對於單一分析查詢，優先使用集合分析而非選取，以避免狀態管理開銷。

  警告備註

  • 請先使用 qlik_get_field_values() 或 qlik_search_field_values() 以驗證您要選取的值是否存在。選取不存在的值將會靜默失敗。

  • 傳回的選取項目是目前實際套用的選取項目，且為真實的。任何選取失敗的欄位 (例如：值不存在的欄位) 將不會出現在傳回的清單中。

• Qlik_clear_selections：清除選取項目 - 全部或特定欄位

  警告備註傳回的選取項目是實際目前已套用的選取項目，且它們是真實的。任何選取失敗的欄位 (例如，值不存在) 將不會出現在傳回的清單中。

• Qlik_get_current_selections：取得應用程式中目前作用中的選取項目或篩選器

提示範例：

為「高階主管銷售」應用程式設定我的分析內容：選取「年份」= 2025 和「區域」= EMEA，並對「產品類別」套用模式型選取，以僅包含以「雲端」開頭的類別。然後顯示目前的選取項目，以便我確認哪些是作用中。在我檢閱 KPI 後，僅清除產品類別選取 (保留年份和區域)，最後清除所有選取，以將應用程式重設回未篩選狀態。”

視覺化與工作表

這些工具讓使用者在 Qlik 應用程式中組合儀表板：

• 建立新工作表作為畫布。

• 新增視覺化 (圖、表格、KPI)，並設定維度、量值和顯示選項。

• 將篩選窗格放置在工作表上，讓使用者可以互動式地切割分析。

總之，它們涵蓋建立可用、自助式儀表板頁面的基本工作流程。

以下工具可用：

• Qlik_create_sheet：在應用程式中建立新的空白工作表 (儀表板)

• Qlik_add_chart：將視覺化 (長條、折線、圓餅、表格、KPI 等) 新增至工作表

  資訊備註

  • 請先規劃查詢結構，再進行工具呼叫。

  • 請先使用 qlik_search_field_values 或 qlik_get_field_values 測試日期值是否存在。

  • 針對一次性查詢，在應用程式層級選取項目上使用集合分析

• Qlik_add_filter：將篩選窗格新增至工作表以進行使用者導向篩選

提示範例：

在我們的分析應用程式中，建立一個名為「銷售概覽」的新工作表。新增一個 KPI，用於總收入和總訂單、一個顯示依月份劃分的收入的折線圖，以及一個顯示依地區劃分的收入的長條圖 (依降冪排序)。 然後新增一個篩選面板，包含「年份」、「地區」和「產品類別」，讓使用者可以調整檢視。 確保視覺內容標題清晰，且工作表已準備就緒供高階主管閱覽。