codebeamer-mcp

Ein MCP-Server (Model Context Protocol) für Codebeamer ALM. Ermöglicht es Claude und anderen MCP-Clients, Projekte, Tracker und Elemente in Codebeamer mithilfe natürlicher Sprache zu lesen und zu schreiben.

codebeamer-mcp MCP server

Tools (18)

Lesen

Tool	Beschreibung
`list_projects`	Alle Projekte auflisten
`get_project`	Projektdetails abrufen
`list_trackers`	Tracker in einem Projekt auflisten
`get_tracker`	Tracker-Details abrufen
`list_tracker_items`	Elemente in einem Tracker auflisten
`search_items`	Volltext- / cbQL-Suche
`get_item`	Elementdetails abrufen, einschließlich Testschritten (Aktion + erwartetes Ergebnis) für Testfall-Elemente
`get_item_relations`	Ausgehende/eingehende Assoziationen abrufen (hängt ab von, blockiert, …)
`get_item_references`	Upstream/Downstream-Rückverfolgbarkeitsreferenzen abrufen (abgeleitet von, deckt ab, …)
`get_item_comments`	Elementkommentare abrufen
`get_item_reviews`	Review Hub-Reviews für ein Element abrufen (Ergebnis, Reviewer, Stimmen)
`get_user`	Benutzerdetails abrufen

Schreiben

Tool	Beschreibung
`create_item`	Ein neues Element in einem Tracker erstellen. Unterstützt Ordner, Elementtyp und übergeordnete Verschachtelung
`update_item`	Ein bestehendes Element aktualisieren (Name, Beschreibung, Status, Priorität, Bearbeiter, benutzerdefinierte Felder)
`add_comment`	Einen Kommentar zu einem Element hinzufügen
`create_association`	Eine Assoziation zwischen zwei Elementen erstellen (z. B. hängt ab von, blockiert)
`create_reference`	Eine Downstream-Rückverfolgbarkeitsreferenz zwischen zwei Elementen hinzufügen
`create_harm`	Einen Schadenseintrag in einem RM Harms List-Tracker mit IMDRF-Code und Schweregrad (1–5) erstellen

Installation

Anforderungen

Node.js 20+
Zugriff auf eine Codebeamer-Instanz (URL, Benutzername, Passwort)

Claude Code (CLI)

Der schnellste Weg — führen Sie diesen Befehl in Ihrem Terminal aus:

claude mcp add codebeamer -e CB_URL=https://your-instance.example.com/cb/api \
  -e CB_USERNAME=your_username -e CB_PASSWORD=your_password \
  -- npx -y codebeamer-mcp

Oder fügen Sie ihn manuell zu .mcp.json im Projektstammverzeichnis (oder ~/.claude/mcp.json für den globalen Bereich) hinzu:

{
  "mcpServers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop

Bearbeiten Sie die Konfigurationsdatei für Ihre Plattform:

Plattform	Pfad
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Cursor

Fügen Sie dies zu .cursor/mcp.json im Projektstammverzeichnis (Projektbereich) oder ~/.cursor/mcp.json (global) hinzu:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Windsurf

Fügen Sie dies zu ~/.codeium/windsurf/mcp_config.json hinzu:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

VS Code (Copilot)

Fügen Sie dies zu .vscode/mcp.json im Projektstammverzeichnis hinzu:

{
  "servers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Gemini CLI

Fügen Sie dies zu ~/.gemini/settings.json hinzu:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Alternative: globale Installation

npm install -g codebeamer-mcp

Verwenden Sie dann "command": "codebeamer-mcp" (keine args) anstelle von npx in einer der oben genannten Konfigurationen.

Fixieren einer bestimmten Version

"args": ["-y", "codebeamer-mcp@0.2.0"]

Updates

Methode	Update-Verhalten
`npx -y codebeamer-mcp`	Ruft immer die neueste Version ab
`npm install -g codebeamer-mcp`	Bleibt bei der installierten Version. Führen Sie `npm update -g codebeamer-mcp` zum Aktualisieren aus
Fixierte Version (`@0.2.0`)	Führt nie automatische Updates durch; ändern Sie den Versions-String manuell

⚠️ Committen Sie niemals .mcp.json mit echten Anmeldedaten — sie ist in .gitignore aufgeführt.

Aus dem Quellcode (Entwicklung)

git clone https://github.com/3KniGHtcZ/codebeamer-mcp.git
cd codebeamer-mcp
npm install
npm run build

Verwenden Sie dann "command": "node" mit "args": ["dist/index.js"] in Ihrer .mcp.json.

Entwicklung & Testen

# Run tests (no real Codebeamer instance needed)
npm test

# Start the mock API server (port 3001)
node mock-server.mjs

# Interactive testing via MCP Inspector
CB_URL=http://localhost:3001 CB_USERNAME=mock CB_PASSWORD=mock \
  npx @modelcontextprotocol/inspector node dist/index.js

Konfiguration

Variable	Beschreibung	Standard
`CB_URL`	Codebeamer API-URL, z. B. `https://your-instance.example.com/cb/api` (der Server fügt `/v3` automatisch hinzu)	(erforderlich)
`CB_USERNAME`	Anmelde-Benutzername	(erforderlich)
`CB_PASSWORD`	Passwort	(erforderlich)
`CB_UNSAFE_SSL`	Auf `true` setzen, um Verbindungen zu Servern mit nicht verifizierten/selbstsignierten Zertifikaten zu erlauben	`false`
`CB_API_VERSION`	API-Version	`v3`
`CB_TIMEOUT_MS`	Request-Timeout (ms)	`30000`
`CB_MAX_ITEMS`	Maximale Elemente pro Seite	`100`

codebeamer-mcp

codebeamer-mcp

Tools (18)

Lesen

Schreiben

Installation

Anforderungen

Claude Code (CLI)

Claude Desktop

Cursor

Windsurf

VS Code (Copilot)

Gemini CLI

Alternative: globale Installation

Fixieren einer bestimmten Version

Updates

Aus dem Quellcode (Entwicklung)

Entwicklung & Testen

Konfiguration

Resources

Tools

Latest Blog Posts

MCP directory API