KNP Bauphysik · Zielbild

KI-Systemarchitektur: intern vertraulich, extern leistungsfähig

Die Architektur trennt echte KNP-Projektdaten von Agenten- und Rechenarbeit. Sie erklärt bewusst auch den Unterschied zwischen einem normalen KI-Chat, einem Agenten mit Linux-Zugriff und einer MCP-Werkzeugschnittstelle – damit die Sicherheitsgrenzen nachvollziehbar bleiben.

Stand: 19. September 2026 · Architektur v0.10
KNP-intern

E-Mail & Projektdaten

Original-E-Mails, Access, Projektordner, Kunden und Projektnummern bleiben vollständig im Büro.

Lokale KI

Verstehen + recherchieren

Lokales LLM kennt echten Projektkontext, KNP-Wiki und – lizenzabhängig – Normen/Fachliteratur.

Gemieteter Server

Agenten + Rechenleistung

Ein von KNP administrierter Linux-Server im Rechenzentrum: dort laufen Codex/Claude Code, Python, Geometrie, FEM, Wärmebrücken und Reporting auf pseudonymisierten Tickets.

Harte Grenze

Kein Weg ins KNP-LAN

Nur KNP-Komponenten bauen definierte ausgehende Verbindungen auf. Die Agentenzone erhält weder eine Route ins Firmennetz noch KNP-Credentials.

Grundbegriffe: vom Chat zum Agenten

Der wichtigste Sicherheitsunterschied ist nicht das verwendete KI-Modell, sondern welche technischen Rechte der laufende Prozess besitzt.

Normaler KI-Chat

Antwortet mit Text

Wie beim bekannten ChatGPT-Chat: Die KI schlägt z. B. ein Skript vor. Ein Mensch kopiert es, prüft es und startet es selbst. Der Chat hat dadurch nicht automatisch Zugriff auf KNP-Rechner oder Dateien.

Coding-Agent

Kann selbst handeln

Codex oder Claude Code läuft als Programm auf einem Linux-Rechner. Je nach Freigabe kann der Agent Dateien lesen und ändern, Shell-Befehle starten, Programme ausführen und Netzwerkdienste ansprechen. Sicherheitstechnisch ist er deshalb eher ein automatisierter Linux-Benutzer als ein reiner Chat.

MCP-Server

Stellt benannte Werkzeuge bereit

MCP kann dem Agenten enge Funktionen wie run_fem oder generate_report geben, statt freien SSH-Zugriff. Das begrenzt die Oberfläche – aber nur, wenn die Tools selbst eng sind und Betriebssystem sowie Netzwerk ebenfalls begrenzt bleiben.

Gemieteter Server

Kein fertiger Cloud-Dienst

Gemeint ist ein normaler gemieteter Linux-Server in einem Rechenzentrum, den KNP selbst administriert. KNP bestimmt Betriebssystem, Firewall, Container, Arbeitsverzeichnisse, Tools, Secrets und Regeln der Codex-/Claude-Code-Sessions.

Merksatz: „Der Agent darf das nicht“ ist nur eine Verhaltensregel. Stärker ist: Das Betriebssystem oder die Firewall kann die Verbindung technisch nicht herstellen, weil keine Route und keine passenden Rechte existieren.

1. Zwei typische Arbeitsabläufe

Die Grafik zeigt bewusst nicht nur Technik, sondern zwei konkrete Aufgaben aus dem Büroalltag.

