Qlik strumenti MCP

Ultimo aggiornamento: 30/09/2026

Il server Qlik MCP include strumenti che consentono al tuo LLM di eseguire azioni per te nel tuo Qlik Cloud tenant. Puoi personalizzare la tua esperienza selezionando quali strumenti Qlik MCP desideri disponibili.

Autorizzazioni di accesso e strumenti Qlik MCP

L'accesso agli strumenti MCP è controllato dalle tue autorizzazioni. È necessaria l'autorizzazione Qlik MCP: Consentito in un ruolo personalizzato per accedere agli strumenti Qlik MCP dal client LLM.

Inoltre, poiché lo strumento Qlik MCP è autorizzato come utente di connessione, utilizza il ruolo utente e le autorizzazioni di spazio esistenti. È inoltre necessario disporre dell'autorizzazione in Qlik Cloud per utilizzare le capacità o il tipo di contenuto utilizzati dagli strumenti. Ad esempio, se non si dispone dell'autorizzazione per accedere alla derivazione in Qlik Cloud, non è possibile utilizzare lo strumento Qlik MCP Qlik get lineage. A seconda delle autorizzazioni, alcuni strumenti potrebbero rispondere con nessun accesso se non è possibile utilizzare la capacità o la funzionalità in Qlik Cloud.

La disponibilità degli strumenti può anche essere limitata dalla licenza del tuo tenant.

Selezione di Qlik strumenti MCP

Gli strumenti Qlik MCP sono un catalogo di azioni appositamente create che un LLM può richiamare per eseguire azioni nel tuo tenant Qlik Cloud. Le azioni includono:

• Ricerca di applicazioni e set di dati

• Ispezione di campi e metadati del grafico

• Applicazione e cancellazione di filtri

• Creazione di fogli e grafici

• Gestione di risorse governate come termini del glossario e prodotti di dati.

Ogni strumento rappresenta una capacità specifica con input e output ben definiti.

Strumenti Qlik MCP disponibili

La tabella seguente mostra una panoramica delle attuali categorie di strumenti Qlik MCP e dei nomi degli strumenti.

Cosa possono realizzare i singoli strumenti

Rilevamento app e metadati

Usa questi strumenti per trovare la giusta Qlik applicazione di analisi e comprendere rapidamente cosa contiene prima di creare grafici o applicare filtri. Questa categoria supporta un flusso di rilevamento end-to-end: cerca tra le risorse Qlik per individuare le applicazioni pertinenti.

I seguenti strumenti sono disponibili:

• Qlik_search: Cerca Qlik risorse (applicazioni, set di dati, prodotti di dati, glossari, basi di conoscenza, progetti di pipeline, connessioni di pipeline) per nome o contenuto.

• Qlik_describe_apps: Ottieni metadati completi per un'applicazione, inclusi campi, proprietario, stato di pubblicazione.

• Qlik_get_fields: Elenca tutti i campi dati disponibili in un'applicazione da utilizzare come dimensioni.

• Qlik_list_sheets: Elenca tutti i fogli in un'app.

• Qlik_get_sheet_details: Ottieni i dettagli su un foglio specifico, inclusi tutti i grafici e i loro tipi.

• Qlik_search_spaces: Cerca spazi in base a una stringa di query.

Esempio di prompt:

"Devo analizzare il churn dei clienti." Questo semplice prompt consente di:

• Usa qlik_search per trovare applicazioni relative a “churn” o “customer retention”.

• Per la migliore corrispondenza, esegui qlik_describe_app per confermare che sia l'applicazione corretta e visualizzare i suoi metadati (proprietario e stato di pubblicazione).

• Usa qlik_get_fields per elencare i campi disponibili e identificare dimensioni e misure candidate come Customer, ChurnFlag, SubscriptionType, Region e ChurnDate.

• Usa qlik_list_sheets per vedere quali dashboard esistono già.

• Per qualsiasi foglio promettente, ad esempio, “Churn Overview,” chiama qlik_get_sheet_details e riassumi quali grafici sono già disponibili e quali lacune rimangono.

Glossario aziendale

Questo set di strumenti consente a un utente di configurare e gestire un glossario aziendale governato end-to-end:

• Può creare un glossario

• Organizzarlo con le categorie

• Aggiungere e curare i termini (inclusa la modifica, la rimozione e la gestione dello stato del ciclo di vita come bozza -verificato-deprecato)

