Qlik MCP 工具
Last updated: 2026/9/1Qlik 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 工具類別和工具名稱的概述。
| 類別 | 摘要 | 工具名稱 |
|---|---|---|
|
應用程式探索 & 中繼資料 |
尋找應用程式、探索結構、了解可用的資料。 |
|
|
自動化 |
探索並執行自動化作業,以執行傳送通知或執行工作流程等動作。 |
|
| 書籤 | 在應用程式中檢視、建立、更新和刪除書籤。 |
|
|
業務詞彙表 |
管理業務術語、定義、類別以及與資料資產的連結。 |
|
|
資料管道專案 |
取得連線的資料表和檢視,以及專案的繫結值。 |
|
|
資料集 & 資料品質 |
檢視資料集、結構描述、描述檔、信任分數及品質度量。 |
|
|
資料探索與分析 |
查詢資料、建立計算、探索欄位值。 |
|
|
資料產品 |
建立、管理、啟用及發佈精選的資料產品。 |
|
| 知識庫 | 搜尋知識庫並使用其內容來獲取答案。 |
|
|
譜系 |
追蹤資料來源和轉換。 |
|
|
主項目 (維度與量值) |
管理可重複使用的受控管維度和量值。 |
|
|
選取與篩選 |
套用並管理影響所有視覺效果的篩選。 |
|
|
視覺化和工作表 |
建立儀表板並新增圖、篩選器、KPI |
|
這些工具各自能完成什麼
應用程式探索與中繼資料
使用這些工具來尋找正確的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 並總結已有哪些圖表可用以及還存在哪些差距。
自動化
這些工具讓您能直接從您的 LLM 用戶端尋找並執行 Qlik Cloud 自動化作業。自動化是可重複使用的工作流程,可以觸發外部動作,例如傳送通知、執行整合或執行排程任務。透過使用這些工具,大型語言模型可以將 Qlik Automate 能力整合到代理工作流程和多步驟分析任務中。
以下工具可用:
-
Qlik_fetch_automation_run: 擷取一個自動化執行的目前狀態,無需輪詢。
-
Qlik_get_automation_by_id: 擷取特定自動化的詳細資訊,使用其唯一識別碼。
-
Qlik_get_automation_inputs:擷取執行自動化所需的輸入欄位,以便您能在執行之前發現需要哪些輸入。
-
Qlik_get_automation_run_display: 擷取某個特定自動化執行的顯示輸出。
-
Qlik_列出所有自動化執行:列出您有權限在整個租用戶中查看的所有自動化執行,提供自動化活動的概述。
-
Qlik_list_automation_runs:列出特定自動化的執行紀錄,包括狀態、開始時間和持續時間。使用此功能查看自動化的執行歷史記錄和狀態。
-
Qlik_start_automation_run: 執行一個自動化。這會為指定的自動化建立並啟動一個新的執行。
-
Qlik_start_automation_run_interactive: 啟動一個自動化並傳回初始執行狀態,支援在執行期間進行互動式輸入。
-
Qlik_update_automation_run_input: 立即停止正在執行的自動化執行。
-
Qlik_get_automation_run:提交使用者輸入至一個正在等待輸入的自動化執行。
自動化功能在與 Qlik MCP 工具搭配使用時有以下限制:
-
支援的輸入類型僅限於:
-
單一線條
-
多行
-
下拉式選單
資訊備註下拉式輸入限制為 10 個選項。 -
多選。
資訊備註多選輸入限制為 10 個選項。
-
提示範例:
我已完成本月銷售趨勢的分析。搜尋與通知或電子郵件相關的自動化。 一旦你找到一個會發送電子郵件的,就顯示它的詳細資料給我看。我想執行它,以將我的發現摘要發送給利害關係人,主旨為「每月銷售趨勢分析」。"
書籤
這組工具讓使用者在應用程式中檢視並套用書籤選取項目。用戶也可以從他們目前的選取項目建立自己的書籤,讓他們可以快速地從他們的 LLM 用戶端重新套用選取項目。使用 Qlik MCP 工具建立的書籤也可以刪除。
以下工具可用:
-
Qlik_list_bookmarks:列出應用程式中的所有書籤。
-
建立 Qlik 書籤:使用目前的選取項目建立新的書籤。
-
Qlik_select_bookmark: 選擇書籤。這會變更套用至資料模型的篩選,並傳回產生的選取狀態。
-
Qlik_刪除書籤: 刪除書籤。
資訊備註你只能刪除使用 Qlik MCP 工具建立的書籤。
提示範例:
將目前的選取項目儲存為 EMEA Q1 2026。
商務字彙
這組工具讓使用者能夠端對端地設定並維護受控管的商務字彙:
-
建立字彙
-
使用類別組織
-
新增並管理詞彙 (包括編輯、移除和管理生命週期狀態,例如草稿 - 已驗證 - 已淘汰)
-
將這些詞彙連接到實際的分析資產 (應用程式、資料集、欄位、主項目)。
以下工具可用:
-
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 以驗證值是否存在。這可以防止因不存在的篩選值而導致的錯誤,對於以下項目尤其重要:年份、日期、貨幣代碼、產品名稱。
最佳實務範例工作流程:
-
qlik_search_field_values(fieldName="payment_year", searchTerms=["2022"])
-
驗證「2022」存在於結果中
-
使用 {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 文件,以便我審閱消費者將會看到的內容。更新描述以新增使用指南,並新增退貨資料集。將資料產品移至我們的共用「分析」空間,在該處啟用以供更廣泛存取,如果我們稍後以新版本取代它,則停用舊版本。最後,如果產品已完全停用且不再被引用,請將其刪除。”
資料管道專案
這些工具協助設定及驗證在程式碼中定義的管道專案。當 MCP 伺服器部署並支援宣告式管道時,您可以使用這些工具搜尋可用的資料來源,並在部署之前檢查管道專案中繼資料。
以下工具可用:
-
qlik_search_connection_objects: 列出資料連線中所有可用的來源實體 (資料表、檢視表)。使用此項來探索在設定資料管道任務時有哪些可用的資料來源。
-
qlik_get_pipeline_project_details:傳回專案的繫結值。
提示範例:
-
顯示我們 Sales 資料庫連線中所有可用的資料表,以便我決定要將哪些資料表納入資料管道中。
-
傳回 'CustomerETL' 資料管道專案的繫結值。
知識庫
此工具讓您能夠尋找知識庫,並搜尋其內容以取得答案。該工具可讓您搜尋特定知識庫的內容。
以下工具可用:
-
Qlik 知識庫區塊搜尋:搜尋知識庫中已建立索引的內容,並根據知識庫內容獲取答案。
提示範例:
我正在準備與一位潛在客戶的會議。查看我的客戶資訊、產品使用案例和競爭分析知識庫,並找出最符合我客戶需求的使用案例,同時展示我們如何超越競爭對手。"
譜系
此工具可讓使用者透過擷取資料集或應用程式的上游譜系,追蹤資料來源及其流動方式。因為每次呼叫只會返回一步,所以您通常會遞迴重複它以建立完整的鏈。這對於以下情況很有用:
-
影響分析。
-
疑難排解非預期的數字。
-
治理或稽核。
-
識別饋送報表或資料集的真正來源。
以下工具可用:
-
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,用於總收入和總訂單、一個顯示依月份劃分的收入的折線圖,以及一個顯示依地區劃分的收入的長條圖 (依降冪排序)。 然後新增一個包含年份、地區和產品類別的篩選面板,以便使用者可以調整檢視。 確保視覺內容標題清晰,且工作表已準備就緒供高階主管閱覽。