KNP-BÜRO · VERTRAULICHE ZONE Echte Projekte, E-Mails, Access, Wiki, Normen, Vorlagen und produktive Schreibrechte. A · E-Mail automatisch sortieren Neue E-MailOriginalmail + AnhängeAbsender / Betreff / Projektbezug Lokales LLMerkennt Projekt + Dokumentartmacht Ablagevorschlag Mitarbeiter bestätigtProjekt 241 · Korrespondenz„Ablegen“ Deterministic Write Workerverschiebt Mail + Anhängeaktualisiert Access + Audit Projekt05_Korres-pondenz✓ verknüpft liest internVorschlagfreigegeben Interne Wissens- und Rechercheebene KNP-Wiki + DIN + FachliteraturKNP-Erfahrungen · Normfundstellen · Vorlagen Lokaler Research Agentsucht konkrete Belege und Fundstellen Evidence Packetz. B. DIN XXXX · Abschnitt 6.3.2 KNP CONNECTOR · HARTE GRENZE nur vom Büro initiiertes HTTPS :443 · nur definierte Pakete · keine freie Remote-Steuerung GEMIETETER SERVER · AGENTEN- UND RECHENZONE Von KNP administriertes Linux-System außerhalb der Vertrauenszone: nur pseudonymisierte Tickets und freigegebene Technikdaten. B · Wärmebrücke ermitteln Technisches Ticket„Balkonanschluss prüfen“Geometrie · Schichten · RandwerteTicket C-8172 Codex / Claudeplant Rechenwegwählt freigegebene Toolsggf. Research Request MCP RechentoolsGeometrie · FEM · ψ-WertTemperaturen · fRsi · Grafikennur KNP-validierte Version produktiv Result Packageψ-Wert · TemperaturfeldQualitätsstatus · ProvenienzReport + SVG/JSON KNPConnectorholt Ergebnis→ Projekt übernimmtrechnetErgebnis pseudonymisiertes Task Package ↓ Research Request ↑ pseudonymisierte belegte Antwort Result Package ↑

Lesart: Workflow A bleibt komplett im KNP-Büro. Workflow B überschreitet die Grenze nur mit pseudonymisierten Technikdaten. Normen- und Wiki-Recherche wird intern ausgeführt und als schlankes Evidence Packet zurückgegeben.

2. Systemaufteilung

Das Referenz-Zielbild trennt die vertrauliche KNP-Welt von einer untrusted Agenten-/Rechenzone. Der physische Standort eines Rechners ist dabei zweitrangig; entscheidend sind Netzwerkroute, Rechte und Daten.

KNP-Büro

Vertrauenswürdige Zone

Datenserver/Access/E-Mail, lokales LLM, interne Task-Zuordnung, KNP-Wiki, Normen/Fachliteratur, Human Gates, deterministische Write Worker, KNP Document Factory und der ausgehende Connector.

Gemieteter Server

Agentensteuerung + Rechenzone

Web-App, API/Auth, Datenbank, Job Queue, Object Storage, Agent-Orchestrator, Codex/Claude Code, MCP-Rechentools, Tool Registry, Sandboxes und Reporting. Diese Zone wird auch dann als untrusted behandelt, wenn KNP den Server vollständig selbst administriert.

Wichtig: „extern“ bedeutet hier nicht „beliebiger Cloud-Dienst“. Es ist ein von KNP kontrollierter Linux-Server auf gemieteter Infrastruktur. KNP legt Laufzeitumgebung, Werkzeuge, Container und Netzrechte fest. Das Sprachmodell kann je nach Agent trotzdem über eine externe Modell-API angesprochen werden; deshalb dürfen auch auf diesem Server nur pseudonymisierte Projektdaten landen.

3. Architekturvarianten

Es gibt mehrere sinnvolle Betriebsformen. Für die Sicherheit zählt vor allem, ob ein Agenten-/Rechenrechner eine technische Route in das KNP-LAN besitzt.

