docs: README — Windows-Arbeitsrechner (native .exe + Claude Desktop) ergaenzt
CI / test (push) Successful in 11m41s

This commit is contained in:
2026-06-24 14:44:56 +00:00
parent 1719f610f5
commit 1c2a1f50dc
+60 -1
View File
@@ -7,7 +7,7 @@ Zwei Frontends, eine gemeinsame Tool-Logik:
| Modus | Binary | Einsatz |
|---|---|---|
| **stdio** | `dtrack-stdio` | Lokal: von Claude Desktop via `docker run -i` gestartet |
| **stdio** | `dtrack-stdio` | Lokal/Arbeitsrechner: von Claude Desktop gestartet (`docker run -i` oder native `.exe`) |
| **HTTP** | `dtrack-http` | Server: StreamableHTTP `/mcp`, Multi-Client, Bearer-Auth/RBAC, Admin-UI |
> **Status: Stage 3** -- HTTP-Frontend, Bearer-Auth, persistente Config,
@@ -161,6 +161,65 @@ docker load -i dtrack-stdio-0.1.0-amd64.tar.gz
> und den vollen Pfad als `command` setzen (z.B. `/usr/local/bin/docker`).
> Das stdio-Release-Image ist amd64 -> laeuft auf Apple Silicon emuliert (ok zum Testen).
### Windows (Arbeitsrechner): native `.exe` -- empfohlen hinter Firmen-VPN
Auf Windows ist die native `.exe` der zuverlaessigste Weg: sie laeuft im
Netz-Kontext des Windows-Hosts, also greift die **VPN-Route zur Firmen-DT
direkt**. Container (Docker/Podman Desktop) laufen dagegen in einer WSL2-VM --
`--network=host` bindet dort an die VM, und die DT ueber die Host-VPN ist von da
drin oft nicht erreichbar.
**1. `.exe` bauen** -- Cross-Compile von CachyOS aus. reqwest nutzt rustls (kein
OpenSSL), darum keine nativen TLS-Libs noetig, nur der MinGW-Linker:
```sh
rustup target add x86_64-pc-windows-gnu
sudo pacman -S --needed mingw-w64-gcc
cargo build --release --target x86_64-pc-windows-gnu --bin dtrack-stdio
# -> target/x86_64-pc-windows-gnu/release/dtrack-stdio.exe
```
Findet cargo den Linker nicht, in `.cargo/config.toml`:
```toml
[target.x86_64-pc-windows-gnu]
linker = "x86_64-w64-mingw32-gcc"
```
> **Fallback**, falls der rustls-Crypto-Provider beim `windows-gnu`-Cross zickt:
> direkt auf dem Windows-Rechner mit rustup/MSVC bauen --
> `cargo build --release --bin dtrack-stdio` erzeugt dieselbe `.exe`.
Die `dtrack-stdio.exe` dann auf den Arbeitsrechner ziehen, z.B. nach
`C:\Tools\dtrack-mcp\dtrack-stdio.exe`.
**2. Claude Desktop einbinden** -- Config-Datei unter Windows:
`%APPDATA%\Claude\claude_desktop_config.json`
(oder **Settings -> Developer -> Edit Config**):
```json
{
"mcpServers": {
"dependency-track": {
"command": "C:\\Tools\\dtrack-mcp\\dtrack-stdio.exe",
"env": {
"DTRACK_URL": "https://dtrack.firma.intern",
"DTRACK_API_KEY": "odt_...",
"DTRACK_INSECURE": "0"
}
}
}
}
```
Pfad mit doppelten Backslashes (oder Forward-Slashes). Bei internem CA-Cert
`DTRACK_INSECURE` auf `"1"` setzen. Danach Desktop **komplett neu starten**.
**3. Testen** -- VPN verbinden, im Chat z.B. *"liste die DT-Projekte"* ->
`list_projects` muss Treffer liefern. Kommt nichts: `DTRACK_URL`/Key pruefen,
bei TLS-Fehler `DTRACK_INSECURE=1`, VPN-Verbindung pruefen. Logs:
`%APPDATA%\Claude\logs\mcp*.log`.
### HTTP als echter Remote-Connector
Der HTTP-Modus ist fuer den Betrieb als **oeffentlich erreichbarer** Remote-MCP