Setup Guide

Configure the VertaaUX MCP Server in your AI assistant. This guide covers setup for all major MCP clients.

Claude Desktop (Recommended)

Claude Desktop provides the best integration for the VertaaUX MCP Server.

Configuration File Location

~/Library/Application Support/Claude/claude_desktop_config.json

mkdir -p ~/Library/Application\ Support/Claude

%APPDATA%\Claude\claude_desktop_config.json

C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

Add VertaaUX Server

Add this configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "vertaaux": {
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_live_your_key_here"
      }
    }
  }
}

If you have existing MCP servers, add VertaaUX alongside them:

{
  "mcpServers": {
    "existing-server": {
      "command": "npx",
      "args": ["other-mcp-server"]
    },
    "vertaaux": {
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop

After saving the configuration:

1. macOS: Press Cmd+Q to fully quit, then reopen
2. Windows: Right-click the tray icon > Quit, then reopen
3. Linux: Close all windows and relaunch

Verify Installation

Ask Claude:

You should see VertaaUX tools listed, including audit_url, suggest_fix, and others.

Cursor

Cursor IDE supports MCP servers through its extension system.

Configuration

1. Open Cursor Settings (Cmd/Ctrl + ,)
2. Navigate to Extensions > MCP
3. Click Add Server

Enter this configuration:

{
  "name": "vertaaux",
  "command": "npx",
  "args": ["@vertaaux/mcp-server"],
  "env": {
    "VERTAAUX_API_KEY": "vx_live_your_key_here"
  }
}

Alternative: Manual Config

Add to your Cursor configuration file:

{
  "servers": [
    {
      "name": "vertaaux",
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_live_your_key_here"
      }
    }
  ]
}

Continue.dev

Continue.dev is an open-source AI coding assistant that supports MCP.

Configuration

Add VertaaUX to your ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "vertaaux",
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_live_your_key_here"
      }
    }
  ]
}

Restart the Continue extension after updating the configuration.

Generic MCP Client

For any MCP-compatible client using stdio transport:

Server Command

npx @vertaaux/mcp-server

Transport

• Type: stdio (standard input/output)
• Protocol: MCP 1.0

Required Environment

Running Locally

If you want to run the server directly:

VERTAAUX_API_KEY=vx_live_xxx npx @vertaaux/mcp-server

The server communicates via stdin/stdout using JSON-RPC messages.

Environment Variables

Using Different Environments

For staging/test environments:

{
  "mcpServers": {
    "vertaaux-staging": {
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_test_staging_key",
        "VERTAAUX_API_BASE": "https://staging.vertaaux.ai/api/v1"
      }
    }
  }
}

Troubleshooting

Server Not Starting

Symptoms: No tools available, "MCP server not responding"

Solutions:

1. Verify Node.js 18+ is installed:

   node --version  # Should be v18.x or higher

2. Test the server manually:

   VERTAAUX_API_KEY=vx_live_xxx npx @vertaaux/mcp-server --version

3. Check for npx caching issues:

   npx --clear-cache

API Key Issues

Symptoms: "Unauthorized" or "Invalid API key" errors

Solutions:

1. Verify key format: Should start with vx_live_ or vx_test_

2. Check key is set correctly (no extra spaces/quotes):

   "env": {
     "VERTAAUX_API_KEY": "vx_live_abc123"  // No quotes around the key
   }

3. Verify key is active in your dashboard

Permission Errors

Symptoms: "EACCES" or permission denied errors

Solutions:

1. Ensure npx has execute permissions:

   which npx  # Verify npx location
   ls -la $(which npx)  # Check permissions

2. Try using absolute path:

   {
     "command": "/usr/local/bin/npx",
     "args": ["@vertaaux/mcp-server"]
   }

Tools Not Appearing

Symptoms: Server connects but no tools show up

Solutions:

1. Fully restart your client application (not just close window)

2. Check server logs for initialization errors

3. Verify the API key has audit permissions enabled

Verifying Setup

After configuration, verify everything works:

Step 1: Check Tools

Ask your AI assistant:

Expected response should list: audit_url, get_findings, explain_finding, suggest_fix, etc.

Step 2: Test Audit

Should return audit results with findings.

Step 3: Test Fix Suggestion

If the audit has findings:

Should return a code patch with confidence score.

Multiple Environments

You can configure multiple VertaaUX servers for different environments:

{
  "mcpServers": {
    "vertaaux-prod": {
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_live_production_key"
      }
    },
    "vertaaux-staging": {
      "command": "npx",
      "args": ["@vertaaux/mcp-server"],
      "env": {
        "VERTAAUX_API_KEY": "vx_test_staging_key",
        "VERTAAUX_API_BASE": "https://staging.vertaaux.ai/api/v1"
      }
    }
  }
}

Then specify which to use:

Related

• Quickstart - Get your first AI-suggested fix
• Tools Reference - All available MCP tools
• API Authentication - API key management