API-documentatie: MCP

Met de MCP-server kunnen AI-assistenten via het Model Context Protocol communiceren met ProcessMind. De server gebruikt JSON-RPC 2.0 via Streamable HTTP: stuur initialize en daarna tools/list om de lijst met tools op te vragen. Read-tools, zoals list_processes, worden alleen vermeld als de API-key leesrechten heeft. Voor write-tools zijn schrijfrechten nodig. Gebruik tools/call om een tool met argumenten aan te roepen. Met de memory-tools (remember, recall, forget) kun je gegevens bewaren voor andere sessies. Langlopende AI-generaties worden per toolaanroep bijgehouden: voeg een task-referentie toe in _meta["io.modelcontextprotocol/related-task"] en ProcessMind geeft de status van die task bij de aanroep terug. De extensiemethoden tasks/list, tasks/get en tasks/cancel worden niet aangeboden.

Endpoint van de Model Context Protocol-server (JSON-RPC via Streamable HTTP)

JSON-RPC 2.0 via Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Voor read-tools moet de key de scope read hebben; voor write-tools is scope write nodig. De lijst met tools staat in de MCP-gids. Verifieer met x-api-key of Authorization: Bearer <token> (token van het OAuth-tokenendpoint).

Endpoint: POST /v1/mcp/{tenantId}

Authenticatie: API-key voor één tenant · scope read · limiet 20 verzoeken/s (piek 40)

Parameters:

Naam	Type	Locatie	Verplicht	Beschrijving
tenantId	string	path	Ja	Indeling: uuid

Requestbody:

MCP JSON-RPC-verzoek

{}

Response (200):

MCP JSON-RPC-response

{
	"message": "string"
}

Veld	Type	Verplicht	Beschrijving
message	string	Ja

Fouten:

• 401 API-key ontbreekt, is ongeldig, uitgeschakeld of verlopen
• 403 De API-key heeft niet de vereiste scope of toegang tot de organisatie, de tenant is inactief of het abonnement staat dit bestandstype niet toe

OAuth 2.1-autorisatie-endpoint (PKCE), stuurt met een 302-redirect terug naar redirect_uri met ?code=…

Endpoint: GET /v1/mcp/{tenantId}/oauth/authorize

Authenticatie: Openbaar, geen API-key nodig · limiet 10 verzoeken/s (piek 20)

Parameters:

Naam	Type	Locatie	Verplicht	Beschrijving
tenantId	string	path	Ja	Indeling: uuid
client_id	string	query	Ja
redirect_uri	string	query	Ja	Indeling: uri
code_challenge	string	query	Ja
code_challenge_method	S256	query	Nee	Toegestane waarden: S256
state	string	query	Nee

Fouten:

• 302 Redirect naar redirect_uri met code + state
• 400 Ongeldig verzoek, bijvoorbeeld door een ongeldige filterexpressie, een proces zonder model, een niet-ondersteund uploadtype of een ontbrekend verplicht veld
• 401 API-key ontbreekt, is ongeldig, uitgeschakeld of verlopen

OAuth 2.0-tokenendpoint (client_credentials of authorization_code + PKCE)

Endpoint: POST /v1/mcp/{tenantId}/oauth/token

Authenticatie: Openbaar, geen API-key nodig · limiet 5 verzoeken/s (piek 10)

Parameters:

Naam	Type	Locatie	Verplicht	Beschrijving
tenantId	string	path	Ja	Indeling: uuid

Response (200):

Access-token

{
	"access_token": "string",
	"token_type": "Bearer",
	"expires_in": 0
}

Veld	Type	Verplicht	Beschrijving
access_token	string	Ja	Kort geldige Bearer JWT voor POST /v1/mcp/{tenantId}
token_type	Bearer	Ja	Toegestane waarden: Bearer
expires_in	number	Ja

Fouten:

• 400 Ongeldig verzoek, bijvoorbeeld door een ongeldige filterexpressie, een proces zonder model, een niet-ondersteund uploadtype of een ontbrekend verplicht veld
• 401 API-key ontbreekt, is ongeldig, uitgeschakeld of verlopen
• 403 De API-key heeft niet de vereiste scope of toegang tot de organisatie, de tenant is inactief of het abonnement staat dit bestandstype niet toe