Connect Vectra AI RUX MCP Server

Choose your client and follow the steps below.

Visual Studio Code

Install the MCP extension

Open VS Code and install GitHub Copilot (includes MCP support) from the Extensions Marketplace, or confirm it's already installed.

Open your MCP settings

Press Ctrl+Shift+P (or ⌘+Shift+P on macOS) and search for MCP: Add Server, or manually edit:

.vscode/mcp.json

Add the server configuration

Paste the following into your mcp.json file:

{
  "servers": {
    "vectra-ai-rux-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/vectra-ai-rux-mcp-server"
      ],
      "env": {
        "VECTRA_CLIENT_SECRET": "YOUR_VECTRA_CLIENT_SECRET",
        "VECTRA_BASE_URL": "YOUR_VECTRA_BASE_URL",
        "VECTRA_CLIENT_ID": "YOUR_VECTRA_CLIENT_ID"
      }
    }
  }
}

Set required environment variables

When prompted, provide values for:

VECTRA_CLIENT_SECRET VECTRA_BASE_URL VECTRA_CLIENT_ID

Start using it

Open Copilot Chat and the Vectra AI RUX MCP Server tools will be available automatically.

Cursor

Open Cursor Settings

Go to Cursor Settings → MCP and click + Add new global MCP server, or manually edit:

~/.cursor/mcp.json

Add the server configuration

Paste the following into your mcp.json:

{
  "mcpServers": {
    "vectra-ai-rux-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/vectra-ai-rux-mcp-server"
      ],
      "env": {
        "VECTRA_CLIENT_SECRET": "YOUR_VECTRA_CLIENT_SECRET",
        "VECTRA_BASE_URL": "YOUR_VECTRA_BASE_URL",
        "VECTRA_CLIENT_ID": "YOUR_VECTRA_CLIENT_ID"
      }
    }
  }
}

Set required environment variables

Provide values for:

VECTRA_CLIENT_SECRET VECTRA_BASE_URL VECTRA_CLIENT_ID

Start using it

Open Cursor's AI chat — the Vectra AI RUX MCP Server tools will appear automatically.

ChatGPT (Desktop)

Open ChatGPT Desktop settings

Click your profile icon → Settings → Beta features and ensure MCP plugin support is enabled.

Add the MCP server

Navigate to Settings → MCP Servers → + Add Server and paste:

{
  "mcpServers": {
    "vectra-ai-rux-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/vectra-ai-rux-mcp-server"
      ],
      "env": {
        "VECTRA_CLIENT_SECRET": "YOUR_VECTRA_CLIENT_SECRET",
        "VECTRA_BASE_URL": "YOUR_VECTRA_BASE_URL",
        "VECTRA_CLIENT_ID": "YOUR_VECTRA_CLIENT_ID"
      }
    }
  }
}

Set required environment variables

Provide values for:

VECTRA_CLIENT_SECRET VECTRA_BASE_URL VECTRA_CLIENT_ID

Start using it

Start a new chat — Vectra AI RUX MCP Server tools will be available when the server is connected.

Claude Desktop

Open Claude Desktop config

Open the Claude Desktop configuration file at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add to the mcpServers object

Merge the following into the "mcpServers" key:

{
  "vectra-ai-rux-mcp-server": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "mcp/vectra-ai-rux-mcp-server"
    ],
    "env": {
      "VECTRA_CLIENT_SECRET": "YOUR_VECTRA_CLIENT_SECRET",
      "VECTRA_BASE_URL": "YOUR_VECTRA_BASE_URL",
      "VECTRA_CLIENT_ID": "YOUR_VECTRA_CLIENT_ID"
    }
  }
}

Set required environment variables

Replace the placeholder values for:

VECTRA_CLIENT_SECRET VECTRA_BASE_URL VECTRA_CLIENT_ID

Restart Claude Desktop

Quit and reopen Claude Desktop. The Vectra AI RUX MCP Server tools will appear in the tools menu.