Installation

This guide covers all installation options for Workflow MCP.

Package Options

Local Installation (stdio)

For use with Claude Desktop or other local MCP clients.

1. Install the package

   npm install -g @blackmesa/workflow-mcp-stdio

2. Configure your MCP client

   Add to your .mcp.json file:

   {
     "mcpServers": {
       "workflow": {
         "command": "npx",
         "args": ["@blackmesa/workflow-mcp-stdio"],
         "cwd": "/path/to/your/project"
       }
     }
   }

   Project Directory

   Set cwd to your project root so session files are created relative to your project.

3. Verify installation

   Restart your MCP client. You should see "workflow" in the available tools.

Remote Installation (HTTP)

For deployment to Render, Fly.io, or your own server.

npm install @blackmesa/workflow-mcp-http

# Start the server
MCP_PORT=3000 npx @blackmesa/workflow-mcp-http

docker run -p 3000:3000 \
  -e MCP_WORKSPACE_DIR=/data \
  -v ./workflow-data:/data \
  blackmesa/workflow-mcp

https://api.workflow-mcp.blackmesa.live/mcp

Environment Variables

Next Steps

• Quick Start - Start your first workflow
• Local Deployment - stdio configuration details
• Remote Deployment - HTTP server setup