# simplify3x-connect

> simplify3x-connect is an open-source MCP server for developer tools. MCP server letting AI clients manage SimplifyQA or Walnut test cases from chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, vscode, self-hosted, Web
- **Website:** https://simplifyqa.ai
- **Repository:** https://github.com/simplify3x/simplify3x-connect
- **MCP Registry name:** com.simplifyqa/simplify3x-connect
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as an MCP server that connects AI coding clients to a test management backend. Once connected with a product URL and API token, a client can list projects, search and author test cases, record browser or mainframe flows through a local agent, run tests, and triage results. The same tool names are used whichever product sits behind it, so a team can switch between SimplifyQA and Walnut by changing one setting.

It runs over stdio via npx for a single developer, or as a Streamable HTTP gateway for several clients on one machine or in a container. The README covers per-session connections, optional gateway and per-user tokens, host allow-listing and session limits for shared deployments.

It suits QA engineers and developers who already keep test cases in SimplifyQA or Walnut and want to drive them from Claude Code, Cursor, VS Code or similar clients. Recording requires an additional local agent; without it the server works over REST only.

## Features

- **Test case lifecycle tools:** Covers discovering, authoring, recording, running and triaging test cases from an AI client.
- **Multiple test products:** Works with SimplifyQA or Walnut through the same tool vocabulary, selected by a provider setting.
- **Browser and mainframe recording:** Records web, mainframe or mobile flows through a local agent when QA_MCP_URL is configured.
- **Stdio and HTTP transports:** Runs as a local stdio process via npx or as a shared Streamable HTTP gateway with health endpoints.
- **Per-session authentication:** Gateway and per-user product tokens are separated, and each session keeps its own connection.
- **Host allow-listing:** QA_MCP_ALLOWED_HOSTS restricts which backend hosts the server may call, reducing SSRF risk on shared deployments.

## Good for

- Authoring test cases in plain language from a coding assistant
- Running a named test case on the cloud from chat
- Reviewing and editing recorded test steps before saving
- Triaging test results without leaving the IDE
- Switching between projects in a SimplifyQA or Walnut workspace

## Install

### Claude Code (Terminal)

```sh
claude mcp add simplify3x-connect --env QA_MCP_PROVIDER='<QA_MCP_PROVIDER>' --env QA_BASE_URL='<QA_BASE_URL>' --env QA_MCP_TOKEN='<QA_MCP_TOKEN>' -- npx -y simplify3x-connect
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "simplify3x-connect": {
      "command": "npx",
      "args": [
        "-y",
        "simplify3x-connect"
      ],
      "env": {
        "QA_MCP_PROVIDER": "<QA_MCP_PROVIDER>",
        "QA_BASE_URL": "<QA_BASE_URL>",
        "QA_MCP_TOKEN": "<QA_MCP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "simplify3x-connect": {
      "command": "npx",
      "args": [
        "-y",
        "simplify3x-connect"
      ],
      "env": {
        "QA_MCP_PROVIDER": "<QA_MCP_PROVIDER>",
        "QA_BASE_URL": "<QA_BASE_URL>",
        "QA_MCP_TOKEN": "<QA_MCP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "simplify3x-connect": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "simplify3x-connect"
      ],
      "env": {
        "QA_MCP_PROVIDER": "<QA_MCP_PROVIDER>",
        "QA_BASE_URL": "<QA_BASE_URL>",
        "QA_MCP_TOKEN": "<QA_MCP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "simplify3x-connect": {
      "command": "npx",
      "args": [
        "-y",
        "simplify3x-connect"
      ],
      "env": {
        "QA_MCP_PROVIDER": "<QA_MCP_PROVIDER>",
        "QA_BASE_URL": "<QA_BASE_URL>",
        "QA_MCP_TOKEN": "<QA_MCP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "simplify3x-connect": {
      "command": "npx",
      "args": [
        "-y",
        "simplify3x-connect"
      ],
      "env": {
        "QA_MCP_PROVIDER": "<QA_MCP_PROVIDER>",
        "QA_BASE_URL": "<QA_BASE_URL>",
        "QA_MCP_TOKEN": "<QA_MCP_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Which products does it work with?

The README says it works with Walnut or SimplifyQA, selected with the QA_MCP_PROVIDER setting.

### Do I need the local agent?

No. With only QA_BASE_URL set it runs over REST with no recording. Recording needs QA_MCP_URL pointing at a running local agent.

### How is authentication handled?

It uses a raw product API token passed as QA_MCP_TOKEN, without a Bearer prefix. The HTTP gateway can also require a separate gateway token.

### Which clients are supported?

The README lists Claude Code, Claude Desktop, Codex CLI, Cursor, VS Code, Windsurf and Devin, and notes it needs Node 20 or later for the npm install.

### Is simplify3x-connect free?

Yes. simplify3x-connect is open source, so you can use and self-host it for free.

### How do I add simplify3x-connect to Claude Code?

Run this command in your terminal: claude mcp add simplify3x-connect --env QA_MCP_PROVIDER='<QA_MCP_PROVIDER>' --env QA_BASE_URL='<QA_BASE_URL>' --env QA_MCP_TOKEN='<QA_MCP_TOKEN>' -- npx -y simplify3x-connect

### What are the best alternatives to simplify3x-connect?

The closest alternatives to simplify3x-connect are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/simplify3x-connect
