Procesio MCP Server

This is a Model Context Protocol (MCP) server designed to interact with the Procesio automation platform API. It allows language models and other MCP clients to list, view, and manage Procesio workflows and instances.

This server uses API Key/Value authentication.

Features

Tools

The server currently provides the following tools:

• `procesio_test_authentication`:
• `procesio_list_projects`:
• `procesio_get_project_details`:
• `procesio_launch_project`:
• `procesio_get_instance_status`:

Configuration

This server requires environment variables to be set for authentication and API endpoint configuration. These can be provided via:

1. `.env` file: Create a `.env` file in the project root (`procesio-mcp-server/.env`) with the following content:

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. MCP Settings File: Alternatively, configure these directly in the `env` block of your MCP client's settings file (e.g., `cline_mcp_settings.json` or `claude_desktop_config.json`). This method is preferred when running via an MCP client as it ensures the variables are correctly passed to the server process.

{
      "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": []
        }
      }
    }

*Replace `/path/to/` with the actual path to the server directory.*

Development

Requires Node.js (LTS version recommended, see `.nvmrc`).

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Running Locally (for testing)

Ensure environment variables are set (e.g., via `.env` or exported in your shell).

npm run build
node build/index.js

The server will listen on stdio for MCP requests.

Certified by MCP Review

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.