Configuración

Requisitos previos

• Node.js 18+
• Una instancia de QA Hub (cloud o autoalojada)
• Un token de API de QA Hub con scope write
• Claude Code o Claude Desktop (cualquier plan)

Instalar el servidor MCP

# Desde dentro del repo de qa-hub
cd packages/mcp-test-architect
pnpm install
pnpm build

El servidor compilado está en packages/mcp-test-architect/dist/index.js.

Configurar el servidor MCP

Claude Code (recomendado)

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

O añádelo a .claude/mcp.json en tu proyecto:

{
  "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

Edita ~/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"
      }
    }
  }
}

Obtener tu token de API

1. Ve a Settings → Developer → API Tokens en QA Hub.
2. Haz clic en Create token → selecciona el scope write.
3. Copia el token completo y añádelo a tu configuración de MCP.

Verificar la configuración

En Claude Code o Desktop, pregunta:

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

El agente llama a analyze_architecture o load_tickets y devuelve tu lista de proyectos. Si hay un error, verifica que QA_HUB_URL y QA_HUB_TOKEN estén correctamente configurados.

Configurar el proveedor de IA

El Architect usa el proveedor de IA configurado en QA Hub (AiConfig) para toda la generación — no usa las capacidades de IA propias del cliente MCP para la generación. Configura tu proveedor de IA en Settings → AI Model antes de ejecutar tareas de generación.

Variables de entorno

Variable	Requerida	Descripción
QA_HUB_URL	Sí	URL base de tu instancia de QA Hub
QA_HUB_TOKEN	Sí	Token de API con scope write