MCP Server

Model Context Protocol Integratie

De mindzieAPI MCP-server stelt AI-codeerassistenten in staat om programmatisch met mindzieStudio te communiceren. MCP (Model Context Protocol) biedt een gestandaardiseerde manier voor AI-tools om externe functionaliteiten te benaderen.

Beschikbare Tools

De MCP-server maakt de volgende tools beschikbaar voor AI-assistenten:

mindzie_list_block_types

Haalt informatie op over beschikbare bloktypes (filters, calculators, verrijkingen).

Parameters

Parameter	Type	Vereist	Beschrijving
`category`	String	Nee	Filter op categorie: "filters", "calculators", "unified" of weglaten voor alleen filters

Categorie-opties

Waarde	Retourneert
`"filters"`	Alleen filterbloktypes (standaard)
`"calculators"`	Alleen calculatorbloktypes
`"unified"`	Alle bloktypes inclusief verrijkingen, gegroepeerd per categorie

Voorbeeld: Alle bloktypes ophalen (Aanbevolen)

mindzie_list_block_types category="unified"

Retourneert volledige metadata voor alle bloktypes:

{
  "BlockTypes": [
    {
      "OperatorName": "CaseAttributeFilter",
      "DisplayName": "Filter Case-kenmerk",
      "Description": "Filter cases gebaseerd op attribuutwaarden",
      "Category": "Attribuutfilters",
      "BlockType": "Filter",
      "DocumentationUrl": "/mindzie_studio/filters/case-attribute-filter",
      "UsageFrequency": "Hoog",
      "CommonUseCases": ["Filter op klantsegment", "Focus op specifieke regio's"]
    },
    {
      "OperatorName": "CaseDurationCalculator",
      "DisplayName": "Calculator Case-duur",
      "Description": "Bereken de totale duur van cases",
      "Category": "Tijdcalculators",
      "BlockType": "Calculator",
      "DocumentationUrl": "/mindzie_studio/calculators/case-duration-calculator",
      "UsageFrequency": "Hoog",
      "CommonUseCases": ["Analyseer cyclustijden", "Identificeer trage cases"]
    },
    {
      "OperatorName": "CaseStageCalculator",
      "DisplayName": "Calculator Case-fase",
      "Description": "Ken fase-labels toe aan cases op basis van activiteitspatronen",
      "Category": "Fase-analyse",
      "BlockType": "Verrijking",
      "DocumentationUrl": "/mindzie_studio/enrichments/case-stage-calculator",
      "UsageFrequency": "Midden",
      "CommonUseCases": ["Volg case-voortgang", "Bewaak fase-overgangen"]
    }
  ],
  "Categories": ["Attribuutfilters", "Tijdfilters", "Tijdcalculators", "Fase-analyse"],
  "TotalCount": 45,
  "ByBlockCategory": {
    "Filter": [...],
    "Calculator": [...],
    "Enrichment": [...]
  }
}

Voorbeeld: Alleen filters ophalen

mindzie_list_block_types category="filters"

Voorbeeld: Alleen calculators ophalen

mindzie_list_block_types category="calculators"

mindzie_list_projects

Lijst met beschikbare projecten in de huidige tenant.

Parameters

Parameter	Type	Vereist	Beschrijving
`tenant_id`	String	Ja	De tenant-identificatie

mindzie_get_project

Details ophalen over een specifiek project.

Parameters

Parameter	Type	Vereist	Beschrijving
`tenant_id`	String	Ja	De tenant-identificatie
`project_id`	String	Ja	De project-identificatie

mindzie_execute_block

Voer een blok uit en retourneer resultaten.

Parameters

Parameter	Type	Vereist	Beschrijving
`tenant_id`	String	Ja	De tenant-identificatie
`project_id`	String	Ja	De project-identificatie
`block_id`	String	Ja	Het uit te voeren blok

mindzie_generate_url

Genereer URL's naar mindzieStudio pagina's en entiteiten voor navigatie of delen.

Parameters

Parameter	Type	Vereist	Beschrijving
`type`	String	Ja	URL-type (zie URL Types hieronder)
`entity_id`	String	Conditioneel	Entiteit-ID voor entiteit-specifieke pagina's
`parent_id`	String	Conditioneel	Parent-ID (projectId of notebookId)

URL Types

Lijstpagina's (geen entity_id vereist):

Type	parent_id	Beschrijving
`projects`	-	Projectenlijst
`apps`	-	Lijst apps
`investigations`	projectId	onderzoeken voor een project
`dashboards-list`	projectId	lijst dashboards voor een project
`datasets`	projectId	datasets voor een project
`actions`	projectId	acties voor een project
`bpmn`	projectId	BPMN-editor voor een project

Entiteitpagina's (entity_id vereist):

Type	entity_id	parent_id	Beschrijving
`dashboard`	dashboardId	-	Enkel dashboard
`analysis`	notebookId	-	Notebook/analysepagina
`block`	blockId	notebookId	Specifiek blok
`enrichment`	enrichmentId	projectId (optioneel)	Verrijkingsnotebook