• Connettere tali termini a risorse di analisi reali (applicazioni, set di dati, campi, voci principali).

I seguenti strumenti sono disponibili:

• Qlik_create_glossary: Crea un nuovo glossario aziendale

• Qlik_get_full_glossary_export: Ottieni il glossario completo con tutti i termini, le categorie, i collegamenti (operazione costosa)

• Qlik_get_glossary_categories: Recupera tutte le categorie per un glossario

• Qlik_create_glossary_category: Crea una nuova categoria all'interno di un glossario

• Qlik_search_glossary_terms: Cerca termini all'interno di un glossario

• Qlik_get_glossary_term: Ottieni un termine specifico da un glossario

• Qlik_create_glossary_term: Crea un nuovo termine del glossario con descrizione, tag, relazioni

• Qlik_update_glossary_term: Modifica un termine del glossario esistente

• Qlik_delete_glossary_term: Rimuovi un termine del glossario

• Qlik_update_term_status: Aggiorna lo stato del termine (bozza, verificato, deprecato). Solo uno steward può verificare un termine. Una volta che il termine è verificato, solo uno steward può modificare il termine

  Nota informatica

  Questa operazione ha tre stati:

  • bozza: Il termine è in stato di bozza.

  • verificato: Il termine è stato verificato da un amministratore.

  • deprecato: Il termine è deprecato e non deve essere utilizzato.

  I nomi degli stati fanno distinzione tra maiuscole e minuscole e devono essere forniti esattamente come sopra.

• Qlik_get_glossary_term_links: Ottieni le risorse collegate a un termine del glossario

  Questa funzione supporta due modalità:

  • Modalità collegamento singolo: Fornire parametri individuali per l'istanza resource_id o resource_type.

  • Modalità batch: Fornire un elenco di dizionari di collegamento tramite il parametro 'links'

  Nota informatica

  Quando si collega a una sottorisorsa, tutti e tre i campi della sottorisorsa (subResourceId, subResourceName e subResourceType) devono essere forniti insieme per ogni collegamento.

• Qlik_create_glossary_term_links: Collegare un termine ad app, set di dati, campi, voci principali

Esempio di prompt:

"Aiutami a creare e governare un glossario aziendale per il nostro dominio Vendite. Crea un glossario denominato ‘Sales Glossary’, aggiungi le categorie ‘Revenue’, ‘Customers’ e ‘Pipeline’. Quindi crea i termini per ‘Annual Recurring Revenue (ARR)’ e ‘Customer Churn’ con definizioni cancella e tag, ad esempio finance e sales-ops, impostali su bozza e collega ciascun termine ai campi pertinenti del dataset e agli elementi master KPI."

Dataset e Qualità dei Dati

Questi strumenti aiutano un utente a comprendere, convalidare e governare i dataset ispezionando cos'è il dataset (metadati e appartenenze ai prodotti dati), cosa contiene (schema), come appaiono i dati (statistiche di profilazione-distribuzioni e un rapido campione di righe). Gli strumenti supportano anche i flussi di lavoro di gestione: migliorando la documentazione del dataset (nome-descrizione) e attivando e monitorando i calcoli della qualità dei dati per aggiornare le metriche di qualità nel tempo.

I seguenti strumenti sono disponibili:

• Qlik_get_dataset: Carica i metadati di un dataset, incluso il punteggio di affidabilità

• Qlik_get_dataset_schema: Carica lo schema (definizioni delle colonne) di un dataset

• Qlik_get_dataset_profile: Carica i dati del profilo (statistiche, distribuzioni) di un dataset

• Qlik_get_dataset_sample: Carica le prime 10 righe di un dataset per l'anteprima

• Qlik_get_dataset_freshness: Ottieni il timestamp dell'ultimo aggiornamento di un dataset

• Qlik_get_dataset_trust_score: Ottieni il punteggio di affidabilità di un dataset

• Qlik_get_dataset_memberships: Ottieni le appartenenze al prodotto dati per un dataset

• Qlik_update_dataset_metadata: Aggiorna nome e descrizione di un dataset

• Qlik_update_dataset_quality: Richiedi un calcolo della qualità dei dati per un dataset

• Qlik_get_dataset_quality_computation_status: Verifica lo stato di un calcolo della qualità

Esempio di prompt:

