How do I install Selenix?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Selenix need an API key?

The publisher lists these environment variables: YOUR_API_KEY.

What transport does Selenix use?

Selenix runs locally over stdio.

When was Selenix last checked?

Last checked 2026-11-09. MCP server that bridges local apps with Selenix for browser automation.

Selenix MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @selenix/[email protected]

Credentials from the publisher

YOUR_API_KEY — Your API key for the service

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1YOUR_API_KEY=<secret> claude mcp add io.github.markmircea-selenix-mcp-server -- npx -y @selenix/mcp-server@1.0.7

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.markmircea-selenix-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@selenix/[email protected]"8      ],9      "env": {10        "YOUR_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.7
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Selenix MCP Server

Connect Claude Desktop to Selenix via the Model Context Protocol. Chat with Claude to create, run, debug, and manage browser automation tests — just like using the built-in AI Assistant, but powered by Claude.

Prerequisites

Selenix desktop app installed
Claude Desktop installed
Node.js 18 or later

Enable the Bridge in Selenix

Before using any setup method below, enable the bridge inside Selenix:

Open Selenix
Go to System Settings (gear icon in the sidebar)
Scroll to the MCP Server section
Set Enable MCP Server to Yes

This starts a local bridge server that the MCP server connects to.

Setup

Choose one of the following methods:

Option A: Install via npm (recommended)

npm install -g @selenix/mcp-server

Then find your global npm path:

npm root -g

Open your Claude Desktop config file:

Windows: Press Win+R, paste %APPDATA%\Claude\claude_desktop_config.json, press Enter
macOS: Open ~/Library/Application Support/Claude/claude_desktop_config.json

Add the Selenix MCP server, replacing the path with the output from npm root -g:

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["<npm-root-path>/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

Example (Windows with nvm):

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/Users/YourName/AppData/Local/nvm/v18.20.8/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

Example (macOS/Linux):

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

If you already have other MCP servers configured, add "selenix" alongside them inside the existing "mcpServers" object.

Option B: Use the bundled version (no npm required)

If you installed Selenix as a desktop app, the MCP server is already bundled. No need to install anything — just point Claude Desktop to the bundled file.

Find your Selenix install folder and look for resources/mcp-server/index.js, then add to your Claude Desktop config:

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/path/to/Selenix/resources/mcp-server/index.js"]
    }
  }
}

Typical Windows path:

C:/Users/YourName/AppData/Local/Programs/Selenix/resources/mcp-server/index.js

Option C: Manual download

Download bundle.js from the npm package page or from the releases page
Save it somewhere on your machine (e.g., C:/selenix-mcp/bundle.js)
Add to your Claude Desktop config:

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/selenix-mcp/bundle.js"]
    }
  }
}

Node.js is still required — the MCP server is a single JavaScript file with no other dependencies.

Verify

Restart Claude Desktop after editing the config. You should see the Selenix tools icon (hammer) in the chat input area.

Try asking Claude:

"What tests are in my Selenix project?"
"Create a test that opens google.com and searches for 'selenium automation'"
"Run the current test and fix any failures"
"Take a screenshot of the browser"

How It Works

Claude Desktop <--stdio--> MCP Server <--HTTP--> Bridge Server (inside Selenix)

The MCP server translates Claude's tool calls into HTTP requests to a bridge server running inside Selenix. The bridge has full access to Selenix internals — the same capabilities as the built-in AI Assistant.

The bridge only listens on 127.0.0.1 (localhost) — no network exposure
Auth is handled via a bearer token auto-generated each time Selenix starts
Connection config is stored at ~/.selenix/bridge.json and re-read on every call, so restarting Selenix does not require restarting Claude Desktop

Available Tools

Reading & Inspection

Tool	Description
`get_screenshot`	Capture a screenshot of the browser window
`get_page_html`	Get the page HTML with interactive elements annotated
`get_search_html`	Search page HTML by regex pattern
`get_selected_command_info`	Get DOM context for a command's target element
`get_current_test`	Get all commands in the current test
`get_test_list`	List all tests in the project
`get_test_by_name`	Get a test by its name
`get_command_list`	List all available Selenix commands
`get_command_info`	Get detailed docs for a specific command
`get_project_info`	Get project metadata
`get_active_suite`	Get the active test suite
`get_step_results`	Get pass/fail results from the last test run
`get_logs`	Get recent logs (all types), 20 per page, most recent first. Optional `page` param for pagination.
`get_workspace_context`	Get a summary of the current workspace

Writing & Execution

Tool	Description
`add_commands`	Add commands to a test at a specific position
`run_test`	Run a test and wait for results (up to 2 minutes)
`clear_and_replace_commands`	Replace all commands in a test
`fix_commands`	Apply targeted fixes — update, remove, or insert commands

Troubleshooting

"Cannot read Selenix bridge config" Selenix isn't running or the MCP Server isn't enabled. Open Selenix → System Settings → set Enable MCP Server to Yes.

"Cannot connect to Selenix bridge" Selenix may have just restarted. Try the request again — the MCP server will automatically pick up the new connection details.

Tools not appearing in Claude Desktop Make sure you restarted Claude Desktop after editing the config file. Verify the config JSON is valid (no trailing commas, correct brackets).

Claude Desktop won't open after config change The config JSON is likely malformed. Open the config file in a text editor, fix the JSON syntax, and try again. Common issues: missing comma between entries, trailing comma after the last entry.

Uninstall

npm uninstall -g @selenix/mcp-server

Then remove the "selenix" entry from your Claude Desktop config file and restart Claude Desktop.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Selenix?

Does Selenix need an API key?

What transport does Selenix use?

When was Selenix last checked?

Documentation

Selenix MCP Server

Prerequisites

Enable the Bridge in Selenix

Setup

Option A: Install via npm (recommended)

Option B: Use the bundled version (no npm required)

Option C: Manual download

Verify

How It Works

Available Tools

Reading & Inspection

Writing & Execution

Troubleshooting

Uninstall