Voorbeeld: Dashboard URL ophalen

mindzie_generate_url type="dashboard" entity_id="{dashboardId}"

Retourneert:

{
  "url": "https://host/navigate?type=dashboard&id=...",
  "entityType": "dashboard",
  "entityId": "...",
  "tenantId": "..."
}

Voorbeeld: Blok-URL ophalen

mindzie_generate_url type="block" entity_id="{blockId}" parent_id="{notebookId}"

Voorbeeld: URL Lijst onderzoeksprojecten ophalen

mindzie_generate_url type="investigations" parent_id="{projectId}"

Vereisten

Voordat je de MCP-server instelt, zorg ervoor dat je:

Node.js 18 of hoger - Download van nodejs.org
Een mindzie API-token - Genereer dit in de accountinstellingen van je mindzieStudio
De URL van jouw mindzieStudio-instantie - Bijvoorbeeld https://www.mindziestudio.com (cloud) of jouw on-premise URL

Installatie

De mindzie MCP-server wordt automatisch geïnstalleerd via npx - geen handmatige installatie nodig:

npx -y @mindzie/mcp-server

Omgevingsvariabelen

Variabele	Vereist	Beschrijving
`MINDZIE_API_URL`	Ja	De URL van jouw mindzieStudio-instantie
`MINDZIE_API_TOKEN`	Ja	Je API authenticatietoken

Setup per Applicatie

Claude Desktop

Claude Desktop is de desktopapplicatie van Anthropic voor Claude AI.

Windows Configuratie

Bewerk het configuratiebestand op:

%APPDATA%\Claude\claude_desktop_config.json

Voeg de mindzie MCP-server toe:

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

macOS Configuratie

Bewerk het configuratiebestand op:

~/Library/Application Support/Claude/claude_desktop_config.json

Voeg dezelfde configuratie toe als hierboven voor Windows.

Na Configuratie

Sla het configuratiebestand op
Start Claude Desktop volledig opnieuw (afsluiten en weer openen)
Zoek het hamer-icoon in de chatinterface - dit geeft aan dat MCP-tools beschikbaar zijn

Claude Code (CLI)

Claude Code is de command-line interface van Anthropic voor Claude AI.

Voeg de MCP-server toe

Voer het volgende commando uit om de mindzie MCP-server te registreren:

claude mcp add mindzie -- npx -y @mindzie/mcp-server

Stel Omgevingsvariabelen in

Windows (PowerShell):

$env:MINDZIE_API_URL = "https://www.mindziestudio.com"
$env:MINDZIE_API_TOKEN = "your-api-token-here"

Windows (Command Prompt):

set MINDZIE_API_URL=https://www.mindziestudio.com
set MINDZIE_API_TOKEN=your-api-token-here

macOS/Linux:

export MINDZIE_API_URL="https://www.mindziestudio.com"
export MINDZIE_API_TOKEN="your-api-token-here"

Persistente Configuratie

Voeg deze omgevingsvariabelen toe aan je shell-profiel (.bashrc, .zshrc of PowerShell profiel) voor blijvende instelling.

Cursor IDE

Cursor is een AI-gestuurde code-editor gebaseerd op VS Code.

Locatie configuratiebestand

Maak of bewerk .cursor/mcp.json in je home directory of project root:

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Alternatief: Instellingen UI

Open Cursor
Ga naar Instellingen (Ctrl/Cmd + ,)
Zoek op "MCP"
Klik op Bewerken in settings.json
Voeg de mindzie serverconfiguratie toe

Setup Verifiëren

Herstart Cursor na configuratie en controleer of mindzie-tools beschikbaar zijn in de AI-assistent.

Windsurf (Codeium)

Windsurf is de AI-aangedreven IDE van Codeium.

Locatie configuratiebestand

Maak of bewerk het MCP-configuratiebestand:

Windows:

%USERPROFILE%\.codeium\windsurf\mcp_config.json

macOS/Linux:

~/.codeium/windsurf/mcp_config.json

Configuratie

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Setup Verifiëren

Herstart Windsurf
Open het Cascade-paneel
De mindzie tools moeten beschikbaar zijn voor procesmining-aanvragen

VS Code met Continue Extensie

Continue is een open-source AI-codeerassistent voor VS Code.

Installeer Continue

Open VS Code
Ga naar Extensies (Ctrl/Cmd + Shift + X)
Zoek op "Continue" en installeer

Configureer MCP-server

Bewerk het configuratiebestand van Continue:

Windows:

%USERPROFILE%\.continue\config.json

macOS/Linux:

~/.continue/config.json

Voeg de MCP-server toe aan de mcpServers sectie:

