MCP – Admin-Oberfläche

Status: produktiv seit 08.09.2026. Die Admin-Oberfläche unter https://mcp.diebrocks.com/admin verwaltet die menschlichen Sicherheits- und Wartungsfreigaben des zentralen MCP.

Oberfläche

Die Seite läuft separat vom MCP-Prozess auf Port 3001 als root und ist über Cloudflare Access geschützt. Sie verwendet ausschließlich lokale HTML-, CSS- und JavaScript-Dateien sowie Systemschriften.

Funktionen:

• Status des MCP-Dienstes anzeigen;
• shell_execute freigeben beziehungsweise wieder sperren;
• Tool-Freigaben nach Kategorie anzeigen und ändern;
• tool-config.json mit Versionsprüfung bearbeiten;
• Audit-v2 und ältere Einträge anzeigen;
• nach Fehlern beziehungsweise Sperren filtern;
• MCP-Dienst für Recovery neu starten.

Das Sperren der Shell ist direkt möglich. Für die Freigabe der Shell und einen MCP-Neustart ist eine bewusste Bestätigung vorgesehen.

Tool-Policy

Die Admin-Oberfläche verwendet dieselbe fail-closed Policy-Schicht wie der MCP:

/opt/mcp-shell/tool-config.json
/opt/mcp-shell/lib/tool-policy.js
/opt/mcp-admin/policy-routes.js
/opt/mcp-admin/policy-client.js

Beim Speichern wird die zuvor gelesene Revision geprüft. Ein veraltetes Browserfenster darf einen neueren Stand nicht überschreiben. Eine fehlende oder ungültige Policy führt nicht zu stillen Standardfreigaben.

Details: Tool-Freigaben absichern.

Audit-Anzeige

Die Admin-Oberfläche liest das aktuelle Audit unter /var/log/mcp-audit/. Das Schreiben erfolgt nicht durch die Admin-Seite, sondern durch den root-eigenen mcp-audit-writer.

Aktueller Zustand:

• Audit-v2 speichert nur minimierte Metadaten;
• Prozessfehler und Exitcodes werden strukturiert dargestellt;
• der Benutzer mcp kann die Audit-Dateien nicht direkt verändern;
• HA-Bridge-Aufrufe erscheinen mit Caller-/Client-Kategorisierung, aber ohne HA-Argumente oder Antworten.

Details: Audit-Inhalte, Audit-Integrität und Home Assistant Bridge.

Wiki-Schreibregeln

Die Regel für deutsche Umlaute und ß ist an mehreren Stellen im produktiven MCP hinterlegt:

• /opt/mcp-shell/rules/global.md;
• Tool-Beschreibungen in /opt/mcp-shell/tool-registry.js;
• Parameterbeschreibungen in /opt/mcp-shell/tools/wiki.js.

Technische Kennungen, Dateipfade, URLs, Befehle, Codeblöcke und wörtliche Zitate werden dabei nicht verändert.

Installierte Dateien

/opt/mcp-admin/server.js
/opt/mcp-admin/policy-routes.js
/opt/mcp-admin/policy-client.js
/opt/mcp-admin/admin.html
/opt/mcp-admin/admin.css

Die Node-Module werden aus dem MCP-Bestand verwendet.

Inzwischen erledigte frühere offene Punkte

Zum Zeitpunkt des ursprünglichen Admin-UI-Deployments waren zwei Punkte noch offen. Beide sind inzwischen separat abgeschlossen:

• die fehlerhafte frühere run()-Fehlerweitergabe wurde durch Befehlsfehler und Exitcodes behoben;
• das Audit wurde durch Audit-Integrität auf einen root-eigenen Writer umgestellt.

Eine ältere Aussage „run() ist der nächste offene Patch“ ist deshalb nicht mehr aktuell.

Wartung

Nach Änderungen an Admin-Dateien:

1. Syntax und Browser-JavaScript prüfen;
2. Backup anlegen;
3. mcp-admin neu starten;
4. angemeldete Seite vollständig neu laden;
5. Policy-Anzeige und Audit-Lesen prüfen.

Nach Änderungen an Tool-Beschreibungen muss zusätzlich der MCP-Client seine Tool-Metadaten neu laden.

Historische Installationsunterlagen

/root/mcp-admin-light-umlauts-20260908.tar.gz
/root/mcp-admin-light-backup-20260908T064339Z.otaioZ/rollback.sh
/root/mcp-admin-light-20260908.DKnV5w
/tmp/mcp-admin-light-test.69VuDy

Für einen vollständigen Wiederaufbau ist die aktuelle MCP-Neuinstallation maßgeblich.