Verbind een AI Agent

Geef elke AI-agent één zin, en hij kan voor je werken in mindzieStudio. Claude Cowork, Claude Code, Codex, Cursor of een andere: hij stelt projecten en gebruikers in, laadt data en werkt in AI Process Intelligence en BPM Studio, allemaal door in gewone taal te worden gevraagd.

Die zin is alles wat je hem geeft. De pagina waarnaar hij verwijst is geschreven voor de agent: de agent vraagt op welke mindzieStudio je inlogt en wat je gedaan wilt hebben, bedenkt hoe hij verbinding kan maken en vertelt je waar je je sleutel moet maken. De sleutel komt nooit in het gesprek voor: je stopt hem in de connectorinstellingen van je agent, of in een pagina die de agent in je browser opent.

Wat Je Agent Kan Doen, en Wat Hij Nodig Heeft

Je wilt dat de agent...	Welke agents	Sleutel
Werkt in mindzieStudio: projecten aanmaken, gebruikers toevoegen en bepalen wie welk project ziet, data laden	Elke agent, inclusief Claude Cowork en claude.ai	Tenant-sleutel
Werkt in AI Process Intelligence en BPM Studio: projecten aanmaken, starten en stoppen, data laden, werken binnen een project, AI-rapporten, schema’s en meldingen maken, diagrammen bewerken	Alles, in elke agent: Claude Cowork en claude.ai via de gehoste MCP-server, en agents die opdrachten kunnen uitvoeren, zoals Claude Code en Codex, via het mz-gereedschap of de gehoste server	Tenant-sleutel
Tenants aanmaken voor andere bedrijven	Elke agent	Globale sleutel: alleen voor serverbeheerders en partners

Achter die zin schuilen twee toegangsmogelijkheden, en de agent kiest de juiste: de gehoste MCP-server die elke mindzieStudio-server draait (niets te installeren), en het mz-gereedschap dat een agent die opdrachten kan uitvoeren zelf installeert. Je hoeft niet te kiezen. Voor de details van mz zie Connect Your Own Agent.

Je Sleutel

Één tenant-sleutel dekt alles hierboven af. Open in mindzieStudio het menu onder je naam, ga naar Administratie > Instellingen > API-sleutels en klik op Nieuwe geheime sleutel aanmaken. Je hebt de rol Administrator binnen de tenant nodig. De sleutel wordt één keer getoond, kopieer hem dus meteen.

Een Global API key opent elke tenant op de server en kan nieuwe tenants aanmaken. Alleen een serverbeheerder kan zo’n sleutel maken (menu onder je naam, Serverinstellingen > Global API Keys), en alleen partners die tenants voor hun klanten inrichten hebben die nodig. Zie Setting Up a Customer in One Step.

Het Handmatig Instellen van de Gehoste MCP-Server

De agent begeleidt je hier vanzelf doorheen. Deze sectie is voor wanneer je het zonder hulp van de agent wilt doen.

De URL

Server	MCP URL
mindzieStudio (VS)	https://www.mindziestudio.com/mcp
mindzieStudio Europa	https://europe.mindziestudio.com/mcp
Je eigen server	https://<your server>/mcp

Er zijn twee manieren om de sleutel door te geven:

Je agent kan...	Invoeren
Een header versturen met een URL (Claude Cowork, Claude Code, Cursor, VS Code, agent-API’s)	URL https://www.mindziestudio.com/mcp en header Authorization: Bearer <your API key>
Alleen een URL gebruiken	https://www.mindziestudio.com/mcp/k/<your API key>

Behandel de tweede vorm als een wachtwoord. De sleutel maakt deel uit van de URL, dus iedereen die de URL ziet kan de sleutel gebruiken. Plak hem niet in gedeelde documenten of chats. Als hij uitlekt, verwijder dan de sleutel in mindzieStudio en maak een nieuwe aan.

Toevoegen aan Je Agent

Claude Cowork / Claude desktop-app