{
  "mcpServers": [
    {
      "name": "mindzie",
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  ]
}

Setup Verifiëren

Herstart VS Code
Open het Continue-paneel
Typ /tools om beschikbare MCP-tools te zien, inclusief mindzie

Problemen oplossen

MCP-server maakt geen verbinding

Controleer Node.js-installatie: Voer node --version uit (moet 18+ zijn)
Test server handmatig: Voer npx -y @mindzie/mcp-server uit in terminal
Controleer omgevingsvariabelen: Zorg dat MINDZIE_API_URL en MINDZIE_API_TOKEN zijn ingesteld
Herstart de applicatie: Sluit volledig af en open opnieuw

Authenticatiefouten

Controleer je API-token: Tokens kunnen verlopen of ingetrokken zijn
Controleer token-permissies: Zorg dat het token toegang heeft tot de benodigde resources
Verifieer de URL: Bevestig dat MINDZIE_API_URL naar de juiste instantie verwijst

Tools verschijnen niet

Controleer configuratiesyntaxis: JSON moet geldig zijn (geen trailing commas)
Verifieer bestandslocatie: Configuratiebestand moet op de juiste plek staan
Controleer applicatielogs: Zoek naar MCP-gerelateerde foutmeldingen
Herstart volledig: Sommige apps cachen MCP-configuraties

Veelvoorkomende configuratiefouten

Fout	Oplossing
Ontbrekende `-y` vlag in npx args	Voeg `-y` toe om bevestiging over te slaan: `["-y", "@mindzie/mcp-server"]`
Trailing comma in JSON	Verwijder trailing commas in JSON-objecten
Verkeerde configuratiebestand-locatie	Controleer het pad voor jouw besturingssysteem
Token bevat speciale tekens	Zorg dat token correct gequoteerd wordt in JSON

Security Best Practices

Token nooit in versiebeheer - Gebruik omgevingsvariabelen of secret managers
Gebruik project-specifieke tokens - Maak aparte tokens per project
Draai tokens regelmatig om - Zeker in productieomgevingen
Beperk token-permissies - Alleen toegang tot benodigde resources
Monitor token gebruik - Controleer API toegang logs periodiek

Unified Discovery voor AI-assistenten

De unified categorie-parameter is speciaal ontworpen voor AI-assistenten. Wanneer een AI wil begrijpen welke analyse-mogelijkheden er zijn, kan het één enkele MCP-aanroep doen:

mindzie_list_block_types category="unified"

Dit retourneert alles wat de AI nodig heeft om:

Beschikbare mogelijkheden begrijpen: Alle filters, calculators en verrijkingen
Geschikte bloktypes selecteren: Gebaseerd op UsageFrequency en CommonUseCases
Koppelen aan documentatie: Elk bloktype bevat DocumentationUrl
Relaties identificeren: Het veld RelatedBlocks suggereert aanvullende bloktypes

Voorbeeld AI-werkstroom

Een AI-assistent die een gebruiker helpt bij het analyseren van procesduur kan:

mindzie_list_block_types category="unified" aanroepen om mogelijkheden te ontdekken
Bloktypes vinden waar CommonUseCases "duration" bevat
De CaseDurationCalculator en WaitTimeCalculator voorstellen
De juiste blokken met de API aanmaken
Uitvoeren en resultaten interpreteren

Referentie responsvelden

Bij gebruik van category="unified" bevat elk bloktype:

Veld	Beschrijving	Gebruik door AI
`OperatorName`	Technische identifier	Gebruik bij aanmaken blokken via API
`DisplayName`	Menselijke naam	Tonen aan gebruikers
`Description`	Korte omschrijving	Helpt gebruikers de bedoeling te begrijpen
`Category`	Functionele groepering	Organiseert suggesties
`BlockType`	Filter/Calculator/Verrijking	Bepaalt gebruikscontext
`DocumentationUrl`	Link naar documentatie	Haalt gedetailleerde info op
`UsageFrequency`	Hoog/Midden/Laag	Prioriteert veelgebruikte blokken
`CommonUseCases`	Voorbeeldscenario's	Matcht met gebruikersdoelen
`RelatedBlocks`	Gerelateerde bloktypes	Suggereren aanvullende blokken
`UsageNotes`	Extra aanwijzingen	Geeft context aan gebruikers

Best Practices

Voor AI-assistenten

Begin met unified discovery: Roep altijd eerst op met category="unified"
Cache de resultaten: Bloktypemetadata verandert weinig
Match gebruiksscenario’s: Gebruik het veld CommonUseCases om relevante blokken te vinden
Stel gerelateerde blokken voor: Gebruik RelatedBlocks om aanvullende analyses aan te bevelen

Voor ontwikkelaars

Beveilig je tokens: Toon API-tokens nooit in client-side code
Vraag juiste rechten aan: Vraag alleen benodigde permissies aan
Ga om met rate limits: Implementeer exponentiële backoff bij herhaalpogingen
Valideer responsen: Controleer op fouten vóór verwerking

Volgende stappen

Unified Block Types API - Directe API-documentatie
URL Generation API - Genereren van navigatie-URL's
AI Coding Tools Overzicht - Algemene AI-tool-integratie
Authenticatie - API authenticatie details