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 stellen.

Toegangsrechten en Qlik MCP-tools

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

Bovendien gebruikt de Qlik MCP-tool, omdat deze is geautoriseerd als de verbindende gebruiker, uw bestaande gebruikersrol en ruimtemachtigingen. U moet ook machtigingen hebben in Qlik Cloud om de mogelijkheden of het inhoudstype te gebruiken die door de tools worden gebruikt. Als u bijvoorbeeld geen machtiging hebt voor toegang 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 niet kunt gebruiken in Qlik Cloud.

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

Qlik MCP-tools selecteren

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. Deze acties omvatten:

• Het zoeken naar applicaties en datasets

• Het inspecteren van velden en diagrammetadata

• Het toepassen en wissen van filters

• Het maken van werkbladen en diagrammen

• Het beheren van beheerde bedrijfsmiddelen zoals begrippenlijsttermen en dataproducten.

Elke tool vertegenwoordigt een specifieke mogelijkheid met duidelijk 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-detectie en metadata

Gebruik deze tools om de juiste Qlik-analyseapplicatie te vinden en snel te begrijpen wat erin staat voordat u diagrammen bouwt of filters toepast. Deze categorie ondersteunt een end-to-end detectiestroom: zoek in Qlik-bronnen om relevante applicaties te vinden.

De volgende tools zijn beschikbaar:

• Qlik_search: Zoek naar Qlik-bronnen (applicaties, datasets, dataproducten, begrippenlijsten, knowledge bases) op naam of inhoud.

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

• Qlik_get_fields: Toon alle gegevensvelden die beschikbaar zijn in een applicatie 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.

Voorbeeld van prompt:

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

• qlik_search gebruiken om applicaties te vinden die te maken hebben met “churn” of “customer retention”.

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

• qlik_get_fields gebruiken om beschikbare velden op te sommen en kandidaat-dimensies en -meetwaarden te identificeren, zoals Customer, ChurnFlag, SubscriptionType, Region en ChurnDate.

• qlik_list_sheets gebruiken om te zien welke dashboards al bestaan.

• Voor een veelbelovend werkblad, bijvoorbeeld “Churn Overview”, qlik_get_sheet_details aanroepen en samenvatten welke diagrammen al beschikbaar zijn en welke hiaten er nog zijn.

Zakelijke begrippenlijst

Met deze set tools kan een gebruiker een beheerde zakelijke begrippenlijst end-to-end opzetten en onderhouden:

• Een begrippenlijst maken

• Deze organiseren met categorieën

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

• Die termen koppelen aan echte analyse-assets (applicaties, datasets, velden, masteritems).

De volgende tools zijn beschikbaar:

• Qlik_create_glossary: Maak een nieuwe zakelijke begrippenlijst

• Qlik_get_full_glossary_export: Haal de volledige begrippenlijst op met alle termen, categorieën en koppelingen (kostbare bewerking)

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

• Qlik_create_glossary_category: Maak een nieuwe categorie binnen een begrippenlijst

• Qlik_search_glossary_terms: Zoek naar termen binnen een begrippenlijst

• Qlik_get_glossary_term: Haal een specifieke term op uit een begrippenlijst

• Qlik_create_glossary_term: Maak een nieuwe begrippenlijstterm met beschrijving, tags en relaties

• Qlik_update_glossary_term: Wijzig een bestaande begrippenlijstterm

• Qlik_delete_glossary_term: Verwijder een begrippenlijstterm

• Qlik_update_term_status: Werk de termstatus bij (concept, geverifieerd, verouderd). 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 verouderd en mag niet worden gebruikt.

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

• Qlik_get_glossary_term_links: Haal bronnen op die aan een begrippenlijstterm zijn gekoppeld

  Deze functie ondersteunt twee modi:

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

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

  Informatie

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

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

Voorbeeld van prompt:

"Help me een zakelijke begrippenlijst op te bouwen en te beheren voor ons Sales-domein. Maak een begrippenlijst met de naam ‘Sales Glossary’, voeg de categorieën ‘Revenue’, ‘Customers’ en ‘Pipeline’ toe. Maak vervolgens termen voor ‘Annual Recurring Revenue (ARR)’ and ‘Customer Churn’ met duidelijke definities en tags zoals 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 dataproducten), wat deze bevat (schema) en hoe de gegevens eruitzien (profileringsstatistieken/-distributies en een snelle rijsteekproef). De tools ondersteunen ook stewardship-workflows: het verbeteren van datasetdocumentatie (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: Laad metadata van een dataset inclusief betrouwbaarheidsscore

