Skip to main content

Installation

Install directly from GitHub using pip:
Pin to a specific version:
Python 3.12+ is required. Check your version with python3 --version.

Setup

1

Generate API Key

Create an API key from ZeroPath Settings. You need the Token ID and Token Secret.A personal key uses your current permissions. For automation, a service key uses the permissions and repository access granted to it. You need Create API Tokens to create a service key. Choose a personal key for tools that require a user account. See API tokens.
2

Set Environment Variables

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

To manage Assistant schedules, configure event triggers, or activate playbooks with local MCP, use a personal key with Manage Agent or a full-access service key. Assistant-wide settings and global instructions stay in the dashboard or administrative REST API. See Assistant automation and the API workflow.
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).

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 Settings → General → Organization.
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.