VarianteAufbauSicherheitswirkungEinordnung
A · Agent + Compute externCodex/Claude Code und Rechentools laufen auf dem gemieteten Server. KNP übergibt nur pseudonymisierte Pakete und holt Ergebnisse ab.Klare Trennung; selbst eine kompromittierte Agentenzone hat keine Route und keine Credentials ins KNP-LAN.Referenz-Zielbild
B · Agent extern, Compute-PC im Büro isoliertAgenten laufen auf dem gemieteten Server. Ein separater Rechen-PC steht physisch bei KNP, aber in einem eigenen Netz/VLAN ohne Route zum KNP-LAN. Ein kleiner Worker auf dem Rechen-PC holt über ausgehendes HTTPS freigegebene Rechenjobs und liefert Ergebnisse zurück. MCP kann lokal hinter diesem Worker liegen.Eigene CPU/GPU bleibt nutzbar, ohne dem Agenten einen direkten Weg ins Firmennetz zu geben. Der externe Agent spricht nicht direkt mit einer internen IP und öffnet keinen Remote-Shell-Zugang.Sichere Hybridoption
C · Agent + Compute direkt im KNP-LANCodex/Claude Code läuft auf einem normalen Büro-Rechner mit erreichbaren Fileservern, Druckern, Datenbanken oder anderen internen Diensten.Ein Fehler, eine bösartige Eingabe oder eine kompromittierte Abhängigkeit kann den Agenten-Rechner als Sprungbrett zu erreichbaren internen Systemen benutzen.Kein Produktions-Zielbild
Kernaussage: Ein Rechen-PC darf durchaus im Büro stehen. Er muss dafür nicht Teil der vertrauenswürdigen KNP-Zone sein. Physisch „lokal“ und netztechnisch „intern“ sind zwei verschiedene Eigenschaften.

4. Kommunikation über die Grenze

„Empfangen“ im Büro braucht keinen offenen Port: KNP-Komponenten bauen die Verbindung selbst nach außen auf und holen definierte Nachrichten oder Jobs ab.

Referenz A KNP Connector ───── ausgehend HTTPS :443 ─────► Broker-API auf gemietetem Server │ │ ├─ POST /tasks ├─ Job Queue ├─ GET /messages ├─ Research Requests ├─ POST /research-results ├─ Result Packages └─ GET /results └─ Status Hybrid B isolierter Rechen-PC/Worker ── ausgehend HTTPS :443 ──► Broker / Rechenjob-Queue │ └─ ruft lokal eng definierte Rechentools auf; optional lokales MCP Der externe Agent baut keine Verbindung zu einer KNP-IP auf. Kein eingehender Port im KNP-Netz ist für ihn erforderlich.
Baseline: Kein Site-to-Site-VPN und kein direkt aus dem Internet erreichbarer MCP-/SSH-Dienst auf dem Büro-Rechen-PC. Wenn lokale Rechenleistung genutzt wird, holt ein isolierter Worker die Jobs selbst ab. So bleibt die Netzwerkgrenze auch bei einer kompromittierten Agentensession bestehen.

5. MCP als Tool-Schicht

MCP ist eine standardisierte Art, einem Agenten benannte Werkzeuge bereitzustellen. Es ist nützlich für Rechtebegrenzung, ersetzt aber keine Netzwerk- oder Betriebssystem-Isolation.

ZoneBeispiel-ToolsZweck
KNP internsearch_knp_wiki, search_norms, classify_email, prepare_documentLokales LLM arbeitet mit vertraulichen Quellen und festen internen Diensten.
Externe Agentenzonecalculate_u_value, run_fem, thermal_bridge, generate_plot, generate_reportAgenten verwenden versionierte, eng definierte Rechentools statt freien Zugriff auf Fachlogik und Infrastruktur.
Isolierter Rechen-PCoptional lokales MCP hinter dem Rechen-WorkerDer Worker kann intern ein MCP-Tool aufrufen. Der MCP-Port selbst muss dafür nicht vom gemieteten Server oder aus dem Internet erreichbar sein.
KNP-Grenzekein direktes MCPNur Task Packages, Research Requests, Evidence Packets, Result Packages und Status über die Broker-/Connector-Schnittstelle.
MCP ist keine Firewall: Ein MCP-Tool run_command(command) wäre praktisch wieder eine freie Shell. Ein Tool run_thermal_bridge(case_id) mit validiertem Eingabeschema ist wesentlich enger. Zusätzlich bleiben Netzwerkregeln, OS-Rechte, Container und Dateifreigaben notwendig.
Direktes Remote-MCP zum Büro-Rechen-PC: technisch möglich, wenn der Rechen-PC weiterhin vollständig vom KNP-LAN isoliert ist. Dann entsteht aber bewusst ein eingehender Steuerkanal zur Rechenzone und damit zusätzliche Angriffsfläche. Dafür wären mindestens starke gegenseitige Authentisierung, eng definierte Tools, ein eigener Dienstbenutzer und keine generische Shell nötig. Die einfachere Baseline bleibt deshalb der ausgehend pollende Rechen-Worker; MCP kann dahinter lokal laufen.

