MCP-Server

Model Context Protocol Integration

Der mindzieAPI MCP-Server ermöglicht es KI-Coding-Assistenten, programmatisch mit mindzieStudio zu interagieren. MCP (Model Context Protocol) bietet eine standardisierte Möglichkeit für KI-Tools, auf externe Funktionen zuzugreifen.

Verfügbare Werkzeuge

Der MCP-Server stellt folgende Werkzeuge für KI-Assistenten bereit:

mindzie_list_block_types

Abrufen von Informationen über verfügbare Blocktypen (Filter, Rechner, Anreicherungen).

Parameter

Parameter Typ Erforderlich Beschreibung
category String Nein Filter nach Kategorie: "filters", "calculators", "unified" oder weglassen für nur Filter

Kategorie-Optionen

Wert Gibt zurück
"filters" Nur Filter-Blocktypen (Standard)
"calculators" Nur Rechner-Blocktypen
"unified" Alle Blocktypen einschließlich Anreicherungen, gruppiert nach Kategorie

Beispiel: Alle Blocktypen abrufen (Empfohlen)

mindzie_list_block_types category="unified"

Gibt vollständige Metadaten für alle Blocktypen zurück:

{
  "BlockTypes": [
    {
      "OperatorName": "CaseAttributeFilter",
      "DisplayName": "Case Attribute Filter",
      "Description": "Filter cases based on attribute values",
      "Category": "Attribute Filters",
      "BlockType": "Filter",
      "DocumentationUrl": "/mindzie_studio/filters/case-attribute-filter",
      "UsageFrequency": "High",
      "CommonUseCases": ["Filter by customer segment", "Focus on specific regions"]
    },
    {
      "OperatorName": "CaseDurationCalculator",
      "DisplayName": "Case Duration Calculator",
      "Description": "Calculate the total duration of cases",
      "Category": "Time Calculators",
      "BlockType": "Calculator",
      "DocumentationUrl": "/mindzie_studio/calculators/case-duration-calculator",
      "UsageFrequency": "High",
      "CommonUseCases": ["Analyze cycle times", "Identify slow cases"]
    },
    {
      "OperatorName": "CaseStageCalculator",
      "DisplayName": "Case Stage Calculator",
      "Description": "Assign stage labels to cases based on activity patterns",
      "Category": "Stage Analysis",
      "BlockType": "Enrichment",
      "DocumentationUrl": "/mindzie_studio/enrichments/case-stage-calculator",
      "UsageFrequency": "Medium",
      "CommonUseCases": ["Track case progress", "Monitor stage transitions"]
    }
  ],
  "Categories": ["Attribute Filters", "Time Filters", "Time Calculators", "Stage Analysis"],
  "TotalCount": 45,
  "ByBlockCategory": {
    "Filter": [...],
    "Calculator": [...],
    "Enrichment": [...]
  }
}

Beispiel: Nur Filter abrufen

mindzie_list_block_types category="filters"

Beispiel: Nur Rechner abrufen

mindzie_list_block_types category="calculators"

mindzie_list_projects

Listet verfügbare Projekte im aktuellen Mandanten auf.

Parameter

Parameter Typ Erforderlich Beschreibung
tenant_id String Ja Der Mandanten-Identifikator

mindzie_get_project

Holt Details zu einem bestimmten Projekt.

Parameter

Parameter Typ Erforderlich Beschreibung
tenant_id String Ja Der Mandanten-Identifikator
project_id String Ja Der Projekt-Identifikator

mindzie_execute_block

Führt einen Block aus und gibt Ergebnisse zurück.

Parameter

Parameter Typ Erforderlich Beschreibung
tenant_id String Ja Der Mandanten-Identifikator
project_id String Ja Der Projekt-Identifikator
block_id String Ja Der auszuführende Block

mindzie_generate_url

Erzeugt URLs zu mindzieStudio-Seiten und -Entitäten für Navigation oder Teilen.

Parameter

Parameter Typ Erforderlich Beschreibung
type String Ja URL-Typ (siehe URL-Typen unten)
entity_id String Bedingt Entitäten-ID für entitätsspezifische Seiten
parent_id String Bedingt Übergeordnete ID (projectId oder notebookId)

URL-Typen

Listen-Seiten (keine entity_id erforderlich):

Typ parent_id Beschreibung
projects - Projektliste
apps - App-Liste
investigations projectId Untersuchungen für ein Projekt
dashboards-list projectId Dashboard-Liste für ein Projekt
datasets projectId Datensätze für ein Projekt
actions projectId Aktionen für ein Projekt
bpmn projectId BPMN-Editor für ein Projekt

Entitäten-Seiten (entity_id erforderlich):

Typ entity_id parent_id Beschreibung
dashboard dashboardId - Einzelnes Dashboard
analysis notebookId - Notebook/Analyse-Seite
block blockId notebookId Spezifischer Block
enrichment enrichmentId projectId (optional) Anreicherungs-Notebook

Beispiel: Dashboard-URL abrufen

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

Gibt zurück:

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

Beispiel: Block-URL abrufen

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