“Valuta l'idoneità del nostro dataset Customer Orders per una nuova dashboard. Mostrami i suoi metadati e l'attuale punteggio di affidabilità, conferma l'ora dell'ultimo aggiornamento ed elenca a quali prodotti dati appartiene. Quindi carica lo schema e un campione di 10 righe per una verifica preliminare dei campi chiave come order_date, customer_id e net_amount. Esegui la profilazione di un set di dati per individuare valori mancanti e valori anomali e, se le metriche di qualità risultano obsolete, avvia un calcolo della qualità dei dati e continua a verificare lo stato del processo fino al suo completamento. Infine, aggiorna la descrizione del dataset per documentare i vincoli noti e l'uso consigliato.”

Esplorazione & Analisi dei Dati

Questi strumenti supportano l'indagine rapida e ad hoc dei dati e dei contenuti analitici esistenti senza richiedere all'utente di creare permanentemente nuove visualizzazioni. È possibile creare calcoli temporanei o oggetti di query per rispondere a domande “what-if”, ispezionare i campi elencando valori distinti o cercare valori specifici.

I seguenti strumenti sono disponibili:

• Qlik_create_data_object: Crea oggetti di calcolo temporanei per query analitiche ad hoc

  Nota informatica

  Usa get_field_values() o search_field_values() prima di applicare le selezioni per verificare che i valori esistano.

  Nota di avviso

  Qlik esegue TUTTI i calcoli, pertanto:

  • Non aggregare, sommare, calcolare la media o elaborare i dati restituiti: i valori sono definitivi.

  • Per calcoli diversi, richiamare lo strumento con nuove espressioni.

  • Applicare sempre filtri-selezioni appropriati per limitare la dimensione dei dati e migliorare le prestazioni.

• Qlik_get_field_values: Ottieni valori distinti per un campo specifico (usa prima del filtro)

  Nota informatica

  Per i campi ad alta cardinalità, usa sempre qlik_search_field_values() invece.

  Nota di avviso

  Usa questo strumento o qlik_search_field_values() PRIMA di creare selezioni-filtri per verificare che i valori esistano. Questo aiuta a evitare errori quando si applicano filtri con valori inesistenti.

