Einen KI-Agenten verbinden

Geben Sie jedem KI-Agenten einen Satz, und er kann für Sie in mindzieStudio arbeiten. Claude Cowork, Claude Code, Codex, Cursor oder jeder andere: Er richtet Projekte und Benutzer ein, lädt Daten und arbeitet in AI Process Intelligence und BPM Studio, alles durch einfache Sprachbefehle.

Das ist der einzige Satz, den Sie ihm geben. Die verlinkte Seite ist für den Agenten geschrieben: Der Agent fragt, bei welchem mindzieStudio Sie sich anmelden und was erledigt werden soll, erarbeitet, wie er sich verbinden kann, und sagt Ihnen, wo Sie Ihren Schlüssel erstellen. Der Schlüssel wird niemals im Gespräch übermittelt: Sie geben ihn in die Connector-Einstellungen Ihres Agenten oder auf einer Seite ein, die der Agent in Ihrem Browser öffnet.

Was Ihr Agent tun kann und was er braucht

Was Sie vom Agenten wollen...	Welche Agenten	Schlüssel
In mindzieStudio arbeiten: Projekte erstellen, Benutzer hinzufügen und festlegen, wer welches Projekt sieht, Daten laden	Jeder Agent, einschließlich Claude Cowork und claude.ai	Mandanten-Schlüssel
In AI Process Intelligence und BPM Studio arbeiten: Projekte erstellen, starten und stoppen, Daten laden, innerhalb eines Projekts arbeiten, KI-Berichte, Zeitpläne und Warnungen erstellen, Diagramme bearbeiten	Alles davon, in jedem Agenten: Claude Cowork und claude.ai über den gehosteten MCP-Server, und Agenten, die Befehle ausführen können, wie Claude Code und Codex, über das mz-Tool oder den gehosteten Server	Mandanten-Schlüssel
Mandanten für andere Unternehmen erstellen	Jeder Agent	Globaler Schlüssel: nur Server-Administratoren und Partner

Hinter dem Satz gibt es zwei Zugangswege, und der Agent wählt den richtigen: den gehosteten MCP-Server, den jeder mindzieStudio-Server betreibt (nichts zu installieren), und das mz-Tool, das ein Agent, der Befehle ausführen kann, selbst installiert. Sie müssen nicht wählen. Details zu mz finden Sie unter Verbinden Sie Ihren eigenen Agenten.

Ihr Schlüssel

Ein Mandanten-Schlüssel reicht für alles oben Genannte. In mindzieStudio öffnen Sie das Menü unter Ihrem Namen, dann Administration > Einstellungen > API-Schlüssel, und klicken auf Neuen geheimen Schlüssel erstellen. Sie benötigen die Administratorrolle im Mandanten. Der Schlüssel wird nur einmal angezeigt, also kopieren Sie ihn sofort.

Ein Globaler API-Schlüssel öffnet alle Mandanten auf dem Server und kann neue Mandanten erstellen. Nur ein Serveradministrator kann einen erstellen (Menü unter Ihrem Namen, Server-Einstellungen > Globale API-Schlüssel), und nur Partner, die Mandanten für ihre Kunden einrichten, benötigen einen. Siehe Einrichten eines Kunden in einem Schritt.

Einrichtung des gehosteten MCP-Servers von Hand

Der Agent führt Sie selbst durch diesen Prozess. Dieser Abschnitt ist für den Fall, dass Sie es ohne Hilfe des Agenten machen möchten.

Die URL

Server	MCP-URL
mindzieStudio (US)	https://www.mindziestudio.com/mcp
mindzieStudio Europa	https://europe.mindziestudio.com/mcp
Ihr eigener Server	https://<Ihr Server>/mcp

Es gibt zwei Möglichkeiten, den Schlüssel zu übergeben:

Ihr Agent kann...	Eingeben
Einen Header mit einer URL senden (Claude Cowork, Claude Code, Cursor, VS Code, Agent-APIs)	URL https://www.mindziestudio.com/mcp und Header Authorization: Bearer <Ihr API-Schlüssel>
Nur eine URL verwenden	https://www.mindziestudio.com/mcp/k/<Ihr API-Schlüssel>

Behandeln Sie die zweite Form wie ein Passwort. Der Schlüssel ist Teil der URL, daher kann jeder, der die URL sieht, den Schlüssel verwenden. Fügen Sie ihn nicht in gemeinsame Dokumente oder Chats ein. Wenn er bekannt wird, löschen Sie den Schlüssel in mindzieStudio und erstellen Sie einen neuen.

Hinzufügen zu Ihrem Agenten

Claude Cowork / Claude Desktop-App

1. Öffnen Sie Einstellungen > Connectors (bei claude.ai: Anpassen > Connectors), wählen Sie Hinzufügen, dann Eigenen Connector hinzufügen. Connectoren gehören zu Ihrem Claude-Konto, also bekommen Cowork, die Desktop-App und claude.ai alle denselben.
2. Benennen Sie ihn mindzie und fügen Sie als URL https://www.mindziestudio.com/mcp ein.
3. Unter Authentifizierung wählen Sie Kein Login. Claude schlägt zuerst „Jetzt anmelden“ vor; mindzieStudio verwendet stattdessen einen API-Schlüssel, und der Autorisierungsheader kann erst nach Wahl von Kein Login hinzugefügt werden.
4. Unter Anfrage-Header fügen Sie den Header authorization mit dem Wert Bearer <Ihr API-Schlüssel> hinzu (das Wort Bearer, ein Leerzeichen, dann der Schlüssel).
5. Speichern. Claude listet die mindzie-Tools auf. Starten Sie ein neues Gespräch und fragen Sie: „Using mindzie, who am I connected as?“ Claude fragt vor jedem Tool-Aufruf um Erlaubnis.

Wenn Ihre Claude-Version keine Header-Option zeigt, verwenden Sie stattdessen https://www.mindziestudio.com/mcp/k/<Ihr API-Schlüssel> als URL.

Claude Code

claude mcp add --transport http mindzie https://www.mindziestudio.com/mcp --header "Authorization: Bearer <Ihr API-Schlüssel>"

Cursor / VS Code

Fügen Sie Ihrer MCP-Konfiguration (.cursor/mcp.json oder .vscode/mcp.json) Folgendes hinzu:

{
  "mcpServers": {
    "mindzie": {
      "url": "https://www.mindziestudio.com/mcp",
      "headers": { "Authorization": "Bearer <Ihr API-Schlüssel>" }
    }
  }
}

Grok, OpenAI und andere Agent-APIs

Agent-APIs, die entfernte MCP-Server unterstützen, benötigen eine Server-URL und einen Autorisierungswert. Verwenden Sie https://www.mindziestudio.com/mcp als URL und Bearer <Ihr API-Schlüssel> als Autorisierung. Wenn die API nur eine URL annimmt, verwenden Sie die Form /mcp/k/<Ihr API-Schlüssel>.

Verbindung prüfen

Bitten Sie Ihren Agenten, mindzie_whoami auszuführen. Er antwortet mit dem Server, den er erreicht hat, und ob der Schlüssel global ist (canManageTenants: true) oder auf einen Mandanten beschränkt (keyTenantId: der Mandant, den er öffnet).

Einen Kunden in einem Schritt einrichten

Dies benötigt einen globalen API-Schlüssel und ist für Partner, die Mandanten für ihre Kunden erstellen. Mit einem Mandanten-Schlüssel arbeitet Ihr Agent stattdessen innerhalb des eigenen Mandanten.

Das Tool mindzie_provision_tenant richtet einen Kunden komplett in einem Aufruf ein:

