Referencia de la API: MCP

El servidor MCP permite que los asistentes de IA interactúen con ProcessMind mediante Model Context Protocol. Utiliza JSON-RPC 2.0 sobre Streamable HTTP: envíe initialize y, después, tools/list para descubrir el catálogo de herramientas. Las herramientas de lectura, como list_processes, solo se muestran cuando la clave de API tiene el ámbito read; las herramientas de escritura requieren el ámbito write. Utilice tools/call para invocar una herramienta con sus argumentos. Puede almacenar datos entre sesiones con las herramientas de memoria (remember, recall y forget), y las generaciones de IA de larga duración se siguen por llamada a la herramienta: adjunte una referencia de tarea en _meta["io.modelcontextprotocol/related-task"] y ProcessMind informará del estado de esa tarea junto con la llamada. Los métodos de extensión tasks/list, tasks/get y tasks/cancel no se ofrecen.

Endpoint del servidor Model Context Protocol (JSON-RPC sobre Streamable HTTP)

JSON-RPC 2.0 mediante Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Las herramientas de lectura requieren el alcance read de la clave y las herramientas de escritura, el alcance write. El catálogo de herramientas está documentado en la guía de MCP. Autentíquese con x-api-key o Authorization: Bearer <token> (token del endpoint de tokens de OAuth).

Endpoint: POST /v1/mcp/{tenantId}

Autenticación: Clave de API con alcance de inquilino · alcance read · límite de velocidad de 20 solicitudes/s (ráfaga de 40)

Parámetros:

Nombre	Tipo	Ubicación	Obligatorio	Descripción
tenantId	string	ruta	Sí	Formato: uuid

Cuerpo de la solicitud:

Solicitud JSON-RPC de MCP

{}

Respuesta (200):

Respuesta JSON-RPC de MCP

{
	"message": "string"
}

Campo	Tipo	Obligatorio	Descripción
message	string	Sí

Errores:

• 401 Falta la clave de API, no es válida, está deshabilitada o ha caducado
• 403 La clave de API no tiene el alcance requerido o acceso a la organización, el inquilino está inactivo o el plan bloquea el tipo de archivo

Endpoint de autorización de OAuth 2.1 (PKCE), redirecciones 302 de vuelta a redirect_uri con ?code=…

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

Autenticación: Público, sin clave de API · límite de velocidad de 10 solicitudes/s (ráfaga de 20)

Parámetros:

Nombre	Tipo	Ubicación	Obligatorio	Descripción
tenantId	string	ruta	Sí	Formato: uuid
client_id	string	consulta	Sí
redirect_uri	string	consulta	Sí	Formato: uri
code_challenge	string	consulta	Sí
code_challenge_method	S256	consulta	No	Valores permitidos: S256
state	string	consulta	No

Errores:

• 302 Redirección a redirect_uri con code + state
• 400 Solicitud incorrecta: por ejemplo, una expresión de filtro no válida, un proceso sin modelo, un tipo de carga no compatible o la falta de un campo obligatorio
• 401 Falta la clave de API, no es válida, está deshabilitada o ha caducado

Endpoint de tokens de OAuth 2.0 (client_credentials o authorization_code + PKCE)

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

Autenticación: Público, sin clave de API · límite de velocidad de 5 solicitudes/s (ráfaga de 10)

Parámetros:

Nombre	Tipo	Ubicación	Obligatorio	Descripción
tenantId	string	ruta	Sí	Formato: uuid

Respuesta (200):

Token de acceso

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

Campo	Tipo	Obligatorio	Descripción
access_token	string	Sí	JWT Bearer de corta duración para POST /v1/mcp/{tenantId}
token_type	Bearer	Sí	Valores permitidos: Bearer
expires_in	number	Sí

Errores:

• 400 Solicitud incorrecta: por ejemplo, una expresión de filtro no válida, un proceso sin modelo, un tipo de carga no compatible o la falta de un campo obligatorio
• 401 Falta la clave de API, no es válida, está deshabilitada o ha caducado
• 403 La clave de API no tiene el alcance requerido o acceso a la organización, el inquilino está inactivo o el plan bloquea el tipo de archivo