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.

Toegangsrechten en Qlik MCP-tools

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

Omdat de Qlik MCP-tool is geautoriseerd als de verbindende gebruiker, gebruikt deze bovendien uw bestaande gebruikersrol en ruimtemachtigingen. U moet ook machtigingen hebben in Qlik Cloud om de mogelijkheden of het inhoudstype te gebruiken dat door de tools wordt gebruikt. Als u bijvoorbeeld geen machtiging hebt voor toegang tot herkomst in Qlik Cloud, kunt u de Qlik MCP-tool Qlik get lineage 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.

Qlik MCP-tools selecteren

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

• Applicaties en gegevenssets zoeken

• Velden en diagrammetagegevens inspecteren

• Filters toepassen en wissen

• Werkbladen en diagrammen maken

• Beheerde bedrijfsmiddelen beheren, zoals woordenlijsttermen en gegevensproducten.

Elke tool vertegenwoordigt een specifieke mogelijkheid met goed gedefinieerde in- en uitvoer.

Beschikbare Qlik MCP-tools

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

Wat de tools elk kunnen bereiken

App-ontdekking en metagegevens

Gebruik deze tools om de juiste Qlik analytics-applicatie te vinden en snel te begrijpen wat erin zit voordat u diagrammen bouwt of filters toepast. Deze categorie ondersteunt een end-to-end ontdekkingsstroom: zoeken in Qlik-bronnen om relevante applicaties te vinden.

De volgende tools zijn beschikbaar:

• Qlik_search: Zoeken naar Qlik-bronnen (applicaties, gegevenssets, gegevensproducten, woordenlijsten) op naam of inhoud.

• Qlik_describe_apps: Uitgebreide metagegevens voor een applicatie ophalen, inclusief velden, eigenaar, publicatiestatus.

• Qlik_get_fields: Alle gegevensvelden weergeven die beschikbaar zijn in een applicatie voor gebruik als dimensies.

• Qlik_list_sheets: Alle werkbladen in een app weergeven.

• Qlik_get_sheet_details: Details over een specifiek werkblad ophalen, inclusief alle diagrammen en hun typen.

• Qlik_search_spaces: Zoeken naar ruimten op basis van een queryreeks.

Voorbeeld van prompt:

"Ik moet het klantverloop analyseren." Met deze eenvoudige prompt kunt u:

• qlik_search gebruiken om applicaties te vinden die gerelateerd zijn aan “verloop” of “klantbehoud”.

• Voor de beste overeenkomst qlik_describe_app uitvoeren om te bevestigen dat het de juiste applicatie is en de metagegevens ervan te bekijken (eigenaar en publicatiestatus).

• qlik_get_fields gebruiken om beschikbare velden weer te geven en kandidaat-dimensies en -metingen te identificeren, zoals Klant, Verloopvlag, Abonnementstype, Regio en Verloopdatum.

• qlik_list_sheets gebruiken om te zien welke dashboards al bestaan.

• Voor elk veelbelovend werkblad, bijvoorbeeld “Verloopoverzicht”, qlik_get_sheet_details aanroepen en samenvatten 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 opzetten en onderhouden:

• Een woordenlijst maken

• Deze organiseren met categorieën

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

• Die termen verbinden met echte analytics-bedrijfsmiddelen (applicaties, gegevenssets, velden, masteritems).

De volgende tools zijn beschikbaar:

• Qlik_create_glossary: Een nieuwe bedrijfswoordenlijst maken

• Qlik_get_full_glossary_export: Volledige woordenlijst ophalen met alle termen, categorieën, koppelingen (dure bewerking)

• Qlik_get_glossary_categories: Alle categorieën voor een woordenlijst ophalen

• Qlik_create_glossary_category: Een nieuwe categorie maken binnen een woordenlijst

• Qlik_search_glossary_terms: Zoeken naar termen binnen een woordenlijst

• Qlik_get_glossary_term: Een specifieke term uit een woordenlijst ophalen

• Qlik_create_glossary_term: Een nieuwe woordenlijstterm maken met beschrijving, tags, relaties

• Qlik_update_glossary_term: Een bestaande woordenlijstterm wijzigen

• Qlik_delete_glossary_term: Een woordenlijstterm verwijderen

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

  Informatie

  Deze bewerking heeft drie statussen:

  • draft: De term bevindt zich in de conceptstatus.

  • verified: De term is geverifieerd door een steward.

  • deprecated: De term is afgeschaft en mag niet worden gebruikt.

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

• Qlik_get_glossary_term_links: Bronnen ophalen die zijn gekoppeld aan een woordenlijstterm

  Deze functie ondersteunt twee modi:

  • Enkele koppelingsmodus: Geef individuele parameters op, bijvoorbeeld resource_id of resource_type.

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

  Informatie

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