• erstellt den Mandanten,
• schaltet Module ein oder aus (Process Mining, Data Designer, BPM Studio, AI Process Intelligence),
• gibt dem Administrator Zugriff (ein bestehendes Konto wird wiederverwendet; ein neues wird erstellt),
• erstellt die Projekte, mit dem Administrator als Eigentümer, sodass dieser sie sofort sieht.

Beispiel-Prompt:

Using mindzie, provision a tenant named acme-corp with display name "Acme Corporation", 5 users and 2 analysts. Turn on Process Mining and Data Designer, and turn off BPM Studio and AI Process Intelligence. The admin is jane@acme.com (Jane Smith). Create the projects "Purchase to Pay" and "Order to Cash".

Es wird keine E-Mail gesendet. Ein neues Admin-Konto wird ohne Passwort erstellt; der Admin meldet sich an, indem er auf der Anmeldeseite Passwort vergessen wählt, oder Sie teilen ihm sein erstes Passwort mit, falls Sie eines vergeben.

Viele Kunden auf einmal

Geben Sie dem Agenten die Liste (z.B. eine Tabelle mit Firmennamen, Admin-E-Mails und Modulen) und bitten Sie ihn, jeden einzurichten und das Ergebnis pro Kunde zu berichten. Falls ein Lauf zwischendurch stoppt, bitten Sie ihn, mit resumeExisting erneut zu starten für die Kunden, die bereits existieren: erledigte Schritte werden als bestehend gemeldet und nichts wird doppelt ausgeführt.

Daten laden

Verwenden Sie mindzie_upload_dataset_from_url mit einem https-Link zu einer CSV-Datei von bis zu 1 GB, beispielsweise einen Cloud-Speicher-Link mit einem Lesetoken. Der mindzieStudio-Server lädt die Datei selbst herunter, große Dateien werden also nie durch den Chat übertragen. Der Link muss öffentlich erreichbar sein; Links zu privaten oder internen Netzwerkadressen werden abgelehnt.

Für einige tausend Zeilen können Sie auch den CSV-Text mit mindzie_upload_dataset_csv_text einfügen.

Verfügbare Tools

Tool	Was es tut	Schlüssel benötigt
mindzie_whoami	Server- und Schlüsselinformationen	Jeder
mindzie_provision_tenant	Mandant, Module, Admin und Projekte in einem Aufruf	Global
mindzie_list_projects, mindzie_get_project, mindzie_create_project, mindzie_update_project, mindzie_delete_project	mindzieStudio-Projekte	Global oder Mandant
mindzie_list_project_members, mindzie_add_project_member	Wer ein Projekt sehen darf	Global oder Mandant
mindzie_list_datasets, mindzie_upload_dataset_csv_text, mindzie_upload_dataset_from_url	Datensätze	Global oder Mandant

Neben diesen bietet der Server die gleichen Tools wie der mz-Befehlszeilenbefehl, generiert aus denselben Spezifikationen, sodass sich die beiden nie auseinanderentwickeln können. Jedes ist eine Gruppe von Befehlen, die mit einer method und ihren params aufgerufen werden; die Methode describe listet die Parameter einer Methode auf.

Tool	Was es tut	Schlüssel benötigt
projects, projects_backups, projects_keys, projects_reports	AI Process Intelligence Projekte: erstellen, starten, stoppen, umbenennen, skalieren, löschen, aus Datei importieren; Backups und Restore; veröffentlichte Berichte erneut ausführen	Mandant
cube_log, cube_files, cube_data, cube_eventlogs, cube_schema, cube_build, cube_filters, cube_enrichments, cube_rules, cube_calendar, cube_costs, cube_jobs, cube_reports, cube_schedules, cube_alerts, cube_styles und weitere	Alles innerhalb eines Projekt-Cubes: Daten hochladen und laden, Event-Log abfragen, Filter, Anreicherungen, Regeln, Schema, KI-Berichts-Jobs, veröffentlichte Berichte, Zeitpläne und Warnungen. Jede Methode benötigt pi_project_id; das Projekt muss laufen	Mandant
bpmn_diagrams, bpmn_comments, bpmn_approvals, bpmn_audit, bpmn_ai, bpmn_ai_files	BPM Studio: Modelle, Revisionen, Kommentare, Genehmigungen, Audit-Log, KI-Untersuchungen aus Bild oder SOP	Mandant, oder global mit tenant_id
studio_projects, studio_projects_members	Die Projekte, in denen BPM Studio arbeitet, und deren Mitglieder	Mandant, oder global mit tenant_id
tenants, tenants_settings, users, users_tenant	Mandanten, ihre Einstellungen und Module, Benutzer	Global