Beispiel: URL für Untersuchungen-Liste abrufen

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

Voraussetzungen

Bevor Sie den MCP-Server einrichten, stellen Sie sicher, dass Sie Folgendes haben:

  1. Node.js 18 oder höher – Heruntergeladen von nodejs.org
  2. Einen mindzie API-Token – Erzeugt in den Einstellungen Ihres mindzieStudio-Accounts
  3. Die URL Ihrer mindzieStudio-Instanz – Entweder https://www.mindziestudio.com (Cloud) oder Ihre On-Premise-URL

Installation

Der mindzie MCP-Server wird automatisch via npx installiert – keine manuelle Installation notwendig:

npx -y @mindzie/mcp-server

Umgebungsvariablen

Variable Erforderlich Beschreibung
MINDZIE_API_URL Ja Die URL Ihrer mindzieStudio-Instanz
MINDZIE_API_TOKEN Ja Ihr API-Authentifizierungstoken

Einrichtung nach Anwendung

Claude Desktop

Claude Desktop ist die Desktop-Anwendung von Anthropic für Claude AI.

Windows-Konfiguration

Bearbeiten Sie die Konfigurationsdatei unter:

%APPDATA%\Claude\claude_desktop_config.json

Fügen Sie den mindzie MCP-Server hinzu:

{
  "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-Konfiguration

Bearbeiten Sie die Konfigurationsdatei unter:

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

Fügen Sie dieselbe Konfiguration wie unter Windows hinzu.

Nach der Konfiguration

  1. Speichern Sie die Konfigurationsdatei
  2. Starten Sie Claude Desktop komplett neu (beenden und erneut öffnen)
  3. Suchen Sie im Chat-Interface nach dem Hammer-Symbol – dies zeigt an, dass MCP-Werkzeuge verfügbar sind

Claude Code (CLI)

Claude Code ist die Kommandozeilenschnittstelle von Anthropic für Claude AI.

MCP-Server hinzufügen

Führen Sie diesen Befehl aus, um den mindzie MCP-Server zu registrieren:

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

Umgebungsvariablen setzen

Windows (PowerShell):

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

Windows (Eingabeaufforderung):

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 Konfiguration

Fügen Sie die Umgebungsvariablen zu Ihrem Shell-Profil (.bashrc, .zshrc oder PowerShell-Profil) hinzu, damit sie dauerhaft gesetzt sind.

Cursor IDE

Cursor ist ein KI-gestützter Code-Editor basierend auf VS Code.

Konfigurationsdatei

Erstellen oder bearbeiten Sie .cursor/mcp.json im Home-Verzeichnis oder Projekt-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"
      }
    }
  }
}

Alternative: Einstellungen UI

  1. Öffnen Sie Cursor
  2. Gehen Sie zu Einstellungen (Strg/Cmd + ,)
  3. Suchen Sie nach "MCP"
  4. Klicken Sie auf In settings.json bearbeiten
  5. Fügen Sie die mindzie-Server-Konfiguration hinzu

Setup überprüfen

Nach der Konfiguration starten Sie Cursor neu und prüfen, ob mindzie-Werkzeuge für den KI-Assistenten verfügbar sind.

Windsurf (Codeium)

Windsurf ist die KI-gestützte IDE von Codeium.

Konfigurationsdatei

Erstellen oder bearbeiten Sie die MCP-Konfigurationsdatei:

Windows:

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

macOS/Linux:

~/.codeium/windsurf/mcp_config.json

Konfiguration