• Qlik_create_glossary_term_links: Een term koppelen aan apps, gegevenssets, velden, masteritems

Voorbeeld van prompt:

"Help me bij het bouwen en beheren van een bedrijfswoordenlijst voor ons verkoopdomein. Maak een woordenlijst met de naam ‘Verkoopwoordenlijst’, voeg de categorieën ‘Omzet’, ‘Klanten’ en ‘Pijplijn’ toe. Maak vervolgens termen voor ‘Jaarlijks terugkerende omzet (ARR)’ en ‘Klantverloop’ met duidelijke definities en tags, bijvoorbeeld financiën en verkoopactiviteiten, stel ze in op concept en koppel elke term aan de relevante gegevenssetvelden en de KPI-masteritems."

Gegevenssets en gegevenskwaliteit

Deze tools helpen een gebruiker gegevenssets te begrijpen, te valideren en te beheren door te inspecteren wat de gegevensset is (metagegevens en lidmaatschappen van gegevensproducten), wat deze bevat (schema), hoe de gegevens eruitzien (profileringsstatistieken-verdelingen en een snelle rijsteekproef). De tools ondersteunen ook stewardship-workflows: het verbeteren van de documentatie van gegevenssets (naam-beschrijving) en het activeren en bewaken van gegevenskwaliteitsberekeningen om kwaliteitsstatistieken in de loop van de tijd te vernieuwen.

De volgende tools zijn beschikbaar:

• Qlik_get_dataset: Metagegevens van een gegevensset laden, inclusief vertrouwensscore

• Qlik_get_dataset_schema: Het schema (kolomdefinities) van een gegevensset laden

• Qlik_get_dataset_profile: Profielgegevens (statistieken, verdelingen) van een gegevensset laden

• Qlik_get_dataset_sample: Eerste 10 rijen van een gegevensset laden als voorbeeld

• Qlik_get_dataset_freshness: Laatst bijgewerkte tijdstempel van een gegevensset ophalen

• Qlik_get_dataset_trust_score: De vertrouwensscore van een gegevensset ophalen

• Qlik_get_dataset_memberships: Lidmaatschappen van gegevensproducten voor een gegevensset ophalen

• Qlik_update_dataset_metadata: Naam en beschrijving van een gegevensset bijwerken

• Qlik_update_dataset_quality: Een gegevenskwaliteitsberekening aanvragen voor een gegevensset

• Qlik_get_dataset_quality_computation_status: Status van een kwaliteitsberekening controleren

Voorbeeld van prompt:

“Beoordeel de gereedheid van onze gegevensset Klantorders voor een nieuw dashboard. Toon me de metagegevens en de huidige vertrouwensscore, bevestig de laatste vernieuwingstijd en vermeld tot welke gegevensproducten deze behoort. Laad vervolgens het schema en een steekproef van 10 rijen om belangrijke velden zoals order_date, customer_id en net_amount te controleren. Voer een gegevenssetprofiel uit om ontbrekende waarden en uitschieters op te sporen, en als kwaliteitsstatistieken verouderd lijken, activeer dan een gegevenskwaliteitsberekening en blijf de taakstatus controleren totdat deze is voltooid. Werk ten slotte de beschrijving van de gegevensset bij om bekende beperkingen en aanbevolen gebruik te documenteren.”

Gegevensverkenning en -analyse

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

De volgende tools zijn beschikbaar:

• Qlik_create_data_object: Tijdelijke berekeningsobjecten maken voor ad-hoc analytics-query's

  Informatie

  Gebruik get_field_values() of search_field_values() voordat u selecties toepast om te verifiëren 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 roept u 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: Afzonderlijke waarden voor een specifiek veld ophalen (gebruiken vóór het filteren)

  Informatie

  Gebruik voor velden met hoge kardinaliteit altijd in plaats daarvan qlik_search_field_values()

  Waarschuwing

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

• Qlik_search_field_values: Zoeken naar specifieke waarden in velden (verifiëren vóór set-analyse)

  Waarschuwing

  Voordat u gegevensobjecten maakt met set-analyse of selecties: Gebruik qlik_search_field_values om te verifiëren of waarden bestaan. Dit voorkomt fouten door niet-bestaande filterwaarden, wat vooral belangrijk is voor: jaren, datums, valutacodes, productnamen.

  Voorbeeldworkflow voor best practice:

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

  2. Verifieer of "2022" in de resultaten bestaat

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

• Qlik_get_chart_data: Gepagineerde gegevens ophalen uit een bestaande diagramvisualisatie

• Qlik_get_chart_info: Metagegevens over een diagram ophalen zonder de gegevens ervan op te halen