Löschungen benötigen den exakten Namen des Lösch-Objekts. KI-Arbeit – ein KI-Bericht, einen Bericht erneut ausführen, eine BPM Studio KI-Untersuchung – verwendet die AI-Credits des Mandanten.

Jedes Tool folgt genau denselben Regeln wie die REST API: dieselben Berechtigungen, Validierungen und Fehlermeldungen.

Gut zu wissen

• Ein leerer Mandant hat die Standardmodule des Servers, die möglicherweise nicht den Erwartungen eines Kunden entsprechen. Verwenden Sie mindzie_provision_tenant oder setzen Sie die Module explizit mit der Methode update von tenants_settings.
• Ein Projekt ist nur für seine Mitglieder sichtbar. Ein Projekt, das mit mindzie_create_project erstellt wird, hat keine Mitglieder, bis Sie welche mit mindzie_add_project_member hinzufügen. mindzie_provision_tenant erledigt das für Sie.
• Löschen ist dauerhaft. Ein guter Agent fragt Sie zuerst. Die Lösch-Tools verlangen die exakten Namen.
• Jeder Tool-Aufruf wird auf dem Server mit dem Namen des API-Schlüssels protokolliert, der ihn ausgeführt hat.

Fehlerbehebung

Was Sie sehen	Warum	Was zu tun ist
HTTP 401 / „unauthorized“ beim Verbinden	Der Schlüssel ist falsch, gelöscht oder für einen anderen Server (jede Region hat eigene Schlüssel)	Erstellen Sie einen Schlüssel auf dem Server, mit dem Sie sich verbinden
„requires a Global API key“	Ein Mandanten-Schlüssel wurde für ein Tool verwendet, das mandantenübergreifend arbeitet (Mandanten auflisten, erstellen, ändern oder löschen; Mandanteneinstellungen oder Module)	Diese Tools sind nur für Server-Administratoren und Partner, die Mandanten einrichten. Arbeiten Sie innerhalb Ihres eigenen Mandanten mit den Projekt-, Benutzer- und Datensatz-Tools. Wenn Sie Mandanten für andere Firmen erstellen, siehe Einrichten eines Kunden in einem Schritt
„driven with a TENANT API key, never a global one“	Ein globaler Schlüssel wurde bei einem Process-Intelligence- oder cube_-Tool verwendet	Erstellen Sie einen Mandanten-Schlüssel im Mandanten des Projekts und verbinden Sie sich damit
„does not have access to tenant“	Die Mandanten-ID stimmt nicht mit der des Schlüssels überein	Verwenden Sie keyTenantId aus mindzie_whoami
Der Admin meldet sich an und sieht keine Projekte	Er ist kein Mitglied der Projekte	mindzie_add_project_member oder Provision mit mindzie_provision_tenant
„already exists“ bei Provision	Der Mandantenname ist bereits vergeben	Wenn es derselbe Kunde ist, starten Sie erneut mit resumeExisting, sonst wählen Sie einen anderen Namen
„non-public address“ beim Laden von Daten	Der Link verweist auf eine private oder interne Netzwerkadresse	Verwenden Sie einen öffentlich erreichbaren https-Link