Configuration

The VertaaUX VS Code Extension has three configurable settings to customize behavior.

Settings Overview

Setting	Type	Default	Description
`vertaaux.mcpServer`	string	`http://localhost:3001`	MCP Server base URL
`vertaaux.maxDiagnosticsPerFile`	number	`50`	Maximum diagnostics shown per file
`vertaaux.confidenceThreshold`	number	`0.6`	Minimum confidence to display issues

How to Configure

VS Code Settings UI

Open Settings: Cmd+, (Mac) or Ctrl+, (Windows/Linux)
Search for "vertaaux"
Modify settings using the UI controls

settings.json

Add settings directly to your VS Code settings file:

Open Command Palette: Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
Type "Preferences: Open Settings (JSON)"
Add VertaaUX settings

settings.json

{
  "vertaaux.mcpServer": "http://localhost:3001",
  "vertaaux.maxDiagnosticsPerFile": 50,
  "vertaaux.confidenceThreshold": 0.6
}

MCP Server URL

Setting: vertaaux.mcpServer

Type: string

Default: http://localhost:3001

The base URL of your running MCP Server. The extension sends scan requests to this endpoint.

When to Change

Scenario	Value
Default local server	`http://localhost:3001`
Server on different port	`http://localhost:3002`
Remote server	`http://192.168.1.100:3001`

Example

{
  "vertaaux.mcpServer": "http://localhost:3002"
}

The extension uses HTTP transport, not the stdio MCP protocol. Your MCP Server must be started with the --http flag.

Starting MCP Server on Different Port

# Default port 3001
VERTAAUX_API_KEY=vx_live_xxx npx @vertaaux/mcp-server --http

# Custom port 3002
VERTAAUX_API_KEY=vx_live_xxx npx @vertaaux/mcp-server --http --port 3002

Maximum Diagnostics Per File

Setting: vertaaux.maxDiagnosticsPerFile

Type: number

Default: 50

Range: 1-500

Limits the number of diagnostic messages shown for each file. This controls display only - it does not affect the actual scan.

When to Change

Scenario	Recommended Value
Quick review of top issues	10-20
Standard development	50 (default)
Thorough audit	100-200
See all issues	500

Example

{
  "vertaaux.maxDiagnosticsPerFile": 100
}

Files with many issues may slow down the editor. Keep this at 50 or lower for large files with known issues.

Use Cases

Low values (10-20): Focus on the most important issues first. Good for iterative fixing.

Default (50): Balanced view of issues without overwhelming the editor.

High values (100+): Full audit mode. Use when you want to see everything before a release.

Confidence Threshold

Setting: vertaaux.confidenceThreshold

Type: number

Default: 0.6

Range: 0.0-1.0

The minimum confidence level required for an issue to be displayed. Issues below this threshold are filtered out.

Understanding Confidence

VertaaUX assigns a confidence score (0.0 to 1.0) to each detected issue:

Score	Meaning
0.9-1.0	Very high confidence - likely a real issue
0.7-0.8	High confidence - worth investigating
0.5-0.6	Medium confidence - may be context-dependent
0.3-0.4	Low confidence - possibly false positive
0.0-0.2	Very low confidence - often noise

When to Change

Scenario	Recommended Value
Fewer, more reliable issues	0.8
Balanced (default)	0.6
See more potential issues	0.4
See all issues (including noise)	0.0

Example

{
  "vertaaux.confidenceThreshold": 0.8
}

Tuning Strategy

Start high, then lower:

Set to 0.8 to see only high-confidence issues
Fix those issues
Lower to 0.6 to see medium-confidence issues
Review and fix valid ones
Lower further if needed

For mature codebases: Use 0.7-0.8 to avoid noise

For new projects: Use 0.5-0.6 to catch more issues early

Workspace-Specific Settings

You can configure different settings per workspace using .vscode/settings.json:

.vscode/settings.json

{
  "vertaaux.mcpServer": "http://localhost:3001",
  "vertaaux.maxDiagnosticsPerFile": 30,
  "vertaaux.confidenceThreshold": 0.7
}

This overrides your user settings for that specific workspace.

Complete Example

settings.json

{
  // VertaaUX VS Code Extension settings
  "vertaaux.mcpServer": "http://localhost:3001",
  "vertaaux.maxDiagnosticsPerFile": 50,
  "vertaaux.confidenceThreshold": 0.6
}

Quickstart - Initial setup
MCP Setup - MCP Server configuration
Commands - Available commands

Was this page helpful?

Configuration

On this page