Voorbeeld van prompt:

“Help me te onderzoeken waarom de omzet in de regio Noord vorige maand is gedaald. Controleer eerst het bestaande diagram ‘Omzet per regio’: toon me de metagegevens (dimensies, metingen, filters, aantal rijen) en haal vervolgens de diagramgegevens voor de afgelopen twee maanden op. Voordat ik selecties toepas, geef de afzonderlijke waarden voor Regio weer en zoek in de veldwaarden om te bevestigen of ‘Noord’, ‘NOORD’ of ‘Noordelijk’ wordt gebruikt. Maak vervolgens een tijdelijke berekening om de omzet en marge van maand tot maand voor Noord te vergelijken met 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 gegevenssets:

1. Maak het.

2. Inspecteer de metagegevens en documentatie ervan.

3. Onderhoud de definitie ervan (naam, beschrijving en welke gegevenssets het bevat)

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

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

De volgende tools zijn beschikbaar:

• Qlik_create_data_product: Een nieuw gegevensproduct maken

• Qlik_get_data_product: Metagegevens voor een specifiek gegevensproduct ophalen

• Qlik_get_data_product_documentation: Markdown-documentatie van een gegevensproduct ophalen

• Qlik_update_data_product: Eigenschappen (naam, beschrijving, gegevenssets) van een gegevensproduct bijwerken

• Qlik_update_data_product_space: Een gegevensproduct naar een andere ruimte verplaatsen

• Qlik_update_activate_data_product: Een gegevensproduct in een specifieke ruimte activeren

• Qlik_update_deactivate_data_product: Een gegevensproduct deactiveren

• Qlik_delete_data_product: Een gegevensproduct verwijderen

Voorbeeld van prompt:

“Maak een gegevensproduct met de naam ‘Verkoopanalytics – Gecureerd’ met een duidelijke beschrijving en neem deze gegevenssets op: Orders, Klanten en Producten. Toon me vervolgens de metagegevens van het gegevensproduct en haal de markdown-documentatie op, zodat ik kan bekijken wat consumenten zullen zien. Werk de beschrijving bij om gebruiksrichtlijnen toe te voegen en voeg ook de gegevensset Retouren toe. Verplaats het gegevensproduct naar onze gedeelde ruimte ‘Analytics’, 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 buiten gebruik gesteld en er niet meer naar wordt verwezen, verwijder het dan.”

Herkomst

Met deze tool kan een gebruiker traceren waar gegevens vandaan komen en hoe ze stromen door de stroomopwaartse herkomst voor een gegevensset of app op te halen. Omdat elke aanroep slechts één stap terug retourneert, herhaalt u deze doorgaans recursief om de volledige keten op te bouwen. Dit is nuttig voor:

• Impactanalyse.

• Problemen met onverwachte getallen oplossen.

• Governance of auditing.

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

De volgende tools zijn beschikbaar:

• Qlik_get_lineage: Herkomstgeschiedenis van een gegevensset of app laden (recursief aanroepen voor volledige keten)

Voorbeeld van prompt:

“Toon me de volledige stroomopwaartse herkomst voor de gegevensset Klantorders. Begin bij de gegevensset en loop recursief terug totdat u de oorspronkelijke bronsystemen bereikt. Vat voor elke stap samen wat de directe bovenliggende is en noteer eventuele belangrijke transformaties of tussenliggende gegevenssets of apps die erbij betrokken zijn. Vertel me vervolgens welke stroomopwaartse bron het meest waarschijnlijk van invloed is op het veld net_amount als dit verandert.”

Masteritems (dimensies en 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 er al beschikbaar is (om duplicaten te voorkomen en consistentie te bevorderen), en u kunt nieuwe herbruikbare dimensies en metingen maken, zodat diagrammen op meerdere werkbladen dezelfde velddefinities en berekeningsexpressies gebruiken, wat de governance, onderhoudbaarheid en afstemming van statistieken verbetert.

U kunt uw masteritems bijwerken met nieuwe definities, waardoor snelle verfijningen mogelijk zijn. U kunt ook masteritems verwijderen. U kunt uw LLM-client bijvoorbeeld vragen om elk masteritem op te schonen dat niet in gebruik is in een applicatie.

De volgende tools zijn beschikbaar:

• Qlik_list_dimensionst: Alle bibliotheekdimensies weergeven die beschikbaar zijn in de app

• Qlik_create_dimension: Een herbruikbare bibliotheekdimensie maken

• Qlik_update_dimension: Een bestaande bibliotheekdimensie in een Qlik-app bijwerken

• Qlik_delete_dimension: Een bibliotheekdimensie uit een Qlik-app verwijderen

• Qlik_list_measures: Alle bibliotheekmetingen weergeven die beschikbaar zijn in de app

• Qlik_create_measure: Een herbruikbare bibliotheekmeting met expressie maken

• Qlik_update_measure: Een bestaande bibliotheekmeting in een Qlik-app bijwerken

• Qlik_delete_measure: Een bibliotheekmeting uit een Qlik-app verwijderen

Voorbeeld van prompt:

“Help me statistieken te standaardiseren in onze app Verkoopprestaties. Geef eerst de bestaande bibliotheekdimensies en -metingen weer, 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). Vertel me na het maken ervan de exacte namen van de masteritems waarnaar ik moet verwijzen bij het bouwen van diagrammen, zodat alle dashboards dezelfde logica gebruiken.”