6. Research Proxy: DIN + KNP-Wiki

Öffentliche Agenten können Fachfragen stellen, ohne Zugriff auf geschützte Quellen oder Unternehmensdaten zu erhalten.

Externer Agent„Welche Randbedingungen gelten hier?“
→
Research RequestTicket + technische Frage
→
Lokaler Research Agentsucht Wiki, Normen, Literatur
→
Evidence PacketDIN-Ausgabe, Abschnitt/Seite, KNP-Wiki-Revision, Zusammenfassung
→
Externer Agentbelegt weiterarbeiten
Normenrechte: Volltexte verbleiben geschützt. Ob lokale KI-Verarbeitung/Indexierung zulässig ist, wird pro Quelle über Rechte-/Lizenzmetadaten entschieden.

7. Schriftstücke und Präsentationen

Inhalt kann extern vorbereitet werden; echte Projektidentität und KNP-Layout werden intern ergänzt.

Externe Agentenzone

Inhalt vorbereiten

Technischer Bericht, Tabellen, Diagramme, Gliederung oder Präsentationsentwurf aus pseudonymisierten Ergebnissen.

KNP intern

Document Factory

KNP-Briefkopf, DOCX/PDF/PPTX-Master, Projektnummer, Auftraggeber, interne Vorlagen und freigegebene Textbausteine.

Human Gate

Prüfen + ablegen

Fachliche Freigabe, ggf. Versand und deterministische Ablage im richtigen Projekt.

8. Rechenkern – vorhandener Stand

Der bestehende PoC liefert bereits wesentliche Vorstufen; vollständige produktive Fach-Calculation-Engines bleiben ein eigener Entwicklungsstrang.

vorhanden

Dokument + Geometrie

PDF-Inventar, Vektor-/Raster-Pfade, Räume/Flächen, thermische Hülle, Öffnungen, Cross-View-/Geschoss-/Scope-Logik, Evidence und Review.

vorhanden

Bauteile + U-Werte

Schichtenkatalog, Materialdaten, Zuweisungen, Öffnungsabzug, U-Wert nur bei vollständigen Eingaben, JSON/CSV/HTML-Ausgaben.

weiterzuentwickeln

Fachrechenkerne

Validierte Wärmebrücken-/FEM-, GEG-/18599-, Schall- und weitere Engines mit Referenzfällen, Toleranzen und reproduzierbaren Runs.

9. Sicherheitsmodell – anschaulich

Die Agentenzone wird so behandelt, als könnte eine Session, ein Modell-Input oder eine Software-Abhängigkeit irgendwann kompromittiert werden. Die Architektur soll dann trotzdem verhindern, dass daraus Zugriff auf KNP-Projektdaten entsteht.

Warum der Agent im normalen LAN riskant wäre

Shell + Netzwerk = möglicher Seitwärtsweg

Ein Coding-Agent kann – soweit sein Linux-Benutzer es darf – Programme starten und Netzwerkverbindungen herstellen. Befindet sich dieser Rechner im normalen Firmennetz, sind interne Dienste technisch erreichbar. Ein Fehler oder kompromittierter Agent könnte dann versuchen, erreichbare Systeme oder gespeicherte Zugangsdaten zu missbrauchen. Dass der Prompt so etwas verbietet, ist keine harte Sicherheitsgrenze.

Was die Architektur dagegen setzt

Die Verbindung existiert technisch nicht

