Qlik MCP-tools

De Qlik MCP-server bevat tools waarmee uw LLM acties voor u kan uitvoeren in uw Qlik Cloud tenant. U kunt uw ervaring aanpassen door te selecteren welke Qlik MCP-tools u beschikbaar wilt hebben.

Toegangsmachtigingen en Qlik MCP-tools

Toegang tot MCP-tools wordt beheerd door uw machtigingen. U hebt de Qlik MCP: Toegestaan machtiging nodig in een aangepaste rol om toegang te krijgen tot Qlik MCP-tools vanuit uw LLM-client.

Bovendien, aangezien de Qlik MCP-tool is geautoriseerd als de verbindende gebruiker, gebruikt deze uw bestaande gebruikersrol en ruimtemachtigingen. U moet ook machtiging hebben in Qlik Cloud om de mogelijkheden of het inhoudstype te gebruiken dat door de tools wordt gebruikt. Bijvoorbeeld, als u geen machtiging hebt om toegang te krijgen tot herkomst in Qlik Cloud, kunt u de Qlik MCP-tool Qlik herkomst ophalen niet gebruiken. Afhankelijk van uw machtigingen kunnen sommige tools reageren met 'geen toegang' als u de mogelijkheid of functie in Qlik Cloud niet kunt gebruiken.

De beschikbaarheid van tools kan ook worden beperkt door de licenties van uw tenant.

Selecteren van Qlik MCP-tools

De Qlik MCP-tools zijn een catalogus van speciaal gebouwde acties die een LLM kan aanroepen om acties uit te voeren in uw Qlik Cloud tenant. De acties omvatten:

• Applicaties en datasets vinden

• Velden en diagrammetadata inspecteren

• Filters toepassen en wissen

• Werkbladen en diagrammen maken

• Beheerde bedrijfsmiddelen beheren, zoals woordenlijsttermen en gegevensproducten.

Elke tool vertegenwoordigt een specifieke functionaliteit met goed gedefinieerde invoer en uitvoer.

Beschikbare Qlik MCP Tools

De onderstaande tabel toont een overzicht van de huidige Qlik MCP-toolcategorieën en toolnamen.

Wat de tools elk kunnen bereiken

App-detectie en -metadata

Gebruik deze tools om de juiste Qlik analyse-app te vinden en snel te begrijpen wat erin zit voordat u diagrammen bouwt of filters toepast. Deze categorie ondersteunt een end-to-end ontdekkingsstroom: zoek binnen Qlik-bronnen om relevante apps te vinden.

De volgende tools zijn beschikbaar:

• Qlik_search: Zoek naar Qlik bronnen (apps, datasets, dataprojecten, woordenlijsten) op naam of inhoud.

• Qlik_describe_apps: Haal uitgebreide metadata op voor een app, inclusief velden, eigenaar en publicatiestatus.

• Qlik_get_fields: Toon alle datavelden die beschikbaar zijn in een app voor gebruik als dimensies.

• Qlik_list_sheets: Toon alle werkbladen in een app.

• Qlik_get_sheet_details: Haal details op over een specifiek werkblad, inclusief alle diagrammen en hun typen.

• Qlik_search_spaces: Zoek naar ruimtes op basis van een zoekreeks.

• Qlik_semantic_search_app: Voer semantisch zoeken uit naar relevante bedrijfsmiddelen in de Qlik app.

Voorbeeld van prompt:

"I need to analyze customer churn." Deze eenvoudige prompt maakt het mogelijk om:

• Gebruik qlik_search om apps te vinden die gerelateerd zijn aan “churn” of “klantbehoud”.

• Voor de beste match, voer qlik_describe_app uit om te bevestigen dat het de juiste app is en de metadata ervan te bekijken (eigenaar en publicatiestatus).

• Gebruik qlik_get_fields om beschikbare velden weer te geven en kandidaat-dimensies en -meetwaarden te identificeren, zoals Customer, ChurnFlag, SubscriptionType, Region en ChurnDate.