Selecties en filteren

Deze tools beheren de interactieve filterstatus van een Qlik-app:

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

• Inspecteren welke filters momenteel actief zijn.

• Selecties globaal of voor een specifiek veld wissen.

Samen ondersteunen ze begeleide analysestromen, reproduceerbare onderzoeksstappen.

De volgende tools zijn beschikbaar:

• Qlik_select_values: Selecties (filters) toepassen op velden - ondersteunt exacte waarden en patroonmatching

  Informatie

  Wanneer selecties gebruiken in plaats van set-analyse:

  • Wanneer u de hele app of sessie wilt filteren voor meerdere opeenvolgende bewerkingen, gebruikt u select_values().

  • Wanneer u een eenmalig filter nodig hebt voor een specifieke berekening, gebruikt u set-analyse in expressies

  Selecties blijven behouden voor alle bewerkingen totdat ze worden gewist; ze zijn van invloed op ALLE volgende gegevensopvragingen. Als best practice geeft u voor afzonderlijke analytische query's de voorkeur aan set-analyse boven selecties om overhead voor statusbeheer te voorkomen.

  Waarschuwing

  • Gebruik eerst qlik_get_field_values() of qlik_search_field_values() om te verifiëren 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 de waarheid. Velden waar de selectie is mislukt, bijvoorbeeld: waar waarden niet bestonden, verschijnen niet in de geretourneerde lijst.

• Qlik_clear_selections: Selecties wissen - alle of specifiek veld

  WaarschuwingDe geretourneerde selecties zijn de daadwerkelijke huidige toegepaste selectie en ze zijn de waarheid. Velden waar de selectie is mislukt, bijvoorbeeld omdat waarden niet bestonden, verschijnen niet in de geretourneerde lijst.

• Qlik_get_current_selections: Momenteel actieve selecties of filters in de app ophalen

Voorbeeld van prompt:

“Stel mijn analysecontext in voor de app Executive Sales: selecteer Jaar = 2025 en Regio = EMEA, en pas een op patronen 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 er actief is. Nadat ik de KPI's heb bekeken, wis dan alleen de selectie Productcategorie (behoud Jaar en Regio) en wis ten slotte alle selecties om de app terug te zetten naar een ongefilterde status.”

Visualisatie en werkbladen

Met deze tools kunnen gebruikers dashboards samenstellen in een Qlik-applicatie:

• Een nieuw werkblad maken als canvas.

• Visualisaties (diagrammen, tabellen, KPI's) toevoegen die zijn geconfigureerd met dimensies, metingen en weergaveopties.

• Filtervakken op het werkblad plaatsen, zodat gebruikers de analyse interactief kunnen segmenteren.

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

De volgende tools zijn beschikbaar:

• Qlik_create_sheet: Een nieuw leeg werkblad (dashboard) in de app maken

• Qlik_add_chart: Een visualisatie (staaf, lijn, taart, tabel, KPI, enz.) toevoegen aan een werkblad

  Informatie

  • Plan uw querystructuur voordat u tools aanroept.

  • Test eerst het bestaan van datumwaarden met qlik_search_field_values of qlik_get_field_values

  • Gebruik set-analyse in plaats van selecties op app-niveau voor eenmalige query's

• Qlik_add_filter: Een filtervak toevoegen aan een werkblad voor door de gebruiker gestuurd filteren

Voorbeeld van prompt:

“Maak een nieuw werkblad met de naam ‘Verkoopoverzicht’ in onze analytics-app. Voeg een KPI toe voor Totale omzet en Totale orders, een lijndiagram dat de Omzet per maand toont en een staafdiagram dat de Omzet per regio toont (aflopend gesorteerd). Voeg vervolgens een filtervak toe met Jaar, Regio en Productcategorie, zodat gebruikers de weergave kunnen aanpassen. Zorg ervoor dat de visuals duidelijke titels hebben en dat het werkblad klaar is voor een leidinggevend publiek.”