Procesio MCP Server

Interactúa con la API de la plataforma de automatización Procesio.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Procesio MCP Server

Este es un servidor de Protocolo de Contexto de Modelo (MCP) diseñado para interactuar con la API de la plataforma de automatización Procesio. Permite a los modelos de lenguaje y otros clientes MCP listar, ver y gestionar flujos de trabajo e instancias de Procesio.

Este servidor utiliza autenticación mediante clave/valor de API.

Características

Herramientas

El servidor actualmente proporciona las siguientes herramientas:

  • procesio_test_authentication:
    • Descripción: Prueba la autenticación mediante clave/valor de API obteniendo los detalles del usuario actual.
    • Entrada: Ninguna
    • Salida: Objeto JSON con los detalles del usuario en caso de éxito.
  • procesio_list_projects:
    • Descripción: Lista las plantillas de procesos (flujos de trabajo) disponibles de Procesio.
    • Entrada (Opcional): pageNumber (entero, predeterminado: 1), pageItemCount (entero, predeterminado: 20)
    • Salida: Objeto JSON que contiene una lista paginada de plantillas de procesos.
  • procesio_get_project_details:
    • Descripción: Obtiene los detalles de una plantilla de proceso (flujo de trabajo) específica de Procesio.
    • Entrada (Requerida): projectId (cadena - UUID de la plantilla de proceso)
    • Salida: Objeto JSON con la configuración detallada de la plantilla de proceso especificada.
  • procesio_launch_project:
    • Descripción: Lanza una instancia de una plantilla de proceso (flujo de trabajo) específica de Procesio.
    • Entrada (Requerida): projectId (cadena - UUID de la plantilla de proceso)
    • Entrada (Opcional): payload (objeto), runSynchronous (booleano), debugMode (booleano), secondsTimeOut (entero), connectionId (cadena - pasada como encabezado)
    • Salida: Objeto JSON con detalles sobre la instancia lanzada (p. ej., ID de instancia). Nota: El lanzamiento puede fallar si el proyecto no es válido.
  • procesio_get_instance_status:
    • Descripción: Obtiene el estado de una instancia de proceso en ejecución o completada.
    • Entrada (Requerida): instanceId (cadena - UUID de la instancia de proceso)
    • Entrada (Opcional): flowTemplateId (cadena - UUID de la plantilla original), isArchived (booleano)
    • Salida: Objeto JSON con los detalles de estado de la instancia especificada.

Configuración

Este servidor requiere que se establezcan variables de entorno para la autenticación y la configuración del endpoint de la API. Estas se pueden proporcionar mediante:

  1. Archivo .env: Cree un archivo .env en la raíz del proyecto (procesio-mcp-server/.env) con el siguiente contenido:

    PROCESIO_API_KEY='YOUR_API_KEY'
PROCESIO_API_VALUE='YOUR_API_VALUE'
PROCESIO_USERNAME='your_procesio_username' # Still needed for initial check, though not used for auth
PROCESIO_PASSWORD='your_procesio_password' # Still needed for initial check, though not used for auth
PROCESIO_WEB_API_URL='https://webapi.procesio.app/' # Or your specific instance URL
PROCESIO_REALM='procesio01' # Or your specific realm if different

  2. Archivo de configuración de MCP: Alternativamente, configure estas directamente en el bloque env del archivo de configuración de su cliente MCP (p. ej., cline_mcp_settings.json o claude_desktop_config.json). Este método es preferible cuando se ejecuta a través de un cliente MCP, ya que garantiza que las variables se pasen correctamente al proceso del servidor.

    {
  "mcpServers": {
    "procesio": {
      "command": "node",
      "args": [
        "/path/to/procesio-mcp-server/build/index.js"
      ],
      "env": {
        "PROCESIO_API_KEY": "YOUR_API_KEY",
        "PROCESIO_API_VALUE": "YOUR_API_VALUE",
        "PROCESIO_USERNAME": "your_procesio_username",
        "PROCESIO_PASSWORD": "your_procesio_password",
        "PROCESIO_WEB_API_URL": "https://webapi.procesio.app/",
        "PROCESIO_REALM": "procesio01"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

    Reemplace /path/to/ con la ruta real al directorio del servidor.

Desarrollo

Requiere Node.js (se recomienda la versión LTS, consulte .nvmrc).

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Ejecución Local (para pruebas)

Asegúrese de que las variables de entorno estén establecidas (p. ej., mediante .env o exportadas en su shell).

npm run build
node build/index.js

El servidor escuchará en stdio las solicitudes MCP.

Certificado por MCP Review

Licencia

Este proyecto está licenciado bajo la Licencia Apache, Versión 2.0. Consulte el archivo LICENSE para obtener más detalles.