• Gebruik qlik_list_sheets om te zien welke dashboards al bestaan.

• Voor elk veelbelovend werkblad, bijvoorbeeld “Churn Overview,” roep qlik_get_sheet_details aan en vat samen welke diagrammen al beschikbaar zijn en welke hiaten er nog zijn.

Bedrijfswoordenlijst

Met deze set tools kan een gebruiker een beheerde bedrijfswoordenlijst end-to-end instellen en onderhouden:

• Een woordenlijst maken

• Organiseer deze met categorieën

• Termen toevoegen en beheren (inclusief bewerken, verwijderen en het beheren van de levenscyclusstatus, zoals concept - geverifieerd - verouderd)

• Verbind die termen met echte analysebedrijfsmiddelen (applicaties, gegevenssets, velden, masteritems).

De volgende tools zijn beschikbaar:

• Qlik_create_glossary: Maak een nieuwe bedrijfsglossarium aan

• Qlik_get_full_glossary_export: Haal een compleet glossarium op met alle termen, categorieën, links (kostbare bewerking)

• Qlik_get_glossary_categories: Haal alle categorieën voor een glossarium op

• Qlik_create_glossary_category: Maak een nieuwe categorie aan binnen een glossarium

• Qlik_search_glossary_terms: Zoek naar termen binnen een woordenlijst

• Qlik_get_glossary_term: Haal een specifieke term op uit een woordenlijst

• Qlik_create_glossary_term: Maak een nieuwe woordenlijstterm aan met beschrijving, tags, relaties

• Qlik_update_glossary_term: Wijzig een bestaande woordenlijstterm

• Qlik_delete_glossary_term: Verwijder een woordenlijstterm

• Qlik_update_term_status: Termstatus bijwerken (concept, geverifieerd, verouderd). Alleen een beheerder kan een term verifiëren. Zodra de term is geverifieerd, kan alleen een beheerder de term wijzigen

  Informatie

  Deze bewerking heeft drie statussen:

  • concept: De term bevindt zich in conceptstatus.

  • geverifieerd: De term is geverifieerd door een beheerder.

  • verouderd: De term is verouderd en mag niet worden gebruikt.

  De statusnamen zijn hoofdlettergevoelig en moeten exact zoals hierboven worden opgegeven.

• Qlik_get_glossary_term_links: Bronnen ophalen die aan een glossariumterm zijn gekoppeld

  Deze functie ondersteunt twee modi:

  • Modus voor enkele koppeling: Geef individuele parameters op voor bijvoorbeeld resource_id of resource_type.

  • Batchmodus: Geef een lijst met koppelingswoordenboeken op via de parameter 'links'.

  Informatie

  Bij het koppelen aan een subresource moeten alle drie de subresource-velden (subResourceId, subResourceName en subResourceType) samen worden opgegeven voor elke koppeling.

• Qlik_create_glossary_term_links: Koppel een term aan apps, datasets, velden, masteritems

Voorbeeld van prompt:

Help me een bedrijfsglossarium opbouwen en beheren voor ons verkoopdomein. Maak een glossarium met de naam ‘Verkoopglossarium’, voeg de categorieën ‘Omzet’, ‘Klanten’ en ‘Pipeline’ toe. Maak vervolgens termen aan voor ‘Annual Recurring Revenue (ARR)’ en ‘Klantverloop’ met wissen definities en tags, bijvoorbeeld finance en sales-ops, stel ze in op concept en koppel elke term aan de relevante datasetvelden en de KPI masteritems.

Datasets en gegevenskwaliteit

Deze tools helpen een gebruiker datasets te begrijpen, te valideren en te beheren door te inspecteren wat de dataset is (metadata en lidmaatschappen van gegevensproducten), wat het bevat (schema), hoe de gegevens eruitzien (profileringsstatistieken-distributies en een snelle rijvoorbeeld). De tools ondersteunen ook stewardship-workflows: het verbeteren van datasetdocumentatie (naam-beschrijving) en het activeren en monitoren van datakwaliteitsberekeningen om kwaliteitsstatistieken na verloop van tijd te vernieuwen.

