Document the local MCP client setup and record the public-endpoint check with a customer token
Rust development slice / linux (push) Failing after 13s

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-21 14:49:23 +01:00
co-authored by Claude Opus 5.5
parent 9cd1bf1a6c
commit a1ef33ff21
2 changed files with 3 additions and 1 deletions
+1 -1
View File
@@ -57,7 +57,7 @@ Alle acht Versuche lieferten Exitcode 0. Bei beiden Neustarts wurde die Wiederan
| OPNsense-Aufnahme per HTTPS | Am 21. November wurde Revision `7201b18` aktiviert, das OPNsense-Paket `0.1.0-opnsense.6` mit nativem Worker auf dem Server abgelegt und der öffentliche Ingress um die OPNsense-Pfade ergänzt. Öffentlich: `/install/opnsense.sh` 200, Paketmetadaten und Dateien ohne gültigen Code 401, nicht gelistete Dateinamen 404. Auf der Test-VM `discovery-opnsense` (Kunde `9d730e0a-…`) lud der Befehl das Skript mit `fetch`, prüfte das Paket und aktualisierte die Programmdateien. Danach entsprachen `agent.pyz`, `collect.pyz` und `rmm-opnsense-jobs` den SHA-256 des Servers. Identität, Gerätschlüssel, Job-Bindung und Root-Policy waren unverändert, Agent, Collector und Root-Helper liefen, und die Firewall meldete sich mit neuer Verbindungsgeneration und Version `0.1.0-opnsense.6`. Ein ungültiger Code brach vor jeder Änderung ab. 87 WebUI-Tests und die Browsersuite bestanden. **Erstaufnahme, 21. November:** Eine neue Firewall mit OPNsense 24.7 (FreeBSD 14.1, Kunde `8285325f-…`) wurde aufgenommen, meldete Erfolg, erschien aber nicht in der WebUI. Der im FreeBSD-15-Testgast gelinkte Worker verlangte `FBSD_1.9` und lud dort nicht (`ld-elf.so.1 … version FBSD_1.9 … not found`). Der Agent baute den Kanal deshalb alle 30 Sekunden neu auf, ohne Heartbeat oder Inventur zu senden, und der Installer prüfte nur Version und Verbindungsgeneration. Mit Revision `93429e4` setzt der Agent (`0.1.0-opnsense.7`) die Skriptfähigkeiten eine Stunde aus und sendet weiter Telemetrie. Der Worker wird mit [dev_opnsense_worker.py](../tools/dev_opnsense_worker.py) gegen die pkgbase-Bibliotheken von FreeBSD 14.1 gelinkt (höchstens `FBSD_1.7`), und der Installer prüft das Laden des Workers und wartet auf einen Heartbeat. Belegt: Der neue Worker lud mit `LD_BIND_NOW=1` in `/tmp` der 24.7-Firewall und im Testgast, und der native Worker-Test bestand im Testgast unter `discovery`. Auf `discovery-opnsense` liefen Agent `0.1.0-opnsense.7` und der bisherige Worker mit fortlaufenden Heartbeats bei stabiler Verbindungsgeneration (die Root-Policy dort pinnt den bisherigen Worker-Hash). Um 11:34 UTC lief der öffentliche Installer mit einem neuen Einmalcode desselben Kunden auf der 24.7-Firewall als Aktualisierung (Identität und Bindung blieben, der Code wurde nicht verbraucht) und meldete Erfolg erst nach dem Heartbeat. Danach lief der neue Worker (`4100f1d5…`) unter `discovery`, das Systemlog zeigte keinen Fehler mehr, die Verbindungsgeneration blieb bei 354 und der Server führte Version `0.1.0-opnsense.7` mit `run_script`, fortlaufendem `last_contact_at` und `opnsense.base`-Snapshots der Qualität `valid` (11:34:47, 11:35:47). [Installer](../crates/server/src/bootstrap/opnsense_install.py) · [Paketauslieferung](../crates/server/src/bootstrap/opnsense.rs) |
| OPNsense am Proxmox-Host | Am 21. November ordnete der Server die Firewall `60f2df8d-…` (OPNsense 24.7, Kunde `8285325f-…`) nicht zu, obwohl der Proxmox-Host `a7935577-…` sie als VM 104 mit beiden MACs (`bc:24:11:c4:67:a5`, `bc:24:11:22:bf:5f`) führte. Der Abgleich las nur `linux.base` und `windows.base`. Revision `f3a471c` (deployt als Integrationsstand `d934a4a` mit dem laufenden MCP-Stand `22ffffa`) wertet auch den flachen `opnsense.base`-Snapshot aus und startet den Abgleich nach OPNsense-Inventuren. Ergebnis auf dem Server: `hypervisor_asset_id = a7935577-…`, `hypervisor_source = proxmox`, Audit `device_hypervisor_detected` um 12:09:16 UTC. Der DB-Test prüft zusätzlich eine virtuelle OPNsense (zugeordnet), eine fremde Kunden-OPNsense und eine physische OPNsense (beide nicht zugeordnet); alle 7 Gerätetests bestanden in isoliertem PostgreSQL mit RLS. Die WebUI-Darstellung wurde nicht im Browser angesehen. [Abgleich](../crates/server/src/proxmox_links.sql) |
| Installationsbefehl für Proxmox VE | Proxmox VE 9.2 enthält kein `sudo`. Auf dem Testhost am 21. November geprüft: `curl` und `python3` vorhanden, `sudo` fehlt. Der Linux-Befehl der WebUI brach dort deshalb ab. **Gerät aufnehmen** zeigt bei verfügbarem x86-64-Release zusätzlich den Block „Proxmox VE“ mit demselben Installer ohne `sudo` für eine Root-Shell, mit und ohne `--enable-admin-scripts`. 87 WebUI-Tests und der angepasste Browsertest der Aufnahmebefehle bestanden. [Aufnahme](../web/src/main.tsx) · [Proxmox-Host](../deploy/proxmox/README.md) |
| Lesende WebUI-Ansichten über MCP | Neue Werkzeuge `operations.list`, `operations.get_plan`, `inventory.list_hypervisors`, `catalog.list_package_recipes`, `catalog.list_windows_msi_recipes` und `catalog.get_artifact`. Lokal bestanden 68 Server-Tests sowie ein Datenbanktest auf isoliertem PostgreSQL mit berechtigtem und fremdem Kunden, fehlendem `operations:read`, ungültigen Eingaben und Tokenwiderruf. Am 21. November wurde Revision `49af111` mit Serverhash `9b07e3bf…` aktiviert; API und Gateway meldeten gesund. Über die interne Entwicklungs-API (Operator-Token des Entwicklungsprofils, nur lesende Aufrufe) listete `tools/list` 19 Werkzeuge ohne Genehmigungswerkzeug. Ohne Token antwortete `/mcp` mit 401. Für Kunde A lieferte `operations.list` drei Aufträge, `operations.get_plan` die Vorschau des neuesten Auftrags samt Plan-Hash und Payload. Hypervisor- und Rezeptlisten waren dort leer. Ein unbekannter Status ergab `VALIDATION_ERROR`, unbekannte Plan- und Artefakt-IDs sowie Kunde B `NOT_FOUND`. Eine Abfrage mit einem regulär ausgestellten Kunden-Token über den öffentlichen Endpunkt steht aus. [Werkzeuge](../crates/server/src/mcp.rs) · [Datenbanktest](../crates/server/src/local_auth.rs) |
| Lesende WebUI-Ansichten über MCP | Neue Werkzeuge `operations.list`, `operations.get_plan`, `inventory.list_hypervisors`, `catalog.list_package_recipes`, `catalog.list_windows_msi_recipes` und `catalog.get_artifact`. Lokal bestanden 68 Server-Tests sowie ein Datenbanktest auf isoliertem PostgreSQL mit berechtigtem und fremdem Kunden, fehlendem `operations:read`, ungültigen Eingaben und Tokenwiderruf. Am 21. November wurde Revision `49af111` mit Serverhash `9b07e3bf…` aktiviert; API und Gateway meldeten gesund. Über die interne Entwicklungs-API (Operator-Token des Entwicklungsprofils, nur lesende Aufrufe) listete `tools/list` 19 Werkzeuge ohne Genehmigungswerkzeug. Ohne Token antwortete `/mcp` mit 401. Für Kunde A lieferte `operations.list` drei Aufträge, `operations.get_plan` die Vorschau des neuesten Auftrags samt Plan-Hash und Payload. Hypervisor- und Rezeptlisten waren dort leer. Ein unbekannter Status ergab `VALIDATION_ERROR`, unbekannte Plan- und Artefakt-IDs sowie Kunde B `NOT_FOUND`. Am selben Tag verband sich Claude Code im Code-Tab der Desktop-App vom Entwicklungsnotebook mit einem regulär ausgestellten Kunden-Token über den öffentlichen Endpunkt (Revision `9cd1bf1`). `tenants.list` lieferte fünf Kunden. Für den Kunden „Ease Testserver“ lieferte `operations.list` die drei letzten OPNsense-Aufträge, `operations.get_plan` deren Vorschau mit Skriptinhalt und Plan-Hash ohne Byte-Array, `inventory.list_hypervisors` den Proxmox-Host `pve`. Die Rezeptlisten waren leer, ein unbekannter Status ergab `VALIDATION_ERROR`, eine unbekannte Artefakt-ID `NOT_FOUND`. Ein claude.ai-Konnektor erreichte den Endpunkt nicht: Ein Mitschnitt zeigte seine Verbindung aus Anthropics Adressbereich auf Port 443, dort liegt das Agentengateway. [Werkzeuge](../crates/server/src/mcp.rs) · [Datenbanktest](../crates/server/src/local_auth.rs) |
| Von der Auswahl zur Ausgabe | Die WebUI bindet die ausgewählte Skriptversion, zeigt den Inhalt vor Genehmigung und verlinkt das Ergebnis je Gerät. Ein abgelehnter Antrag erzeugte null Jobs. [Auftragsablauf](evidence/webui-auftragsablauf-20261117.json) · [Ergebnislinks und Entscheidungen](evidence/webui-order-history-20261118.json) Auf OTRS ARM64 wurde der Root-Skript-Helper nachträglich mit dem HTTPS-Installer aktiviert. Die zentrale Geräteregel bindet das berechtigte WebUI-Konto an diese Installation und den signierten Helper. Die öffentliche WebUI-Vorschau akzeptierte Root für OTRS. Die Probe blieb bei einer Vorschau und erzeugte null Anträge, Jobs, Outbox-Einträge und Startgrants. [OTRS-Nachweis](evidence/linux-arm64-otrs-root-helper-20261118.json) |
| Frische Installation und periodisches Agentupdate | Beide VMs wurden über HTTPS aufgenommen und übernahmen anschließend ein signiertes Folgepaket mit derselben Geräteidentität. Auf Windows ist der öffentliche GNU-Kanal einschließlich Prüfung des offiziellen Schlüssels belegt. [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows GNU](evidence/windows-gnu-official-vm-20261118.json). ARM64 erweitert denselben HTTPS-Installer mit automatischer Architekturerkennung. Release `0.1.0-arm64.1` ist veröffentlicht und als Starter verfügbar. Auf Ubuntu 22.04.5 ARM64 wurden die öffentlichen Downloads, die Signaturprüfung, die Ablehnung einer veränderten Agentdatei und der native Start aller drei Dateien im Prüfmodus beobachtet. OTRS ist mit Gerätezertifikat aufgenommen und meldet authentisierte Heartbeats. Die erste Kontaktprüfung wartet seit der Korrektur auf das Zertifikat. Der öffentliche Installer lief auf OTRS erneut ohne Traceback und ohne neuen Einmalcode. Der ARM64-Katalogabruf ist bestätigt. Ein späterer Versionswechsel auf ARM64 steht aus. [ARM64-Release](evidence/linux-arm64-installer-20261118.json) · [Geräteaufnahme und Nachtest](evidence/linux-arm64-enrollment-heartbeat-20261118.json) |
| Erste Windows-Meldung ohne `DisplayVersion` | Bei einem betroffenen Gerät nahm das Gateway das Enrollment und die authentisierten Verbindungsaufbauten an, erhielt aber weder Inventar noch Heartbeat. Windows GNU `0.1.26` aus `037b5e3` nutzt bei fehlendem `DisplayVersion` den Registrywert `ReleaseId` oder meldet Produkt und Build ohne Versionsbezeichnung. Drei Regressionen und die Inventarprobe liefen nativ auf der Windows-Test-VM. Das offiziell signierte Paket (Sequenz 27) ist im Katalog des betroffenen Kunden und als Starter für neue Windows-Kataloge verfügbar. Die Test-VM übernahm das reguläre Update, meldete einen neuen Heartbeat mit derselben Identität und startete beide signierten Binärdateien mit den erwarteten Hashes. Die erneute Meldung des betroffenen Geräts mit derselben Identität steht aus. Bei durch den Erstkontakt blockiertem Installer den vorhandenen `RmmDiscoveryReleasePull` lokal starten; nach erfolgreichem Update den Installer mit derselben Identität abschließen. [Nachweis](evidence/windows-missing-display-version-20261119.json) |
+2
View File
@@ -53,6 +53,8 @@ Unter **Verwaltung → MCP-Tokens** Namen, Kundenkreis, Rechte und Ablaufdatum f
Authorization: Bearer <MCP-Token>
```
Der MCP-Client verbindet sich direkt vom Arbeitsrechner per Streamable HTTP mit `https://discovery.ease-technologies.de:8443/mcp`. Für Claude Code (auch im Code-Tab der Desktop-App) steht der Server in der Benutzerkonfiguration `~/.claude.json` unter `mcpServers` mit `"type": "http"`, dieser URL und dem Header. Die Werkzeuge erscheinen in einer neu gestarteten Sitzung. Ein Konnektor in den claude.ai-Einstellungen funktioniert nicht: Er verbindet von Anthropics Servern nur über Port 443 und erwartet eine OAuth-Anmeldung. Ohne gültigen Token antwortet `/mcp` mit 401 und `WWW-Authenticate: Bearer`.
Wirksam sind die erteilten Scopes innerhalb der aktuellen Kundenrechte. Der Widerruf greift bei der nächsten Prüfung auch in einer bestehenden MCP-Sitzung. Die Tokenverwaltung erfordert eine persönliche WebUI-Sitzung mit `tokens:manage`. Folgende Werkzeuge veröffentlicht der Server. [Werkzeugdefinitionen](../crates/server/src/mcp.rs)
| Werkzeug | Funktion und Rechte im Zielkunden |