Agenten- und Rechenzonen erhalten keine Route zum KNP-LAN, keine KNP-Credentials und keine gemounteten Projektlaufwerke. KNP startet nur eng definierte ausgehende Verbindungen. Selbst ein vollständig übernommener Agenten-Workspace sieht dadurch nur die pseudonymisierten Daten seines Auftrags.

RegelUmsetzung
Keine Route nach KNPKein Site-to-Site-VPN, kein SMB/SSH/DB-Zugang, kein interner DNS und keine KNP-Credentials in der Agentenzone. Ein lokaler Rechen-PC der Hybridvariante steht in einem getrennten Netz ohne Route zum KNP-LAN.
Nur definierte AustauschobjekteSchema-validierte Task-, Research-, Evidence-, Result- und Status-Pakete; technische Ticket-ID statt Kundenname/Projektnummer.
Rückgaben sind untrustedKeine Shell-/SQL-/Access-Anweisungen aus externen Paketen ausführen; Dateien, HTML und Freitext werden validiert bzw. sanitisiert, bevor interne Systeme sie übernehmen.
Produktives SchreibenNur feste interne Worker nach Human Gate; keine freien Agentenrechte auf Access, Mail, Projektordner oder Dokumentenablage.
Agent-IsolationPro Ticket separater Workspace/Container; nur explizit freigegebene Dateien, Netzwerkziele und Tools.
Rechen-PC-HybridDer Rechen-Worker baut selbst ausgehendes HTTPS auf. Kein direkter eingehender Agentenzugriff, kein offener Remote-MCP-Port als Brücke ins Büro.
SecretsAgenten erhalten nur die für ihre Zone benötigten Tokens. Interne KNP-Zugangsdaten werden weder in Prompts noch in Workspaces oder Umgebungsvariablen der externen Agenten gespeichert.
Prüffrage für jede neue Funktion: „Wenn diese Agentensession vollständig kompromittiert wäre – welche Systeme und Daten könnte sie dann technisch erreichen?“ Die Antwort soll auf pseudonymisierte Auftragsdaten und explizit freigegebene Rechentools begrenzt bleiben.

10. MVP

Der erste Vertical Slice testet bereits fast alle Architekturgrenzen, ohne direkt das gesamte Bauphysiksystem fertigstellen zu müssen.

1 · Task internz. B. U-Wert oder einfacher Wärmebrückenfall
→
2 · PseudonymisierenTicket + Technikdaten
→
3 · Externer AgentTool wählen + ggf. Research
→
4 · Validiertes Tooldeterministisch rechnen
→
5 · Result PackageReport + Grafik + Provenienz
→
6 · KNPechtes Projekt zuordnen
Parallel kleiner interner Nutzen: E-Mail-Klassifikation und Ablagevorschläge können früh produktiv getestet werden. Der tatsächliche Schreibvorgang bleibt zunächst Human-Gated.

11. Roadmap

Erst die sichere Verbindung und ein kleiner vollständiger End-to-End-Fall, dann schrittweise mehr Automatisierung.

PhaseKNP internExterne Agenten-/RechenzoneErgebnis
0 · BestandServer, Access, Mail, Ordner, Wiki, Vorlagen, Normrechte erfassen—klare Integrationspunkte
1 · Security FoundationConnector, interne Task-ID↔Ticket-Map, lokale Web-/LLM-DiensteNext.js, API, Auth, DB, Queue, Storage, Agent-Sandboxsicherer Pakettransport
2 · MVP BauphysikTask anlegen, Research beantworten, Ergebnis importierenAgent + erstes KNP-validiertes Tool + Reporterster E2E-Nachweis
3 · OfficeDocument Factory, KNP-Layouts, Human GateInhalts-/DiagrammerzeugungSchriftstücke/PPT
4 · E-Mail/AccessWrite Worker + Audit/Backup + Freigabe-UInicht erforderlichkontrollierte Ablage
5 · Fachkernefachliche Validierung/FreigabeFEM/Wärmebrücke/weitere Engines + Benchmarkingzunehmend produktive Automation