Skip to main content

​
Installation

Install directly from GitHub using pip:
pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git
Pin to a specific version:
pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git@v0.1.0
Python 3.12+ is required. Check your version with python3 --version.

​
Setup

1

Generate API Key

Create a user-scoped or admin API key from ZeroPath Settings. You need the Token ID and Token Secret.
2

Set Environment Variables

export ZEROPATH_TOKEN_ID=your_token_id
export ZEROPATH_TOKEN_SECRET=your_token_secret
export ZEROPATH_ORG_ID=your_org_id
export ZEROPATH_BASE_URL="https://zeropath.com"  # optional, defaults to https://zeropath.com
Set ZEROPATH_BASE_URL to target a different environment, e.g. https://your-instance.example.com
3

Configure Your MCP Client

Add the ZeroPath MCP server to your AI tool’s config file. See the client configuration section below.

​
Client Configuration

For Claude Desktop, edit your config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
For Cursor, add to MCP settings (Settings → MCP).
{
  "mcpServers": {
    "zeropath": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ZeroPathAI/zeropath-mcp-server",
        "zeropath-mcp-server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

​
Troubleshooting

The MCP server may not have started or failed to fetch the manifest. Check your terminal for startup errors. Ensure the server process is running and can reach https://zeropath.com/mcp-manifest.json.
Verify ZEROPATH_TOKEN_ID and ZEROPATH_TOKEN_SECRET are correct and the API key is active. You can test by visiting ZeroPath Settings to confirm the key status.
Confirm ZEROPATH_ORG_ID matches an organization you have access to. You can find your org ID in ZeroPath Settings.
Pass organizationId explicitly in the tool input, or set ZEROPATH_ORG_ID in your environment. The server auto-injects the org ID when the environment variable is configured.
Check the error details — the server validates all inputs before calling ZeroPath’s API. Common causes: wrong field names (e.g., status instead of issueStatus), wrong types (e.g., string instead of number for severity).

​
General Tips

  • Restart your AI client after changing MCP configuration.
  • Ensure Python 3.12+ is in your PATH.
  • Use uvx for the simplest setup — no installation required.
  • Check the GitHub repo for updates and known issues.