Référence de l’API : MCP

Le serveur MCP permet aux assistants IA d’interagir avec ProcessMind via le Model Context Protocol. Il utilise JSON-RPC 2.0 sur Streamable HTTP : envoyez initialize, puis tools/list pour découvrir le catalogue d’outils. Les outils de lecture, comme list_processes, ne sont répertoriés que si la clé API dispose de la portée de lecture ; les outils d’écriture nécessitent la portée d’écriture. Utilisez tools/call pour appeler un outil avec ses arguments. Les outils de mémoire permettent de conserver des informations entre les sessions (remember, recall, forget). Les générations IA de longue durée sont suivies pour chaque appel d’outil : joignez une référence de tâche dans _meta["io.modelcontextprotocol/related-task"] et ProcessMind renvoie l’état de cette tâche avec l’appel. Les méthodes d’extension tasks/list, tasks/get et tasks/cancel ne sont pas prises en charge.

Point de terminaison du serveur Model Context Protocol (JSON-RPC sur Streamable HTTP)

JSON-RPC 2.0 sur Streamable HTTP : initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Les outils de lecture nécessitent la portée read de la clé, et les outils d’écriture, la portée write. Le guide MCP décrit le catalogue d’outils. Authentifiez-vous avec x-api-key ou Authorization: Bearer <token> (jeton obtenu auprès du point de terminaison de jetons OAuth).

Point de terminaison : POST /v1/mcp/{tenantId}

Authentification : Clé API limitée à l’environnement · portée read · limite de débit : 20 requêtes/s (rafale de 40)

Paramètres :

Nom	Type	Emplacement	Obligatoire	Description
tenantId	string	chemin	Oui	Format : uuid

Corps de la requête :

Requête JSON-RPC MCP

{}

Réponse (200) :

Réponse JSON-RPC MCP

{
	"message": "string"
}

Champ	Type	Obligatoire	Description
message	string	Oui

Erreurs :

• 401 Clé API manquante, invalide, désactivée ou expirée
• 403 La clé API ne dispose pas de la portée requise ou de l’accès à l’organisation, l’environnement est inactif ou le forfait n’autorise pas ce type de fichier

Point de terminaison d’autorisation OAuth 2.1 (PKCE), redirections 302 vers redirect_uri avec ?code=…

Point de terminaison : GET /v1/mcp/{tenantId}/oauth/authorize

Authentification : Public, sans clé API · limite de débit : 10 requêtes/s (rafale de 20)

Paramètres :

Nom	Type	Emplacement	Obligatoire	Description
tenantId	string	chemin	Oui	Format : uuid
client_id	string	requête	Oui
redirect_uri	string	requête	Oui	Format : uri
code_challenge	string	requête	Oui
code_challenge_method	S256	requête	Non	Valeurs autorisées : S256
state	string	requête	Non

Erreurs :

• 302 Redirection vers redirect_uri avec code + state
• 400 Requête incorrecte : par exemple, expression de filtre invalide, processus sans modèle, type de fichier importé non pris en charge ou champ obligatoire manquant
• 401 Clé API manquante, invalide, désactivée ou expirée

Point de terminaison de jetons OAuth 2.0 (client_credentials ou authorization_code + PKCE)

Point de terminaison : POST /v1/mcp/{tenantId}/oauth/token

Authentification : Public, sans clé API · limite de débit : 5 requêtes/s (rafale de 10)

Paramètres :

Nom	Type	Emplacement	Obligatoire	Description
tenantId	string	chemin	Oui	Format : uuid

Réponse (200) :

Jeton d’accès

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

Champ	Type	Obligatoire	Description
access_token	string	Oui	JWT Bearer de courte durée pour POST /v1/mcp/{tenantId&#125 ;
token_type	Bearer	Oui	Valeurs autorisées : Bearer
expires_in	number	Oui

Erreurs :

• 400 Requête incorrecte : par exemple, expression de filtre invalide, processus sans modèle, type de fichier importé non pris en charge ou champ obligatoire manquant
• 401 Clé API manquante, invalide, désactivée ou expirée
• 403 La clé API ne dispose pas de la portée requise ou de l’accès à l’organisation, l’environnement est inactif ou le forfait n’autorise pas ce type de fichier