TestRail MCP-Server

Dieser Model Context Protocol (MCP)-Server bietet Tools für die Interaktion mit TestRail direkt aus Claude AI und anderen MCP-unterstützten Clients wie Cursor heraus. Er ermöglicht es Ihnen, Testfälle, Projekte, Suiten, Läufe und mehr zu verwalten, ohne Ihr Gespräch mit der KI zu verlassen.

Verfügbare Tools

Der TestRail MCP-Server bietet die folgenden Tools:

Related MCP server: TestRail MCP Server

Verwendung

Sie können diesen MCP-Server verbinden, indem Sie die folgende Einstellung vornehmen. Diese Methode verwendet npx, um automatisch die neueste Version des Pakets herunterzuladen und auszuführen, wodurch eine lokale Installation nicht erforderlich ist.

// Example configuration using npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // Replace with your TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // Replace with your TestRail username
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
      }
    }
  }
}

Fehlerbehebung

• spawn node ENOENT-Fehler: Stellen Sie sicher, dass Node.js korrekt installiert ist und sich in Ihrem PATH befindet.

• Authentifizierungsprobleme: Überprüfen Sie Ihre TestRail-API-Anmeldedaten.

• Ihr Gespräch ist zu lang: Verwenden Sie die Parameter limit und offset für Testfälle und Abschnitte, um Ergebnisse zu paginieren.

• HTTP 400-Fehler beim Erstellen/Aktualisieren von Testfällen: TestRail-Projekte haben unterschiedliche Vorlagen, benutzerdefinierte Felder und Pflichtfelder. Dieser MCP-Server übergibt Ihre Parameter direkt an die TestRail-API – er validiert oder transformiert sie nicht. Wenn Sie auf 400-Fehler stoßen, definieren Sie die Regeln Ihres Projekts in CLAUDE.md oder AGENTS.md, damit das LLM die korrekten Parameter sendet. Zum Beispiel:

  # TestRail Rules for This Project
  - Project ID: 1
  - Always use template 2 (Separated Steps) when creating test cases
    - Use `customStepsSeparated` (array of step objects)
    - Do NOT send `customSteps` or `customExpected` with template 2
  - Required custom fields: custom_automation_type (default: 0)
  - Call `getCaseFields` at the start of a session to check available fields

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.

Danksagungen

• TestRail API

• Model Context Protocol SDK