API-referentie: 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 toolcatalogus op te vragen. Read-tools zoals list_processes worden alleen weergegeven wanneer de API-sleutel de read-scope heeft. Voor write-tools is de write-scope vereist. Gebruik tools/call om een tool met de bijbehorende argumenten aan te roepen. Feiten die sessies overstijgen, kun je opslaan met de memory-tools (remember, recall, forget). Langdurige AI-generaties worden per toolaanroep bijgehouden: voeg een taakreferentie toe in _meta["io.modelcontextprotocol/related-task"] en ProcessMind rapporteert de status van die taak bij de aanroep. De extensiemethoden tasks/list, tasks/get en tasks/cancel worden niet aangeboden.

Model Context Protocol-serverendpoint (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 is de read-scope vereist, voor write-tools de write-scope. De toolcatalogus staat in de MCP-gids. Authenticeer met x-api-key of Authorization: Bearer <token> (token van het OAuth-tokenendpoint).

Endpoint: POST /v1/mcp/{tenantId}

Auth: Tenantgebonden API-sleutel · read-scope · limiet 20 verzoeken/s (burst 40)

Parameters:

Naam	Type	Locatie	Vereist	Beschrijving
tenantId	string	pad	Ja	Indeling: uuid

Request body:

MCP JSON-RPC-verzoek

{}

Response (200):

MCP JSON-RPC-response

{
	"message": "string"
}

Veld	Type	Vereist	Beschrijving
message	string	Ja

Fouten:

• 401 Ontbrekende, ongeldige, uitgeschakelde of verlopen API-sleutel
• 403 De API-sleutel heeft niet de vereiste scope of organisatietoegang, de tenant is inactief of het abonnement blokkeert het bestandstype

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

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

Auth: Openbaar, geen API-sleutel · limiet 10 verzoeken/s (burst 20)

Parameters:

Naam	Type	Locatie	Vereist	Beschrijving
tenantId	string	pad	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 Ontbrekende, ongeldige, uitgeschakelde of verlopen API-sleutel

OAuth 2.0-tokenendpoint (client_credentials of authorization_code + PKCE)

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

Auth: Openbaar, geen API-sleutel · limiet 5 verzoeken/s (burst 10)

Parameters:

Naam	Type	Locatie	Vereist	Beschrijving
tenantId	string	pad	Ja	Indeling: uuid

Response (200):

Access token

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

Veld	Type	Vereist	Beschrijving
access_token	string	Ja	Kortlevende 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 Ontbrekende, ongeldige, uitgeschakelde of verlopen API-sleutel
• 403 De API-sleutel heeft niet de vereiste scope of organisatietoegang, de tenant is inactief of het abonnement blokkeert het bestandstype