1. Open Instellingen > Connectors (op claude.ai: Aanpassen > Connectors), kies Toevoegen, dan Aangepaste connector toevoegen. Connectors horen bij je Claude-account, dus Cowork, desktop-app en claude.ai krijgen hem allemaal.
2. Noem hem mindzie, en plak als URL https://www.mindziestudio.com/mcp.
3. Kies onder Authenticatie voor Geen aanmelding. Claude stelt eerst voor "Nu aanmelden"; mindzieStudio gebruikt in plaats daarvan een API-sleutel, en de autorisatie-header kan pas worden toegevoegd als je Geen aanmelding kiest.
4. Voeg onder Request headers de header authorization toe met waarde Bearer <your API key> (het woord Bearer, een spatie, dan de sleutel).
5. Opslaan. Claude toont de mindzie-tools. Begin een nieuw gesprek en vraag: "Using mindzie, who am I connected as?" Claude vraagt toestemming voordat het een tool aanroept.

Als je Claude-versie geen optie voor headers toont, gebruik dan https://www.mindziestudio.com/mcp/k/<your API key> als URL.

Claude Code

claude mcp add --transport http mindzie https://www.mindziestudio.com/mcp --header "Authorization: Bearer <your API key>"

Cursor / VS Code

Voeg toe aan je MCP-configuratie (.cursor/mcp.json of .vscode/mcp.json):

