MCP-server

MCP-server

Met de MCP-server (Model Context Protocol) kunnen AI-assistenten en AI-tools verbinding maken met je ProcessMind-organisatie en rechtstreeks met procesdata werken. In plaats van een eigen integratie te bouwen, configureer je je MCP-client voor de ProcessMind-server. De assistent kan dan via standaard MCP-tools processen, modellen, rollen, gebruikers en processtatistieken lezen.

Wat is MCP?

MCP is een open standaard die beschrijft hoe AI-toepassingen (de ‘client’, zoals een AI-IDE of assistent) verbinding maken met externe databronnen en tools (de ‘server’). Je kunt het vergelijken met een USB-C-poort voor AI: één standaardverbinding geeft assistenten toegang tot allerlei tools en bronnen. ProcessMind biedt een MCP-server, zodat je bestaande AI-tools met de data van je organisatie kunt gebruiken zonder zelf verbindingscode te schrijven en te onderhouden.

Wat de MCP-server biedt

De server biedt toegang tot procesinhoud van je organisatie via MCP-tools en bronnen. Het gaat onder meer om:

• Processen en BPMN-modellen
• Rollen, RACI en gebruikers
• Documentatie en processtatistieken
• AI-analyses en antwoorden over processen
• Metadata van organisatie en omgeving

Welke tools beschikbaar zijn, hangt af van de configuratie van je omgeving. De server is gericht op modelleren, documenteren en analyseren. Werk zoals datasets uploaden, datamappings maken, simulaties uitvoeren en API-sleutels beheren is niet beschikbaar als MCP-tool en verloopt nog steeds via de REST API.

Vereisten

Zorg dat je dit bij de hand hebt voordat je verbinding maakt:

1. Een Enterprise-abonnement: de MCP-server is een functie van Enterprise
2. Een API-sleutel met toegang tot de omgevingen die je beschikbaar wilt maken: zie API-sleutels
3. Een MCP-compatibele client, zoals een AI-IDE of assistent die externe MCP-servers ondersteunt

Je MCP-client verbinden

De algemene configuratie is voor elke MCP-client hetzelfde:

1. Open de MCP-serverconfiguratie van je client
2. Voeg een externe server (HTTP) toe met de MCP-server-URL voor je omgeving
3. Vul je API-sleutel in bij de header Authorizationx-api-key
4. Sla de configuratie op en start je client opnieuw of maak opnieuw verbinding
5. Controleer de verbinding door je assistent te vragen je processen op te sommen

Een gebruikelijke configuratie ziet er zo uit:

{
	"mcpServers": {
		"processmind": {
			"url": "<mcp-server-url>",
			"headers": {
				"x-api-key": "<your-api-key>"
			}
		}
	}
}

Gebruik de MCP-server-URL voor je omgeving en vul je eigen API-sleutel in bij de header x-api-key. (OAuth-tokens voor clientgegevens worden ook ondersteund via het token-eindpunt.)

Beveiliging en aanbevolen werkwijzen

• Houd je API-sleutel geheim: zet de sleutel nooit in versiebeheer en maak deze niet zichtbaar in clientcode
• Beperk sleutels per omgeving: maak aparte sleutels voor MCP-toegang, zodat je ze afzonderlijk kunt intrekken
• Controleer het auditlog: acties via MCP worden uitgevoerd met je API-sleutel en verschijnen in het auditlog

Gerelateerde onderwerpen

• API-sleutels
• API-aanroepen
• API-referentie: Processen
• API-referentie: Data
• API-referentie: Simulaties