• Qlik_get_dataset_schema: Laad het schema (column definities) 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 tijdstempel van de laatste update van een dataset op

• Qlik_get_dataset_trust_score: Haal de betrouwbaarheidsscore van een dataset op

• Qlik_get_dataset_memberships: Haal lidmaatschappen van dataproducten op voor een dataset

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

• Qlik_update_dataset_quality: Vraag een gegevenskwaliteitsberekening aan voor een dataset

• Qlik_get_dataset_quality_computation_status: Controleer de status van een kwaliteitsberekening

Voorbeeld van prompt:

“Beoordeel of onze dataset Customer Orders gereed is voor een nieuw dashboard. Toon me de metadata en de huidige betrouwbaarheidsscore, bevestig de tijd van de laatste vernieuwing en geef aan tot welke dataproducten 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 datasetprofiel uit om ontbrekende waarden en uitschieters op te sporen, en als de kwaliteitsstatistieken verouderd lijken, activeer dan een gegevenskwaliteitsberekening en blijf de taakstatus controleren totdat deze is voltooid. Werk ten slotte de datasetbeschrijving bij om bekende beperkingen en aanbevolen gebruik te documenteren.”

Gegevensverkenning en -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 maken of query-objecten gebruiken om 'wat-als'-vragen te beantwoorden, velden inspecteren door unieke waarden op te sommen of naar specifieke waarden zoeken.

De volgende tools zijn beschikbaar:

• Qlik_create_data_object: Maak tijdelijke berekeningsobjecten voor ad-hoc analyse-query's

  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:

  • Aggregeer, som, gemiddelde of bereken nooit op geretorneerde 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: Haal unieke waarden op voor een specifiek veld (gebruik vóór het filteren)

  Informatie

  Gebruik voor velden met een hoge cardinaliteit altijd qlik_search_field_values()

  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 gegevensobjecten maakt met set-analyse of selecties: Gebruik qlik_search_field_values om te controleren of waarden bestaan. Dit voorkomt fouten door niet-bestaande filterwaarden, wat vooral belangrijk is voor: jaren, datums, valutacodes, productnamen.

  Voorbeeld van best practice-workflow:

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

  2. Controleer of "2022" in de resultaten voorkomt

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

• Qlik_get_chart_data: Haal gepagineerde gegevens op uit een bestaande diagramvisualisatie

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

Voorbeeld van prompt:

“Help me te onderzoeken waarom de omzet in de regio North vorige maand is gedaald. Controleer eerst het bestaande diagram ‘Revenue by Region’: toon me de metadata (dimensies, meetwaarden, filters, aantal rijen) en haal vervolgens de diagramgegevens van de afgelopen twee maanden op. Voer ik selecties toepas, toon de unieke waarden voor Region en doorzoek de veldwaarden om te bevestigen of ‘North’, ‘NORTH’ of ‘Northern’ wordt gebruikt. Maak vervolgens een tijdelijke berekening om de omzet en marge van maand tot maand te vergelijken voor North versus andere regio's, en geef aan welke productcategorieën het meest hebben bijgedragen aan de verandering.”

Dataproducten

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

1. Maak het.

2. Inspecteer de metadata en documentatie ervan.

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

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

Ze ondersteunen ook het opschonen aan het einde van de levenscyclus 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

Voorbeeld van prompt:

“Maak een dataproduct met de naam ‘Sales Analytics – Curated’ met een duidelijke beschrijving en voeg deze datasets toe: Orders, Customers en Products. Toon me vervolgens de metadata van het dataproduct en haal de bijbehorende markdown-documentatie op, zodat ik kan controleren wat consumenten te zien krijgen. Werk de beschrijving bij om gebruiksinstructies toe te voegen en voeg ook de dataset Returns toe. Verplaats het dataproduct naar onze gedeelde ruimte ‘Analytics’, activeer het daar voor bredere toegang en deactiveer de oude versie als we deze later vervangen door een nieuwe versie. Ten slotte, als het product volledig is uitgefaseerd en er niet meer naar wordt verwezen, verwijdert u het.”

Herkomst

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

• Impactanalyse.

• Problemen met onverwachte getallen oplossen.

• Governance of auditing.

• Het identificeren van de werkelijke bronnen die een rapport of dataset voeden.

De volgende tools zijn beschikbaar:

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

Voorbeeld van prompt:

“Toon me de volledige upstream-herkomst voor de dataset Customer Orders. Begin bij de dataset en ga recursief terug tot u de oorspronkelijke bronsystemen bereikt. Vat voor elke stap samen wat de directe bovenliggende bron is en noteer eventuele belangrijke transformaties of tussenliggende datasets of apps die erbij betrokken zijn. Vertel me vervolgens welke upstream-bron waarschijnlijk de meeste invloed heeft op het veld net_amount als dit verandert.”