• Qlik_search_field_values: Cerca valori specifici tra i campi (verifica prima dell'analisi del set)

  Nota di avviso

  Prima di creare oggetti dati con set analysis o selezioni: usa qlik_search_field_values per verificare che i valori esistano. Ciò previene errori da valori di filtro inesistenti, particolarmente importante per: anni, date, codici valuta, nomi prodotto.

  Esempio di flusso di lavoro di migliore pratica:

  1. qlik_search_field_values(fieldName="payment_year", searchTerms=["2022"])

  2. Verificare che "2022" esista nei risultati

  3. Creare oggetto dati utilizzando {payment_year={2022}.

• Qlik_get_chart_data: Recupera dati impaginati da una visualizzazione grafico esistente

• Qlik_get_chart_info: Ottieni metadati su un grafico senza recuperarne i dati

Esempio di prompt:

“Aiutami a capire perché i ricavi della regione Nord sono diminuiti lo scorso mese. Per prima cosa, controlla il grafico esistente ‘Revenue by Region’: mostrami i suoi metadati (dimensioni, misure, filtri, conteggio delle righe) e poi estrai i dati del grafico per gli ultimi due mesi. Prima di applicare qualsiasi selezione, elenca i valori distinti per Region e cerca tra i valori del campo per confermare se viene utilizzato ‘North’, ‘NORTH’ o ‘Northern’. Quindi crea un calcolo temporaneo per confrontare i ricavi e il margine mese su mese per il Nord rispetto alle altre regioni, ed evidenzia quali categorie di prodotti hanno contribuito maggiormente alla variazione.”

Prodotti di dati

Questi strumenti gestiscono l'intero ciclo di vita di un prodotto di dati come un pacchetto di dataset governato e condivisibile:

1. Crealo.

2. Ispeziona i suoi metadati e la documentazione.

3. Mantieni la sua definizione (nome, descrizione e quali set di dati contiene)

4. Controlla dove e se è disponibile spostandolo tra gli spazi e attivandolo o disattivandolo.

Supportano anche la pulizia di fine vita eliminando un prodotto di dati quando non è più necessario.

I seguenti strumenti sono disponibili:

• Qlik_create_data_product: Crea un nuovo prodotto di dati

• Qlik_get_data_product: Ottieni i metadati per un prodotto di dati specifico

• Qlik_get_data_product_documentation: Ottieni la documentazione markdown di un prodotto di dati

• Qlik_update_data_product: Aggiorna le proprietà (nome, descrizione, set di dati) di un prodotto di dati

• Qlik_update_data_product_space: Sposta un prodotto di dati in uno spazio diverso

• Qlik_update_activate_data_product: Attiva un prodotto di dati in uno spazio specifico

• Qlik_update_deactivate_data_product: Disattiva un prodotto di dati

• Qlik_delete_data_product: Elimina un prodotto di dati

Esempio di prompt:

“Crea un data product denominato ‘Sales Analytics – Curated’ con una descrizione cancella e includi questi dataset: Orders, Customers e Products. Poi mostrami i metadati del data product e recupera la relativa documentazione Markdown, in modo da poter esaminare ciò che vedranno i consumatori. Aggiorna la descrizione per aggiungere indicazioni sull'uso e aggiungi anche il dataset Returns. Sposta il prodotto dati nel nostro spazio condiviso ‘Analytics’, attivalo lì per garantire un accesso più ampio e, se in seguito lo sostituiamo con una nuova versione, disattiva quella precedente. Infine, se il prodotto è completamente dismesso e non è più referenziato, eliminalo.”

Derivazione

Questo strumento consente a un utente di tracciare da dove provengono i dati e come scorrono recuperando la derivazione a monte per un dataset o un'app. Poiché ogni chiamata restituisce solo un passaggio indietro, in genere la si ripete ricorsivamente per costruire l'intera catena. Questo è utile per:

• Analisi impatto.

• Risoluzione dei problemi relativi a numeri imprevisti.

• Governance o auditing.

• Identificazione delle vere fonti che alimentano un report o un set di dati.

I seguenti strumenti sono disponibili:

• Qlik_get_lineage: Carica il rendiconto della derivazione di un dataset o di un'app (chiama ricorsivamente per la catena completa)

Esempio di prompt:

“Mostrami la derivazione a monte completa per il set di dati Customer Orders. Inizia dal dataset e risali a ritroso in modo ricorsivo fino a raggiungere i sistemi di origine originali. Per ogni passaggio, riassumi qual è il padre diretto e annota eventuali trasformazioni chiave o dataset o app intermedi coinvolti. Poi dimmi quale sorgente a monte ha maggiori probabilità di influire sul campo net_amount se cambia.”

Elementi master (Dimensioni & Misure)

Questi strumenti aiutano gli utenti a standardizzare e riutilizzare la logica di business chiave in un'app lavorando con dimensioni e misure master (di libreria). Puoi inventariare ciò che è già disponibile (per evitare duplicati e incoraggiare la coerenza), e puoi creare nuove dimensioni e misure riutilizzabili in modo che i grafici su più fogli utilizzino le stesse definizioni di campo ed espressioni di calcolo, migliorando la governance, la manutenibilità e l'allineamento delle metriche.

È possibile aggiornare gli elementi master con nuove definizioni, consentendo rapidi perfezionamenti. È anche possibile eliminare gli elementi master. Ad esempio, puoi chiedere al tuo client LLM di ripulire qualsiasi voce principale che non è in uso in un'applicazione.

I seguenti strumenti sono disponibili:

• Qlik_list_dimensionst: Elenca tutte le dimensioni della libreria disponibili nell'app

• Qlik_create_dimension: Crea una dimensione della libreria riutilizzabile

• Qlik_update_dimension: Aggiorna una dimensione della libreria esistente in un'app Qlik

• Qlik_delete_dimension: Elimina una dimensione della libreria da un'app Qlik

• Qlik_list_measures: Elenca tutte le misure di libreria disponibili nell'app

• Qlik_create_measure: Crea una misura di libreria riutilizzabile con espressione

• Qlik_update_measure: Aggiorna una misura di libreria esistente in un'app Qlik

• Qlik_delete_measure: Elimina una misura di libreria da un'app Qlik

Esempio di prompt:

“Aiutami a standardizzare le metriche nella nostra app Sales Performance. Per prima cosa, elenca le dimensioni e le misure esistenti della libreria per non duplicare nulla. Quindi crea una nuova dimensione di libreria ‘Customer Segment’ in base al campo del segmento appropriato e crea una misura riutilizzabile ‘Gross Margin %’ utilizzando la nostra definizione standard (margine lordo diviso per i ricavi, formattato come percentuale). Dopo averli creati, indicami i nomi esatti delle voci principali a cui fare riferimento durante la creazione dei grafici, in modo che tutte le dashboard utilizzino la stessa logica.”

Selezioni & Filtri

Questi strumenti controllano lo stato del filtro interattivo di un'app Qlik:

• Applica selezioni a uno o più campi (utilizzando valori esatti o corrispondenze in stile pattern-predicate).

• Ispeziona quali filtri sono attualmente attivi.

• Cancella selezioni a livello globale o per un campo specifico.

Insieme supportano flussi di analisi guidati, passaggi di indagine riproducibili.

I seguenti strumenti sono disponibili:

• Qlik_select_values: Applica selezioni (filtri) ai campi - supporta valori esatti e corrispondenza di pattern

  Nota informatica

  Quando usare le selezioni rispetto all'analisi set:

  • Quando si desidera filtrare l'intera app o sessione per più operazioni successive, usa select_values().

  • Quando è necessario un filtro una tantum per un calcolo specifico, usa l'analisi set nelle espressioni

  Le selezioni persistono in tutte le operazioni finché non vengono cancellate e influenzano TUTTI i recuperi di dati successivi. Come buona pratica, per singole query analitiche, preferire l'analisi set rispetto alle selezioni per evitare il sovraccarico di gestione dello stato.

  Nota di avviso

  • Utilizzare prima qlik_get_field_values() o qlik_search_field_values() per verificare che i valori che si desidera selezionare esistano. La selezione di valori inesistenti fallirà silenziosamente.

  • Le selezioni restituite sono le selezioni effettive attualmente applicate e corrispondono alla realtà. Eventuali campi in cui la selezione è fallita, ad esempio dove i valori non esistevano, non appariranno nell'elenco restituito.

• Qlik_clear_selections: Cancella selezioni - tutte o un campo specifico

  Nota di avvisoLe selezioni restituite sono la selezione applicata effettiva corrente e rappresentano la verità. Eventuali campi in cui la selezione è fallita, ad esempio, i valori non esistevano, non appariranno nell'elenco restituito.

• Qlik_get_current_selections: Ottieni le selezioni o i filtri attualmente attivi nell'app

Esempio di prompt:

“Imposta il mio contesto di analisi per l'app Executive Sales: seleziona Year = 2025 e Region = EMEA e applica una selezione basata su pattern su Product Category per includere solo le categorie che iniziano con ‘Cloud’. Quindi mostrami le selezioni correnti in modo da poter confermare cosa è attivo. Dopo aver esaminato i KPI, cancella solo la selezione Categoria prodotto (mantieni Anno e Regione) e infine cancella tutte le selezioni per ripristinare l'app a uno stato non filtrato.”

Visualizzazione & Fogli

Questi strumenti consentono agli utenti di assemblare dashboard in un'applicazione Qlik:

• Crea un nuovo foglio come area di lavoro.

• Aggiungi visualizzazioni (grafici, tabelle, KPI) configurate con dimensioni, misure e opzioni di visualizzazione.

• Posiziona caselle di filtro sul foglio in modo che gli utenti possano sezionare interattivamente l'analisi.

Insieme, coprono il flusso di lavoro di base per la creazione di una pagina dashboard utilizzabile e self-service.

I seguenti strumenti sono disponibili:

• Qlik_create_sheet: Crea un nuovo foglio vuoto (dashboard) nell'app

• Qlik_add_chart: Aggiungi una visualizzazione (barra, linea, torta, tabella, KPI, ecc.) a un foglio

  Nota informatica

  • Pianifica la struttura della tua query prima di effettuare chiamate agli strumenti.

  • Verifica l'esistenza del valore data con qlik_search_field_values o qlik_get_field_values prima

  • Usa l'analisi set sulle selezioni a livello di app per query una tantum

• Qlik_add_filter: Aggiungi una casella di filtro a un foglio per il filtro guidato dall'utente

Esempio di prompt:

“Crea un nuovo foglio chiamato ‘Sales Overview’ nella nostra app di analisi. Aggiungi un KPI per Ricavi totali e Ordini totali, un grafico lineare che mostra i Ricavi per mese e un grafico a barre che mostra i Ricavi per regione (in ordine decrescente). Quindi aggiungi un pannello dei filtri con Anno, Regione e Categoria prodotto in modo che gli utenti possano regolare la visualizzazione. Assicurati che gli elementi visivi abbiano titoli chiari e che il foglio sia pronto per un pubblico di dirigenti.”