Setup

Prerequisites

• An Enhance workspace with at least one project
• An API key (create one in Workspace Settings > MCP)
• Node.js 20+ installed

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "enhance": {
      "command": "npx",
      "args": ["@enhance-pm/mcp-server"],
      "env": {
        "ENHANCE_API_URL": "https://your-instance.example.com",
        "ENHANCE_API_KEY": "byg_live_..."
      }
    }
  }
}

Restart Claude Code. Enhance tools will appear in the tool list.

Cursor / Windsurf

Add to your MCP settings (Settings > MCP Servers):

{
  "enhance": {
    "command": "npx",
    "args": ["@enhance-pm/mcp-server"],
    "env": {
      "ENHANCE_API_URL": "https://your-instance.example.com",
      "ENHANCE_API_KEY": "byg_live_..."
    }
  }
}

Configuration

The MCP server reads configuration from environment variables or a config file.

Environment variables

Variable	Required	Description
ENHANCE_API_KEY	Yes	API key (format: byg_live_...)
ENHANCE_API_URL	Yes	URL of your Enhance instance (no trailing slash)

Config file fallback

If environment variables are not set, the server looks for .enhance.json in:

1. Current working directory
2. Home directory (~/.enhance.json)

{
  "apiKey": "byg_live_...",
  "apiUrl": "https://your-instance.example.com"
}

Verifying the connection

After setup, try asking your IDE agent:

• "List my Enhance projects"
• "Search for authentication code in repo X"
• "Show me recent issues"

If the tools respond with data, the connection is working.

Troubleshooting

Problem	Solution
Missing API key on startup	Set ENHANCE_API_KEY env var or add .enhance.json
401 Unauthorized	Key is invalid or revoked — create a new one
403 Forbidden	Key lacks the required scope for that tool
ECONNREFUSED	Enhance API is not reachable — check ENHANCE_API_URL
Tools return empty results	Make sure your workspace has indexed repos and created issues
Cannot find module	Run pnpm build in the mcp-server package (for local installs)