De volgende tools zijn beschikbaar:

• Qlik_get_dataset: Laad metadata van een dataset inclusief vertrouwensscore

• Qlik_get_dataset_schema: Laad het schema (kolomdefinities) van een dataset

• Qlik_get_dataset_profile: Laad profielgegevens (statistieken, distributies) van een dataset

• Qlik_get_dataset_sample: Laad de eerste 10 rijen van een dataset voor een voorbeeld

• Qlik_get_dataset_freshness: Haal de laatst bijgewerkte tijdstempel van een dataset

• Qlik_get_dataset_trust_score: Haal de betrouwbaarheidsscore op van een dataset

• Qlik_get_dataset_memberships: Haal dataproductlidmaatschappen op voor een dataset

• Qlik_update_dataset_metadata: Werk de naam en beschrijving van een dataset bij

• Qlik_update_dataset_quality: Verzoek om een gegevenskwaliteitsberekening voor een dataset

• Qlik_update_dataset_quality: Verzoek om een gegevenskwaliteitsberekening voor een dataset

• Qlik_get_dataset_quality_computation_status: Controleer de status van een kwaliteitsberekening

Promptvoorbeeld:

“Beoordeel de gereedheid van onze dataset met klantorders voor een nieuw dashboard. Toon me de metadata en de huidige betrouwbaarheidsscore, bevestig de laatste vernieuwingstijd en vermeld tot welke dataprojecten het behoort. Laad vervolgens het schema en een voorbeeld van 10 rijen om sleutelvelden zoals order_date, customer_id en net_amount te controleren. Voer een datasetprofiel uit om ontbrekende waarden en uitschieters te detecteren, en als kwaliteitsstatistieken verouderd lijken, activeer dan een datakwaliteitsberekening en blijf de taakstatus controleren totdat deze is voltooid. Werk ten slotte de datasetbeschrijving bij om bekende beperkingen en aanbevolen gebruik te documenteren.”

Gegevensverkenning & Analyse

Deze tools ondersteunen snel en ad-hoc onderzoek van gegevens en bestaande analyse-inhoud zonder dat de gebruiker permanent nieuwe visualisaties hoeft te bouwen. U kunt tijdelijke berekeningen of queryobjecten maken om “wat-als”-vragen te beantwoorden, velden inspecteren door afzonderlijke waarden weer te geven of te zoeken naar specifieke waarden.

De volgende tools zijn beschikbaar:

• Qlik_create_data_object: Maak tijdelijke berekeningsobjecten voor ad-hoc analysevragen

  Informatie

  Gebruik get_field_values() of search_field_values() voordat u selecties toepast om te controleren of waarden bestaan.

  Waarschuwing

  Qlik voert ALLE berekeningen uit, daarom:

  • Nooit aggregeren, optellen, middelen of berekenen op geretourneerde gegevens: waarden zijn definitief.

  • Voor verschillende berekeningen, roep de tool opnieuw aan met nieuwe expressies.

  • Pas altijd de juiste filters-selecties toe om de gegevensgrootte te beperken en de prestaties te verbeteren.

• Qlik_get_field_values: Haal unieke waarden op voor een specifiek veld (gebruiken vóór het filteren)

  Informatie

  Voor velden met hoge cardinaliteit, gebruik altijd qlik_search_field_values() in plaats daarvan

  Waarschuwing

  Gebruik deze tool of qlik_search_field_values() VOORDAT u selecties-filters maakt om te controleren of de waarden bestaan. Dit helpt fouten te voorkomen bij het toepassen van filters met niet-bestaande waarden.

