Setup

Prerequisites

• Node.js 18+
• A QA Hub instance (cloud or self-hosted)
• A QA Hub API token with write scope
• Claude Code or Claude Desktop (any plan)

Install the MCP server

# From within the qa-hub repo
cd packages/mcp-test-architect
pnpm install
pnpm build

The compiled server is at packages/mcp-test-architect/dist/index.js.

Configure the MCP server

Claude Code (recommended)

claude mcp add qa-hub-architect \
  node /path/to/qa-hub/packages/mcp-test-architect/dist/index.js

Or add it to .claude/mcp.json in your project:

{
  "mcpServers": {
    "qa-hub-architect": {
      "command": "node",
      "args": ["/path/to/qa-hub/packages/mcp-test-architect/dist/index.js"],
      "env": {
        "QA_HUB_URL": "https://your-qahub.com",
        "QA_HUB_TOKEN": "qh_abc_yoursecret"
      }
    }
  }
}

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "qa-hub-architect": {
      "command": "node",
      "args": ["/path/to/qa-hub/packages/mcp-test-architect/dist/index.js"],
      "env": {
        "QA_HUB_URL": "https://your-qahub.com",
        "QA_HUB_TOKEN": "qh_abc_yoursecret"
      }
    }
  }
}

Get your API token

1. Go to Settings → Developer → API Tokens in QA Hub.
2. Click Create token → select write scope.
3. Copy the full token and add it to your MCP config.

Verify the setup

In Claude Code or Desktop, ask:

"Use the QA Hub Architect to check my connection and tell me what projects I have."

The agent calls analyze_architecture or load_tickets and returns your project list. If it errors, check that QA_HUB_URL and QA_HUB_TOKEN are set correctly.

Configure AI provider

The Architect uses QA Hub's configured AI provider (AiConfig) for all generation — it does not use the MCP client's own AI capabilities for generation. Set up your AI provider in Settings → AI Model before running generation tasks.

Environment variables

Variable	Required	Description
QA_HUB_URL	Yes	Base URL of your QA Hub instance
QA_HUB_TOKEN	Yes	API token with write scope