{
  "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 überprüfen

  1. Starten Sie Windsurf neu
  2. Öffnen Sie das Cascade-Panel
  3. Die mindzie-Werkzeuge sollten für Process-Mining-Abfragen verfügbar sein

VS Code mit Continue Extension

Continue ist ein Open-Source KI-Coding-Assistent für VS Code.

Continue installieren

  1. Öffnen Sie VS Code
  2. Gehen Sie zu Erweiterungen (Strg/Cmd + Umschalt + X)
  3. Suchen Sie nach „Continue“ und installieren Sie es

MCP-Server konfigurieren

Bearbeiten Sie die Konfigurationsdatei von Continue:

Windows:

%USERPROFILE%\.continue\config.json

macOS/Linux:

~/.continue/config.json

Fügen Sie den MCP-Server zum Abschnitt mcpServers hinzu:

{
  "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 überprüfen

  1. Starten Sie VS Code neu
  2. Öffnen Sie das Continue-Panel
  3. Geben Sie /tools ein, um verfügbare MCP-Werkzeuge einschließlich mindzie zu sehen

Fehlerbehebung

MCP-Server verbindet nicht

  1. Node.js-Installation überprüfen: Führen Sie node --version aus (muss 18+ sein)
  2. Server manuell testen: Führen Sie npx -y @mindzie/mcp-server im Terminal aus
  3. Umgebungsvariablen prüfen: Stellen Sie sicher, dass MINDZIE_API_URL und MINDZIE_API_TOKEN gesetzt sind
  4. Anwendung neu starten: Schließen und öffnen Sie diese vollständig neu

Authentifizierungsfehler

  1. API-Token überprüfen: Tokens können ablaufen oder widerrufen werden
  2. Token-Berechtigungen prüfen: Stellen Sie sicher, dass der Token Zugriff auf die erforderlichen Ressourcen hat
  3. URL überprüfen: Vergewissern Sie sich, dass MINDZIE_API_URL auf Ihre korrekte Instanz verweist

Werkzeuge erscheinen nicht

  1. Konfigurationssyntax prüfen: Stellen Sie sicher, dass das JSON gültig ist (keine nachgestellten Kommas)
  2. Dateipfad prüfen: Konfigurationsdatei muss am richtigen Ort liegen
  3. Anwendungsprotokolle ansehen: Suchen Sie nach MCP-bezogenen Fehlermeldungen
  4. Komplett neu starten: Einige Anwendungen cachen MCP-Konfigurationen

Häufige Konfigurationsfehler

Fehler Lösung
Fehlendes -y Flag in npx-Argumenten Fügen Sie -y hinzu, um die Bestätigung zu überspringen: ["-y", "@mindzie/mcp-server"]
Nachgestelltes Komma im JSON Entfernen Sie nachgestellte Kommas aus JSON-Objekten
Falscher Speicherort der Konfigurationsdatei Überprüfen Sie den Pfad für Ihr Betriebssystem
Token enthält Sonderzeichen Stellen Sie sicher, dass der Token im JSON korrekt in Anführungszeichen steht

Sicherheitsrichtlinien

  1. Tokens niemals in Versionskontrolle speichern – Verwenden Sie Umgebungsvariablen oder Secrets-Manager
  2. Projekt-spezifische Tokens verwenden – Erstellen Sie für unterschiedliche Projekte separate Tokens
  3. Tokens regelmäßig rotieren – Besonders in Produktionsumgebungen
  4. Token-Berechtigungen einschränken – Gewähren Sie nur notwendige Zugriffsrechte
  5. Token-Nutzung überwachen – Überprüfen Sie API-Zugriffsprotokolle regelmäßig

Einheitliche Entdeckung für KI-Assistenten

Der unified Kategorien-Parameter ist speziell für KI-Assistenten gedacht. Wenn eine KI verstehen möchte, welche Analysefähigkeiten verfügbar sind, kann sie einen einzigen MCP-Aufruf machen:

mindzie_list_block_types category="unified"

Dies liefert alles, was die KI benötigt, um:

  1. Verfügbare Fähigkeiten verstehen: Alle Filter, Rechner und Anreicherungen
  2. Geeignete Blocktypen auswählen: Basierend auf UsageFrequency und CommonUseCases
  3. Verlinkung zur Dokumentation: Jeder Blocktyp enthält DocumentationUrl
  4. Beziehungen erkennen: Das Feld RelatedBlocks schlägt ergänzende Blocktypen vor

Beispielhafter KI-Workflow

Ein KI-Assistent, der Nutzer bei der Analyse der Prozessdauer unterstützt, könnte:

  1. mindzie_list_block_types category="unified" aufrufen, um Fähigkeiten zu entdecken
  2. Blocktypen finden, bei denen CommonUseCases „Dauer“ enthält
  3. CaseDurationCalculator und WaitTimeCalculator vorschlagen
  4. Die passenden Blöcke über die API erstellen
  5. Ergebnisse ausführen und interpretieren

Referenz der Antwortfelder

Bei Verwendung von category="unified" enthält jeder Blocktyp:

Feld Beschreibung Nutzung durch KI
OperatorName Technischer Bezeichner Für Blockerstellung via API
DisplayName Menschlich lesbarer Name Anzeigen für Nutzer
Description Kurze Beschreibung Nutzerverständnis unterstützen
Category Funktionale Gruppierung Für Vorschläge organisieren
BlockType Filter/Rechner/Anreicherung Nutzungskontext bestimmen
DocumentationUrl Link zur Dokumentation Detaillierte Informationen abrufen
UsageFrequency Hoch/Mittel/Niedrig Häufige Blöcke priorisieren
CommonUseCases Beispiel-Szenarien Zu Nutzerzielen passen
RelatedBlocks Verwandte Blocktypen Komplementäre Blöcke vorschlagen
UsageNotes Zusätzliche Hinweise Kontext für Nutzer bieten

Best Practices

Für KI-Assistenten

  1. Immer mit unified discovery starten: Erstaufruf mit category="unified"
  2. Ergebnisse cachen: Blocktypen-Metadaten ändern sich selten
  3. Use Cases abgleichen: CommonUseCases zur Blockauswahl nutzen
  4. Verwandte Blöcke vorschlagen: RelatedBlocks für ergänzende Analysen verwenden

Für Entwickler

  1. Tokens sicher aufbewahren: API-Tokens niemals im clientseitigen Code offenlegen
  2. Passende Berechtigungen verwenden: Nur notwendige Scopes anfragen
  3. Rate Limits handhaben: Implementieren Sie exponentielles Backoff bei Wiederholungen
  4. Antworten validieren: Prüfen Sie Fehler, bevor Sie Ergebnisse verarbeiten

Nächste Schritte