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 tels que list_processes ne sont listés que lorsque la clé API dispose du périmètre read ; les outils d’écriture nécessitent le périmètre write. Utilisez tools/call pour appeler un outil avec ses arguments. Les informations communes à plusieurs sessions peuvent être stockées avec les outils de mémoire (remember, recall, forget), et les générations IA longues sont suivies pour chaque appel d’outil : ajoutez 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 proposées.

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 catalogue des outils est documenté dans le guide MCP. Authentifiez-vous avec x-api-key ou Authorization: Bearer <token> (jeton provenant du point de terminaison de jetons OAuth).

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

Authentification : Clé API limitée au tenant · portée read · limite de débit de 20 req/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 absente, non valide, 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, le tenant est inactif ou le forfait bloque 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 : Publique, sans clé API · limite de débit de 10 req/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 non valide, processus sans modèle, type d’import non pris en charge ou champ obligatoire manquant
• 401 Clé API absente, non valide, 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 : Publique, sans clé API · limite de débit de 5 req/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 à courte durée de validité 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 non valide, processus sans modèle, type d’import non pris en charge ou champ obligatoire manquant
• 401 Clé API absente, non valide, 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, le tenant est inactif ou le forfait bloque ce type de fichier