Expose the WebUI's read views through MCP: order list, plan preview, hypervisors and catalog
New tools operations.list, operations.get_plan, inventory.list_hypervisors, catalog.list_package_recipes, catalog.list_windows_msi_recipes and catalog.get_artifact reuse the WebUI handlers and their tenant and scope checks. Interactive-only actions (approvals, device management, customer transfer, enrollment, emergency stop, imports, tokens) stay out of MCP and are listed as such in the access guide and product contract. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -59,14 +59,20 @@ Wirksam sind die erteilten Scopes innerhalb der aktuellen Kundenrechte. Der Wide
|
||||
| --- | --- |
|
||||
| `tenants.list` | Kunden auflisten, in denen der Token wirksames `inventory:read` besitzt. |
|
||||
| `inventory.list_devices`, `inventory.get_device`, `monitoring.get_health` | Bestand, Gerätedetail und gespeicherte Statusmeldungen mit `inventory:read`. Die Bestandsliste unterstützt `view=history`. |
|
||||
| `inventory.list_hypervisors` | Registrierte Hypervisoren eines Kunden mit `inventory:read`, höchstens 50, optional nach Hostname gefiltert. |
|
||||
| `scripts.list`, `updates.list_releases` | Skriptversionen samt Inhalt bzw. veröffentlichte Agent-Releases mit `operations:read` lesen. |
|
||||
| `catalog.list_package_recipes`, `catalog.list_windows_msi_recipes`, `catalog.get_artifact` | Paket- und MSI-Rezepte bzw. ein einzelnes Katalogartefakt (Base64 mit SHA-256, höchstens 256 KiB) mit `operations:read` lesen. |
|
||||
| `scripts.publish` | Mit `operations:plan` und `scripts:execute` eine unveränderliche Version veröffentlichen. Für einen neuen Namen `expected_version` auf `0` setzen, für eine weitere Version die bisherige Versionsnummer übergeben. |
|
||||
| `scripts.plan`, `operations.plan` | Eine Bibliotheksrevision bzw. ein einmaliges Skript mit `operations:plan` und `scripts:execute` an konkrete Geräte binden. Für Administratoren gilt zusätzlich das Plattformrecht. |
|
||||
| `operations.submit` | Den Plan über `plan_id` und einen stabilen `idempotency_key` einreichen. Erfordert `operations:submit`, `operations:read` und die Ausführungsrechte. Der Zustand lautet zunächst `pending_approval`. |
|
||||
| `operations.get_plan` | Mit `operations:read` die feste Vorschau eines Plans über `plan_id` lesen: Ziele, Skriptbytes, Rechte, Zeitfenster und Genehmigungsstatus. |
|
||||
| `operations.list` | Mit `operations:read` die Aufträge wie unter **Aufträge** auflisten und nach Text (`q`), Gerät, Status und Zeitraum (`from`, `until`) filtern. |
|
||||
| `jobs.get` | Mit `operations:read` über `operation_id` den Antrag und seine Jobs abfragen. Eine anschließende Abfrage mit genau einer `job_id` liefert das einzelne Ergebnis. |
|
||||
| `jobs.cancel` | Mit `jobs:cancel` und Begründung einen Abbruch anfordern. Mit `operations:read` die Antwort und den tatsächlichen Endzustand lesen. |
|
||||
| `logs.query` | Bereits gespeicherte Protokolle mit `logs:read` abfragen. Sensible Protokolle benötigen zusätzlich `logs:read_sensitive`. |
|
||||
|
||||
Folgende WebUI-Funktionen verlangen eine persönliche Sitzung und stehen über MCP nicht zur Verfügung: Genehmigen und Ablehnen, Planwiderruf, Abschluss ungeklärter Jobs, Kunden anlegen und umbenennen, Einmalcodes zur Geräteaufnahme, Zweck, Hypervisorzuordnung, Archivieren, Widerrufen und Löschen von Geräten, Kundenwechsel, Notstopp, Katalog- und Releaseimporte sowie die Tokenverwaltung. Der Server lehnt solche Anfragen mit einem Token mit `INTERACTIVE_AUTH_REQUIRED` ab.
|
||||
|
||||
### Administrator-Skripte anfordern
|
||||
|
||||
Ein Administratorauftrag braucht auf Linux `root:execute`, auf Windows `system:execute`, zusätzlich zu den Skript- und Auftragsrechten. Für ein einmaliges Administrator-Skript das Profil `full_maintenance_v1` angeben. Bei Auswahl aus der Bibliothek setzt der Server das Profil passend zur gewählten Identität. Für Windows kann die PowerShell-Variante `powershell_51_remote_signed` an den Prozess binden. Die vollständigen MCP-Eingaben liefert `tools/list`.
|
||||
|
||||
Reference in New Issue
Block a user