{
  "mcpServers": {
    "mindzie": {
      "url": "https://www.mindziestudio.com/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

Grok, OpenAI en andere agent-API’s

Agent-API’s die gehoste MCP-servers ondersteunen, nemen een server-URL en een autorisatiewaarde aan. Gebruik https://www.mindziestudio.com/mcp als URL en Bearer <your API key> als autorisatie. Als de API alleen een URL accepteert, gebruik dan de /mcp/k/<your API key> vorm.

Controleer de verbinding

Vraag je agent om mindzie_whoami uit te voeren. Hij antwoordt met de server die hij heeft bereikt en of de sleutel globaal is (canManageTenants: true) of beperkt tot één tenant (keyTenantId: de tenant die hij opent).

Een Klant Snel Inrichten

Dit vereist een Global API key, en is bedoeld voor partners die tenants voor hun klanten aanmaken. Met een tenant key werkt je agent binnen je eigen tenant.

Het mindzie_provision_tenant-gereedschap richt een klant in met één enkele call:

• maakt de tenant aan,
• zet modules aan of uit (Process Mining, Data Designer, BPM Studio, AI Process Intelligence),
• geeft de beheerder toegang (een bestaand account wordt hergebruikt; anders wordt er één gemaakt),
• maakt de projecten aan, met de beheerder als eigenaar, zodat die ze meteen ziet.

Voorbeeldprompt:

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

Er wordt geen e-mail verzonden. Er wordt een nieuw admin-account aangemaakt zonder wachtwoord; de admin logt in door op de inlogpagina op Wachtwoord vergeten te klikken, of je geeft de eerste wachtwoord door als je die instelt.

Meerdere klanten tegelijk

Geef de agent de lijst (bijvoorbeeld een spreadsheet van bedrijfsnamen, admin-e-mails en modules) en vraag hem elke tenant in te richten en per klant te rapporteren. Als een run halverwege stopt, vraag dan om opnieuw te starten met resumeExisting voor klanten die al bestaan: uitgevoerde stappen worden als bestaand gemeld en niets wordt duplicaat.

Data laden

Gebruik mindzie_upload_dataset_from_url met een https-link naar een CSV-bestand tot 1 GB, bijvoorbeeld een cloudopslaglink met een leestoegangstoken. De mindzieStudio-server downloadt het bestand zelf, dus grote bestanden gaan nooit via de chat. De link moet publiek bereikbaar zijn; links naar privé- of intern netwerk worden geweigerd.

Voor een paar duizend rijen kun je ook de CSV-tekst plakken met mindzie_upload_dataset_csv_text.

Beschikbare Tools

Tool	Wat het doet	Nodige sleutel
mindzie_whoami	Server- en sleutelinformatie	Elke sleutel
mindzie_provision_tenant	Tenant, modules, admin en projecten in één call	Globale sleutel
mindzie_list_projects, mindzie_get_project, mindzie_create_project, mindzie_update_project, mindzie_delete_project	mindzieStudio-projecten	Globale of tenant-sleutel
mindzie_list_project_members, mindzie_add_project_member	Wie een project kan zien	Globale of tenant-sleutel
mindzie_list_datasets, mindzie_upload_dataset_csv_text, mindzie_upload_dataset_from_url	Datasets	Globale of tenant-sleutel

Naast deze biedt de server dezelfde tools als het mz-commandoregelgereedschap, gegenereerd uit dezelfde specificaties, zodat ze nooit uiteenlopen. Elk is een groep opdrachten, aangeroepen met een method en zijn params; de methode describe toont de parameters van een methode.

Tool	Wat het doet	Nodige sleutel
projects, projects_backups, projects_keys, projects_reports	AI Process Intelligence-projecten: aanmaken, starten, stoppen, hernoemen, grootte wijzigen, verwijderen, importeren; backups en herstellen; opnieuw uitvoeren van gepubliceerd rapport	Tenant-sleutel
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 en de rest	Alles binnen één projectcube: data uploaden en laden, eventlog opvragen, filters, verrijkingen, regels, schema, AI-rapportjobs, gepubliceerde rapporten, schema’s en meldingen. Elke methode neemt pi_project_id; het project moet actief zijn	Tenant-sleutel
bpmn_diagrams, bpmn_comments, bpmn_approvals, bpmn_audit, bpmn_ai, bpmn_ai_files	BPM Studio: modellen, revisies, opmerkingen, goedkeuringen, het auditlog, AI-onderzoeken op basis van een afbeelding of SOP	Tenant-sleutel, of globaal met tenant_id
studio_projects, studio_projects_members	De projecten waarin BPM Studio werkt en hun leden	Tenant-sleutel, of globaal met tenant_id
tenants, tenants_settings, users, users_tenant	Tenants, hun instellingen en modules, gebruikers	Globale sleutel

Verwijderen vereist de exacte naam van wat verwijderd wordt. AI-werk — een AI-rapport, het opnieuw uitvoeren van een rapport of een BPM Studio AI-onderzoek — verbruikt de AI-tegoeden van de tenant.

Elke tool volgt precies dezelfde regels als de REST API: dezelfde permissies, validatie en foutmeldingen.

Handig om te Weten

• Een kale tenant heeft de standaardmodules van de server, wat mogelijk niet is wat een klant verwacht. Gebruik mindzie_provision_tenant of stel modules expliciet in met de tenants_settings methode update.
• Een project is alleen zichtbaar voor zijn leden. Een project aangemaakt met mindzie_create_project heeft geen leden totdat je die toevoegt met mindzie_add_project_member. mindzie_provision_tenant doet dit automatisch.
• Verwijderen is definitief. Een goede agent vraagt eerst je bevestiging; de verwijdertools vereisen de exacte namen.
• Elke tool-aanroep wordt gelogd op de server met de naam van de API-sleutel die de aanroep deed.

Probleemoplossing

Wat je ziet	Waarom	Wat te doen
HTTP 401 / "unauthorized" bij verbinden	De sleutel is fout, verwijderd of voor een andere server (ieder regio heeft zijn eigen sleutels)	Maak een sleutel aan op de server waarmee je verbindt
"requires a Global API key"	Er is een tenant-sleutel gebruikt voor een tool die werkt over tenants heen (list, create, wijzigen of verwijderen van tenants, tenantinstellingen of modules)	Die tools zijn voor serverbeheerders en partners die tenants instellen. Werk binnen je eigen tenant met project-, gebruiker- en dataset-tools. Als je wel tenants aanmaakt voor andere bedrijven, zie Setting Up a Customer in One Step
"driven with a TENANT API key, never a global one"	Er is een globale sleutel gebruikt op een Process Intelligence of cube_ tool	Maak een tenant-sleutel aan in de tenant waar het project in zit en verbind daarmee
"does not have access to tenant"	De tenant-id is niet de tenant van de sleutel	Gebruik keyTenantId van mindzie_whoami
De admin logt in en ziet geen projecten	De admin is geen lid van de projecten	Gebruik mindzie_add_project_member, of richt in met mindzie_provision_tenant
"already exists" bij provision	De tenantnaam is al in gebruik	Als het dezelfde klant is, voer opnieuw uit met resumeExisting; anders kies een andere naam
"non-public address" bij het laden van data	De link wijst naar een privé- of intern netwerk	Gebruik een publiek bereikbare https-link