Masteritems (dimensies en meetwaarden)

Deze tools helpen gebruikers om belangrijke bedrijfslogica in een app te standaardiseren en te hergebruiken door te werken met masterdimensies (bibliotheekdimensies) en -meetwaarden. U kunt inventariseren wat er al beschikbaar is (om duplicaten te voorkomen en consistentie te stimuleren), en u kunt nieuwe herbruikbare dimensies en meetwaarden maken, zodat diagrammen op meerdere werkbladen dezelfde velddefinities en berekeningsexpressies gebruiken. Dit verbetert de governance, het onderhoud en de afstemming van metrische gegevens.

U kunt uw masteritems bijwerken met nieuwe definities, waardoor snelle verfijningen mogelijk zijn. U kunt masteritems ook 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: 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: Toon alle bibliotheekmeetwaarden die beschikbaar zijn in de app

• Qlik_create_measure: Maak een herbruikbare bibliotheekmeetwaarde met expressie

• Qlik_update_measure: Werk een bestaande bibliotheekmeetwaarde bij in een Qlik-app

• Qlik_delete_measure: Verwijder een bibliotheekmeetwaarde uit een Qlik-app

Voorbeeld van prompt:

“Help me metrische gegevens te standaardiseren in onze Sales Performance-app. Toon eerst de bestaande bibliotheekdimensies en -meetwaarden, zodat we niets dupliceren. Maak vervolgens een nieuwe bibliotheekdimensie ‘Customer Segment’ op basis van het juiste segmentveld, en maak een herbruikbare meetwaarde ‘Gross Margin %’ met behulp van onze standaarddefinitie (brutomarge gedeeld door omzet, opgemaakt als 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 filtering

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-achtige overeenkomsten).

• Inspecteren welke filters momenteel actief zijn.

• Selecties globaal of voor een specifiek veld wissen.

Samen ondersteunen ze begeleide analysestromen en reproduceerbare onderzoeksstappen.

De volgende tools zijn beschikbaar:

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

  Informatie

  Wanneer u selecties verkiest boven 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 opeenvolgende gegevensophalingen. Als best practice verdient set-analyse voor afzonderlijke analytische query's de voorkeur boven selecties om overhead voor statusbeheer te vermijden.

  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 mislukt geruisloos.

  • De geretourneerde selecties zijn de werkelijke, momenteel toegepaste selecties. Velden waarvoor de selectie is mislukt, bijvoorbeeld omdat waarden niet bestonden, verschijnen niet in de geretourneerde lijst.

• Qlik_clear_selections: Wis selecties - alle of een specifiek veld

  WaarschuwingDe geretourneerde selecties zijn de werkelijke, momenteel toegepaste selecties. Velden waarvoor de selectie is mislukt, bijvoorbeeld omdat waarden niet bestonden, verschijnen niet in de geretourneerde lijst.

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

Voorbeeld van prompt:

“Stel mijn analysecontext in voor de Executive Sales-app: selecteer Year = 2025 en Region = EMEA, en pas een op patronen gebaseerde selectie toe op Product Category om alleen categorieën op te nemen die beginnen met ‘Cloud’. Toon me vervolgens de huidige selecties, zodat ik kan adviseren wat actief is. Nadat ik de KPI's heb bekeken, wist u alleen de selectie Product Category (behoud Year en Region) en wist u 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 toevoegen (diagrammen, tabellen, KPI's) geconfigureerd met dimensies, meetwaarden en weergaveopties.

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

Samen dekken ze de basisworkflow voor het bouwen van een bruikbare, self-service dashboardpagina.

De volgende tools 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 query-structuur voordat u tool-aanroepen doet.

  • Test eerst of de datumwaarde bestaat 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: Voeg een filtervak toe aan een werkblad voor door de gebruiker gestuurde filtering

Voorbeeld van prompt:

“Maak een nieuw werkblad met de naam ‘Sales Overview’ in onze analyse-app. Voeg een KPI toe voor Total Revenue en Total Orders, een lijndiagram dat Revenue by Month toont, en een staafdiagram dat Revenue by Region toont (aflopend gesorteerd). Voeg vervolgens een filtervak toe met Year, Region en Product Category zodat gebruikers de weergave kunnen aanpassen. Zorg ervoor dat de visualisaties duidelijke titels hebben en dat het werkblad gereed is voor een directiepubliek.”