Common QA MCP

One product-neutral MCP that any AI client (Claude Code, Cursor, Windsurf, VS Code, Codex, Devin) connects to with a URL + token to drive the whole test-case lifecycle — discover · author · record · run · triage — against Walnut or SimplifyQA. The client sees one tool vocabulary regardless of the product behind it.

Install

Nothing to clone or build — clients launch it over stdio with npx. Requires Node ≥ 20.

Add it to your client's MCP config (.mcp.json for Claude Code / Cursor / Windsurf):

{
  "mcpServers": {
    "common-qa-mcp": {
      "command": "npx",
      "args": ["-y", "common-qa-mcp"],
      "env": {
        "QA_MCP_PROVIDER": "walnut",
        "QA_BASE_URL": "https://<your-backend>",
        "QA_MCP_URL": "http://127.0.0.1:4050/mcp",
        "QA_MCP_TOKEN": "<your-token>",
        "QA_MCP_PROJECT_ID": "<optional-project-id>"
      }
    }
  }
}

| Env var | Required | Purpose | |---|:---:|---| | QA_MCP_PROVIDER | — | walnut (default) or simplifyqa. | | QA_BASE_URL | ✓* | Product backend REST — drives discover / author / run / triage (no agent needed). | | QA_MCP_URL | ✓* | Your local agent's /mcp — adds recording + journal editing (browser / mainframe). | | QA_MCP_TOKEN | ✓ | Raw auth token (JWT — no Bearer prefix). | | QA_MCP_PROJECT_ID | — | Pin a default project; omit and you'll be asked (change anytime with qa_switch_project). |

* Set QA_BASE_URL for the lifecycle over direct REST, and QA_MCP_URL to add recording. Set both for the full experience, or only QA_BASE_URL for a zero-agent setup (no recording). With neither set it starts offline — draft authoring only — and you connect later from chat with qa_connect.

Recording (web / mainframe/ mobile) runs on the local agent, so QA_MCP_URL must point at a running agent.

Install the QA agent (optional)

Drops a QA persona + tool guidance into your project so the client knows how to drive these tools:

npx common-qa-mcp init-agents --loop=claude   # claude | cursor | windsurf | vscode | codex | devin | all
#   --server-name <name>   # must match your MCP server name (default: common-qa-mcp)

Use it

Reload your client, then drive it in plain language:

• "List my projects" → "switch to project X"
• "Record a login test on web" → answer the setup questions → review the draft → "save it"
• "Run TC_123 on cloud" · "show me the login stories" · "add a loop around steps 3–5 of TC_42"