qa-touch-mcp

MCP-Server (Model Context Protocol) für die Testmanagement-API von QA Touch. Ermöglicht KI-Assistenten wie Claude, Projekte zu durchsuchen, Testfälle zu verwalten, Testläufe zu steuern, Ergebnisse aufzuzeichnen und Fehler in Ihrer QA Touch-Domain anzulegen.

Voraussetzungen

• Node.js 18+

• Ein QA Touch-Konto mit einem Professional- oder Enterprise-Plan (die API ist auf diese Pläne beschränkt)

• Ein API-Token: Gehen Sie in QA Touch zu Profil → Profil bearbiten → API-Schlüssel generieren

Related MCP server: Testmo MCP Server

Konfiguration

Der Server wird ausschließlich über Umgebungsvariablen konfiguriert:

Das Token gewährt Zugriff auf alle Daten in Ihrer QA Touch-Domain. Halten Sie es aus der Versionsverwaltung heraus.

Installation

Claude Code

claude mcp add qa-touch --env QATOUCH_DOMAIN=yourdomain --env QATOUCH_API_TOKEN=yourtoken -- npx qa-touch-mcp

Claude Desktop

Fügen Sie Folgendes zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "qa-touch": {
      "command": "npx",
      "args": ["qa-touch-mcp"],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

Aus dem Quellcode

npm install
npm run build
QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken node dist/index.js

Werkzeuge (32)

Projekte — list_projects, get_project, create_project

Testfälle & Module — list_test_cases (Filter nach Genehmigungsstatus, Modul, Modus oder Anforderung), get_test_case, get_test_case_steps, list_modules, create_module, create_test_case (explorativ / Text / BDD / Schrittvorlagen), update_test_case, import_test_cases_csv

Releases & Pläne — list_releases, create_release, list_test_plans, list_workspaces

Testläufe & Ergebnisse — list_test_runs, get_test_run, create_test_run (alle Testfälle / bestimmte Testfälle / nach Modul), clone_test_run, list_test_run_results (nach Testlauf, Release, Verlauf oder Testfall), get_test_run_metadata, update_test_result, update_test_result_steps, bulk_update_test_results, update_test_results_multi, add_test_result (mit Anhängen)

Fehler — list_defects, create_defect (mit Anhängen), get_defect_metadata

Anforderungen — list_requirements, create_requirement_document, create_requirement

Verhaltenshinweise

• Ratenbegrenzung: QA Touch erlaubt 50 Anfragen pro Minute. Der Server drosselt clientseitig und wiederholt die Anfrage einmal bei 429, wobei Retry-After berücksichtigt wird.

• Paginierung: Listenwerkzeuge akzeptieren einen Parameter page. Die QA Touch-API gibt meta.current_page/last_page auf Seite 1 als null zurück; der Server normalisiert dies und fügt ein has_next-Flag hinzu.

• Anhänge: png, pdf, jpg, jpeg, gif, xls, xlsx, doc, docx, csv, log, zip, txt — maximal 2 MB pro Datei, vor dem Hochladen validiert.

• Batch-Grenzen: Statusaktualisierungen für mehrere Testfälle sind auf 20 Einträge pro Aufruf begrenzt, da die API Parameter in der URL erwartet und zu lange URIs ablehnt.

Entwicklung

npm run build   # compile TypeScript
npm test        # run unit tests (vitest)

API-Referenznotizen, die für diese Implementierung verwendet wurden: docs/qatouch-api-reference.md.