Referencia de 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 consultar el catálogo de herramientas. Las herramientas de lectura, como list_processes, solo aparecen si la clave de API tiene el alcance de lectura; las herramientas de escritura requieren el alcance de escritura. Use tools/call para invocar una herramienta con sus argumentos. Las herramientas de memoria (remember, recall, forget) permiten almacenar información entre sesiones. El sistema realiza un seguimiento de las generaciones de IA de larga duración por llamada a herramienta: incluya una referencia a la tarea en _meta["io.modelcontextprotocol/related-task"] y ProcessMind informará de su estado junto con la respuesta. No se ofrecen los métodos de extensión tasks/list, tasks/get y tasks/cancel.

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

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

Endpoint: POST /v1/mcp/{tenantId}

Autenticación: Clave de API con alcance de inquilino · alcance read · límite de solicitudes: 20 por segundo (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 o el acceso a la organización necesarios, el inquilino está inactivo o el plan no permite este tipo de archivo

Endpoint de autorización OAuth 2.1 (PKCE), redirige con el código 302 a redirect_uri con ?code=…

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

Autenticación: Público, sin clave de API · límite de solicitudes: 10 por segundo (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 un campo obligatorio ausente
• 401 Falta la clave de API, no es válida, está deshabilitada o ha caducado

Endpoint de token 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 solicitudes: 5 por segundo (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 un campo obligatorio ausente
• 401 Falta la clave de API, no es válida, está deshabilitada o ha caducado
• 403 La clave de API no tiene el alcance o el acceso a la organización necesarios, el inquilino está inactivo o el plan no permite este tipo de archivo