• Qlik_search_field_values: Zoek naar specifieke waarden in velden (verifieer vóór set-analyse)

  Waarschuwing

  Voordat u data-objecten maakt met set-analyse of selecties: Gebruik qlik_search_field_values om te controleren of waarden bestaan. Dit voorkomt fouten door niet-bestaande filterwaarden, vooral belangrijk voor: jaren, datums, valutacodes, productnamen.

  Best practice voorbeeldworkflow:

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

  2. Verifieer of "2022" bestaat in de resultaten

  3. Maak een dataobject met behulp van {payment_year={2022}.

• Qlik_get_chart_data: Haal gepagineerde gegevens op van een bestaande diagramvisualisatie

• Qlik_get_chart_info: Haal metadata op over een diagram zonder de gegevens ervan op te halen

Voorbeeld van een prompt:

“Help me onderzoeken waarom de omzet in de Noordelijke regio vorige maand is gedaald. Controleer eerst het bestaande ‘Omzet per regio’-diagram: toon me de metadata (dimensies, meetwaarden, filters, rijtelling) en haal vervolgens de diagramgegevens op voor de laatste twee maanden. Voordat ik selecties toepas, lijst de unieke waarden voor Regio op en zoek in de veldwaarden om te bevestigen of ‘Noord’, ‘NOORD’ of ‘Noordelijk’ wordt gebruikt. Maak vervolgens een tijdelijke berekening om de maand-op-maand omzet en marge te vergelijken voor Noord versus andere regio's, en markeer welke productcategorieën het meest hebben bijgedragen aan de verandering.”

Gegevensproducten

Deze tools beheren de volledige levenscyclus van een gegevensproduct als een beheerd, deelbaar pakket van datasets:

1. Maak het.

2. Inspecteer de metadata en documentatie ervan.

3. Beheer de definitie ervan (naam, beschrijving en welke datasets het bevat)

4. Beheer waar en of het beschikbaar is door het te verplaatsen tussen ruimtes en het te activeren of deactiveren.

Ze ondersteunen ook het opschonen aan het einde van de levensduur door een dataproduct te verwijderen wanneer het niet langer nodig is.

De volgende tools zijn beschikbaar:

• Qlik_create_data_product: Maak een nieuw dataproduct

• Qlik_get_data_product: Haal metadata op voor een specifiek dataproduct

• Qlik_get_data_product_documentation: Haal markdown-documentatie op van een dataproduct

• Qlik_update_data_product: Werk eigenschappen (naam, beschrijving, datasets) van een dataproduct bij

• Qlik_update_data_product_space: Verplaats een dataproduct naar een andere ruimte

• Qlik_update_activate_data_product: Activeer een dataproduct in een specifieke ruimte

• Qlik_update_deactivate_data_product: Deactiveer een dataproduct

• Qlik_delete_data_product: Verwijder een dataproduct

Promptvoorbeeld:

“Maak een dataproduct genaamd ‘Sales Analytics – Curated’ met een duidelijke beschrijving en voeg deze datasets toe: Orders, Customers en Products. Laat me dan de metadata van het dataproduct zien en haal de markdown-documentatie ervan op, zodat ik kan bekijken wat consumenten zullen zien. Werk de beschrijving bij om gebruiksrichtlijnen toe te voegen en voeg ook de Returns-dataset toe. Verplaats het dataproduct naar onze gedeelde ‘Analytics’-ruimte, activeer het daar voor bredere toegang, en als we het later vervangen door een nieuwe versie, deactiveer dan de oude. Ten slotte, als het product volledig is uitgefaseerd en niet langer wordt verwezen, verwijder het dan.”

Herkomst

Deze tool laat een gebruiker traceren waar gegevens vandaan komen en hoe ze stromen door stroomopwaartse herkomst op te halen voor een dataset of app. Omdat elke aanroep slechts één stap teruggeeft, herhaal je deze doorgaans recursief om de volledige keten op te bouwen. Dit is nuttig voor:

• Impactanalyse.

• Problemen oplossen met onverwachte getallen.

• Governance of auditing.

• De ware bronnen identificeren die een rapport of dataset voeden.

De volgende hulpmiddelen zijn beschikbaar:

• Qlik_get_lineage: Laad herkomstgeschiedenis van een dataset of app (recursief aanroepen voor de volledige keten)

Prompt voorbeeld:

“Toon mij de volledige upstream herkomst voor de dataset Klantorders. Begin bij de dataset en ga recursief terug totdat u de oorspronkelijke bronsystemen bereikt. Voor elke stap, vat samen wat de directe bovenliggende is en noteer eventuele belangrijke transformaties of betrokken tussentijdse datasets of apps. Vertel me dan welke upstream stream het meest waarschijnlijk het veld net_amount beïnvloedt als het verandert.”

Masteritems (Dimensies & Metingen)

Deze tools helpen gebruikers belangrijke bedrijfslogica in een app te standaardiseren en te hergebruiken door te werken met master (bibliotheek) dimensies en metingen. U kunt inventariseren wat al beschikbaar is (om duplicaten te voorkomen en consistentie aan te moedigen), en u kunt nieuwe herbruikbare dimensies en metingen maken zodat diagrammen over meerdere werkbladen dezelfde velddefinities en berekeningsuitdrukkingen gebruiken, wat de governance, onderhoudbaarheid en metrische uitlijning verbetert.

De volgende hulpmiddelen zijn beschikbaar:

• Qlik_list_dimensionst: Toon alle bibliotheekdimensies die beschikbaar zijn in de app

• Qlik_create_dimension: Maak een herbruikbare bibliotheekdimensie

• Qlik_update_dimension: Werk een bestaande bibliotheekdimensie bij in een Qlik app

• Qlik_delete_dimension: Verwijder een bibliotheekdimensie uit een Qlik app

• Qlik_list_measures: Lijst alle bibliotheekmaten die beschikbaar zijn in de app

• Qlik_create_measure: Maak een herbruikbare bibliotheekmaat met expressie

• Qlik_update_measure: Werk een bestaande bibliotheekmaat bij in een Qlik app

• Qlik_delete_measure: Verwijder een bibliotheekmaat uit een Qlik app

Voorbeeldprompt:

“Help me de statistieken in onze Sales Performance app te standaardiseren. Geef eerst een lijst van de bestaande bibliotheekdimensies en -metingen, zodat we niets dupliceren. Maak vervolgens een nieuwe bibliotheekdimensie ‘Klantsegment’ op basis van het juiste segmentveld, en maak een herbruikbare meting ‘Brutomarge %’ met behulp van onze standaarddefinitie (brutomarge gedeeld door omzet, opgemaakt als een percentage). Nadat je ze hebt gemaakt, vertel me de exacte masteritemnamen waarnaar ik moet verwijzen bij het bouwen van diagrammen, zodat alle dashboards dezelfde logica gebruiken.”

Selecties & Filteren

Deze tools bepalen de interactieve filterstatus van een Qlik app:

• Selecties toepassen op een of meer velden (met behulp van exacte waarden of patroon-predicaat-stijl matching).

• Controleren welke filters momenteel actief zijn.

• Selecties wissen, globaal of voor een specifiek veld.

Samen ondersteunen ze geleide analyseflows, reproduceerbare onderzoeksstappen.

De volgende tools zijn beschikbaar:

• Qlik_select_values: Pas selecties (filters) toe op velden - ondersteunt exacte waarden en patroonherkenning

  Informatie

  Wanneer selecties te gebruiken boven set-analyse:

  • Wanneer u de gehele app of sessie wilt filteren voor meerdere opeenvolgende bewerkingen, gebruik dan select_values().

  • Wanneer u een eenmalig filter nodig heeft voor een specifieke berekening, gebruik dan set-analyse in expressies

  Selecties blijven behouden voor alle bewerkingen totdat ze gewist zijn; ze beïnvloeden ALLE volgende gegevensophalingen. Als best practice, geef voor enkele analytische query's de voorkeur aan set-analyse boven selecties om overhead van statusbeheer te voorkomen.

  Waarschuwing

  • Gebruik eerst qlik_get_field_values() of qlik_search_field_values() om te controleren of de waarden die u wilt selecteren bestaan. Het selecteren van niet-bestaande waarden zal stilzwijgend mislukken.

  • De geretourneerde selecties zijn de daadwerkelijke huidige toegepaste selectie en zijn correct. Alle velden waar de selectie is mislukt, bijvoorbeeld waar waarden niet bestonden, zullen niet verschijnen in de geretourneerde lijst.

• Qlik_clear_selections: Selecties wissen - alle of specifiek veld

  WaarschuwingDe geretourneerde selecties zijn de daadwerkelijke huidige toegepaste selectie en zij zijn de waarheid. Alle velden waar de selectie mislukte, bijvoorbeeld waarden bestonden niet, zullen niet verschijnen in de geretourneerde lijst.

• Qlik_get_current_selections: Haal momenteel actieve selecties of filters op in de app

• Qlik_update_filter: Werk een bestaand filtervak bij in een Qlik app

Voorbeeld van prompt:

“Stel mijn analysecontext in voor de Executive Sales app: selecteer Jaar = 2025 en Regio = EMEA, en pas een patroon-gebaseerde selectie toe op Productcategorie om alleen categorieën op te nemen die beginnen met ‘Cloud’. Toon me vervolgens de huidige selecties zodat ik kan bevestigen wat actief is. Nadat ik de KPI's heb beoordeeld, wis alleen de selectie van Productcategorie (behoud Jaar en Regio), en wis ten slotte alle selecties om de app terug te zetten naar een ongefilterde staat.”

Visualisatie & Werkbladen

Deze tools laten gebruikers dashboards samenstellen in een Qlik app:

• Maak een nieuw werkblad als canvas.

• Voeg visualisaties toe (diagrammen, tabellen, KPI's) geconfigureerd met dimensies, meetwaarden en weergaveopties.

• Plaats filtervakken op het werkblad zodat gebruikers de analyse interactief kunnen filteren.

Samen bestrijken ze de basisworkflow voor het bouwen van een bruikbare, selfservice dashboardpagina.

De volgende hulpmiddelen zijn beschikbaar:

• Qlik_create_sheet: Maak een nieuw leeg werkblad (dashboard) in de app

• Qlik_add_chart: Voeg een visualisatie (staaf, lijn, cirkel, tabel, KPI, enz.) toe aan een werkblad

  Informatie

  • Plan uw querystructuur voordat u hulpmiddeloproepen doet.

  • Controleer eerst het bestaan van datumwaarden met qlik_search_field_values of qlik_get_field_values

  • Gebruik setanalyse over app-brede selecties voor eenmalige query's

• Qlik_add_filter: Voeg een filtervak toe aan een werkblad voor door de gebruiker gestuurde filtering

• Qlik_delete_object: Verwijder een object uit een Qlik app (diagram, werkblad, filter, enz.)

• Qlik_show_chart: Toon een gerenderde visualisatie als een Qlik snapshot

• Qlik_update_chart: Werk een bestaande diagramvisualisatie bij in een Qlik app

Voorbeeld van een prompt:

“Maak een nieuw werkblad met de naam ‘Verkoopoverzicht’ in onze analyse-app. Voeg een KPI toe voor Totale omzet en Totaal aantal bestellingen, een lijndiagram met Omzet per maand, en een staafdiagram met Omzet per regio (aflopend gesorteerd). Voeg vervolgens een filtervak toe met Jaar, Regio en Productcategorie, zodat gebruikers de weergave kunnen aanpassen. Zorg ervoor dat de visuals duidelijk zijn getiteld en dat het werkblad klaar is voor een directiepubliek.”