Kbox ETS MCP ist eine ETS-App, mit der ein KI-Agent das KNX-Projekt liest und bearbeitet, das Sie in ETS6 gerade geöffnet haben. Die App läuft innerhalb von ETS, der Agent sieht also das Projekt im aktuellen Zustand — dieselbe Topologie, dieselben Geräte, Gruppenadressen und Parameter, die Sie auf dem Bildschirm sehen.
Diese Anleitung führt Sie von der Installation bis zur ersten Frage an Claude.
Bevor Sie anfangen
- ETS 6 installiert, mit einem geöffneten Projekt. Ohne offenes Projekt hat der Server kein Thema.
- Ein Kbox-Konto für die entfernte Verbindung. Sie melden sich einmal damit an.
- Ein MCP-fähiger Agent — Claude im Web, Claude Desktop, Codex oder Gemini CLI. Jeder davon funktioniert; unterschiedlich ist nur, wo Sie die Adresse einfügen.
1. ETS-App installieren
Installieren Sie die .etsapp-Datei wie jede andere ETS-App. ETS muss nicht neu gestartet
werden — die App steht unmittelbar nach der Installation bereit.
2. Panel öffnen
Die App öffnet sich nicht von selbst und legt keinen eigenen Reiter an. Öffnen Sie sie über die Symbolleiste: Panels → All Panels → Kbox → Kbox ETS MCP.

Alles in dieser Anleitung spielt sich in diesem Panel ab. Ein Klick auf den Stern neben Kbox ETS MCP heftet es an, dann liegt es beim nächsten Mal einen Klick entfernt.

Lesen Sie den Hinweis, bevor Sie verbinden
Das Panel öffnet mit einem bewusst gesetzten Warnhinweis, und der verdient einen Moment:
Dieser Server kann einem verbundenen KI-Agenten die vollständige Topologie dieses Gebäudes, das komplette Geräteinventar und den Firmware-Zustand jedes Geräts am Bus übergeben. Diese Daten verlassen in der Regel Ihren Rechner und werden von einem in der Cloud betriebenen Sprachmodell verarbeitet. Bereits der lesende Zugriff legt all das offen; die Stufen für Schreiben und Busbetrieb erlauben dem Agenten zusätzlich, das Projekt oder die laufende Anlage zu verändern.
Anders gesagt: Auch die sicherste Stufe sendet den Inhalt Ihres Projekts an ein Sprachmodell. Entscheiden Sie mit diesem Wissen.
3. Festlegen, was Claude darf
Drei Berechtigungsstufen, jede umfasst auch alles, was die vorherige erlaubt:
- Read only — nur lesen: Projekt, Produktkatalog und KNX-Stammdaten. Es wird nichts verändert.
- Can edit the project — das geöffnete Projekt bearbeiten. Jede Änderung wird in einen ETS-Rückgängig-Eintrag eingeschlossen und lässt sich daher aus ETS zurücknehmen.
- Can talk to devices — mit echter Hardware über den Bus kommunizieren: Lesen, Schreiben, Downloads und Firmware-Updates. Nicht umkehrbar, und jeder Vorgang wird einzeln bestätigt.
Zwei Schutzmechanismen sind fest eingebaut und lassen sich nicht abschalten:
- Ein Agent kann seine eigene Stufe nicht anheben. Schreibenden oder busseitigen Zugriff gibt nur die Person frei, die vor ETS sitzt.
- Erhöhte Berechtigungen fallen bei jedem Start von ETS auf „nur lesen“ zurück. Die Freigabe gilt ausschließlich für die laufende Sitzung.
Werkzeuggruppen
Unter Which tools are on? schalten Sie ganze Gruppen ab — Topology, Group addresses, Communication objects, Parameters, Buildings, Catalog, Undo history, Bus, Device management, Network management, Commissioning, Jobs, Export, Navigation. Eine abgeschaltete Gruppe wird dem Agenten gar nicht erst angeboten.
4. Verbinden
Es gibt zwei Wege. Wählen Sie einen.
Variante A — Von einem anderen Rechner aus (Voreinstellung)
Mit dieser Auswahl startet das Panel. Nehmen Sie sie für Claude im Web oder immer dann, wenn der Agent nicht auf dem ETS-Rechner läuft. Es sind zwei Schritte: Zuerst geben Sie diesen Rechner frei, dann machen Sie Claude mit dem Projekt bekannt. Solange Sie diese Schaltflächen nicht selbst drücken, wird keine Verbindung aufgebaut.

Schritt 1 — Diesen Rechner freigeben
Das Panel zeigt eine Adresse, die Ihren Code bereits enthält, zum Beispiel
https://id.kboxsolutions.com/device?user_code=XXXX-XXXX.
- Copy drücken.
- Die Adresse in einem Browser öffnen — auf diesem Rechner oder auf dem Telefon.
- Prüfen, ob die Seite denselben Code zeigt wie das Panel.
- Mit dem Kbox-Konto anmelden und bestätigen.
Das Panel wartet währenddessen und geht nach Ihrer Bestätigung von selbst weiter. Wenn Sie es sich anders überlegen, drücken Sie Cancel. Revoke this computer's access nimmt die Freigabe später wieder zurück.
Schritt 2 — Claude mit diesem Projekt bekannt machen
Kopieren Sie die Adresse unter Server aus dem Panel —
https://mcp.etsmcp.kboxsolutions.com/mcp — und richten Sie sie in Claude ein.
Öffnen Sie Claude und gehen Sie auf Customize → Connectors:

Drücken Sie + Add, geben Sie einen Namen ein und fügen Sie die Serveradresse ein:

Claude erkennt das Anmeldeverfahren selbst. Die als Detected angezeigten Voreinstellungen sind die richtigen — Sign in now und Use Claude's published identity. Das Feld Request headers bleibt leer; dieser Server braucht keinen.

Drücken Sie Add. Der Connector erscheint in der Liste, ist aber noch nicht verbunden — drücken Sie Connect:

Sie landen auf der Kbox-Anmeldeseite, um Claude die Berechtigung zu erteilen:

Das Kontofeld ist in dieser Anleitung geschwärzt; bei Ihnen stehen dort Ihre Benutzerkennung und Ihre E-Mail-Adresse. Die Seite listet genau auf, was Sie erteilen:
- ETS-Projekt lesen — Topologie, Geräte, Gruppenadressen, Parameter und den Produktkatalog.
- ETS-Projekt ändern — Gruppenadressen, Parameter, Geräte und Topologie anlegen und bearbeiten. Jede Änderung ist in ETS ein einzelner, rückgängig machbarer Eintrag.
Drücken Sie Authorize; Sie kommen verbunden zu Claude zurück.
Diese Berechtigung ist eine Obergrenze, kein Schalter. Wer hier Projektänderungen erteilt, schaltet sie damit nicht ein. Der Agent darf nur, was sowohl diese Berechtigung als auch die im ETS-Panel freigegebene Stufe erlauben — und die ETS-Seite fällt bei jedem Neustart von ETS auf „nur lesen“ zurück.
Variante B — Auf diesem Rechner
Nur für einen Agenten, der auf dem ETS-Rechner selbst läuft. Es gibt weder eine Kopplung noch ein Kbox-Konto: Der Agent spricht über das Loopback-Netzwerk des Rechners mit dem Server.

- On this computer auswählen.
- Den Endpoint mit der Schaltfläche daneben kopieren.
- Das Access token genauso kopieren. Show zeigt es an, wenn Sie es lesen möchten — zum Kopieren müssen Sie es nicht anzeigen.
- Im Agenten als MCP-Server über HTTP mit diesem Endpoint eintragen und das Token als Bearer-Token senden. In Claude Desktop heißt das Custom Connector, Codex und Gemini CLI nehmen beides auf der Kommandozeile entgegen.
Zwei Dinge sind wichtig:
- Verwenden Sie die Adresse genau so, wie das Panel sie anzeigt — sie beginnt mit
http://127.0.0.1. Stattdessenlocalhostzu schreiben funktioniert nicht: Der Server prüft die Adresse, die Ihr Agent sendet. - Sie tun das nur einmal. Endpoint und Token bleiben beim Neustart von ETS gleich. Sie ändern sich, wenn Sie Regenerate drücken — so trennen Sie alle Agenten auf einmal.
Sie kommen von einer älteren Version? Frühere Versionen hatten eine Schaltfläche Connect Claude Desktop, die die Konfiguration von Claude Desktop für Sie geschrieben hat. Diese Schaltfläche gibt es nicht mehr, und der Eintrag, den sie geschrieben hat, zeigt ins Leere — entfernen Sie ihn und richten Sie wie oben einen Custom Connector ein.
5. Werkzeugrechte in Claude setzen
Claude teilt die Werkzeuge des Servers in lesende und schreibende/löschende ein und lässt Sie bestimmen, wann jedes davon laufen darf: Always allow, Needs approval oder Blocked.


Ein sinnvoller Anfang: Die lesenden Werkzeuge auf Always allow stehen lassen und die Gruppe Schreiben/Löschen auf Needs approval setzen, bis Sie wissen, wie der Agent mit Ihrem Projekt umgeht. Einzelne Werkzeuge innerhalb einer Gruppe können Sie abweichend einstellen.
Das ist eine zweite, unabhängige Bremse. Sie ersetzt die ETS-Stufe nicht — sie verengt, was eine Stufe bereits erlaubt.
6. Stellen Sie eine Frage
Öffnen Sie eine Unterhaltung und fragen Sie nach dem Projekt. Zum Beispiel:
- „Wie viele Geräte enthält dieses Projekt, und auf welchen Linien liegen sie?“
- „Liste alle Gruppenadressen unter 1/2 auf und sag mir, welche Geräte jeweils damit verbunden sind.“
- „Welche Kommunikationsobjekte des Thermostats im Wohnzimmer sind nicht verbunden?“
- „Lege die Gruppenadressen 0/3/1 bis 0/3/8 mit den Namen Küchenlicht 1 … 8 an.“
Die Änderungen landen in ETS, während Sie zusehen. Jede ist ein einzelner Eintrag in der Rückgängig-Liste von ETS, Strg+Z in ETS nimmt sie also zurück.
Alles, was echte Hardware berührt — Lesen oder Schreiben am Bus, ein Download, ein Firmware-Update —, öffnet in ETS einen Bestätigungsdialog und wartet auf die Antwort eines Menschen. Der Agent kann nicht an Ihrer Stelle bestätigen.
7. Andere Agenten (Codex, Gemini CLI)
Es ist nichts zusätzlich einzurichten. Jeder Agent auf dem ETS-Rechner verwendet denselben Endpoint und dasselbe Access token wie in Variante B oben; Codex und Gemini CLI nehmen beides auf der Kommandozeile entgegen.
Advanced zeigt beides noch einmal, neben dem, was Sie nur gelegentlich brauchen:

- Endpoint — die lokale Adresse, auf der der Server lauscht, normalerweise
http://127.0.0.1:48610/mcp. Belegt bereits etwas anderes auf dem Rechner diesen Port, nimmt der Server einen anderen und zeigt ihn hier an. - Access token — derselbe Wert wie in Variante B. Regenerate erzeugt sofort ein neues, und jeder eingerichtete Agent funktioniert erst wieder, wenn Sie das neue dort eingefügt haben. Genau dafür ist es da: So trennen Sie alle auf einmal.
- Export directory — das Verzeichnis, in das exportierte Dateien geschrieben werden.
Turn access off stoppt den Server, ohne ETS zu schließen.
Gut zu wissen
- In ETS muss ein Projekt geöffnet sein. Ohne offenes Projekt verweigern die Werkzeuge die Arbeit und sagen das auch.
- Die Berechtigungsstufe fällt bei jedem Neustart von ETS auf „nur lesen“ zurück — so gewollt, kein Fehler.
- Projektänderungen lassen sich aus ETS zurücknehmen. Busvorgänge nicht; genau deshalb wird jeder einzeln bestätigt.
- Der Agent sieht weder Ihr ETS- noch Ihr Kbox-Passwort. Die Anmeldung läuft in Ihrem Browser, und am Server kommt ausschließlich ein Token an.
Fehlerbehebung
- Der Agent meldet, es sei kein Projekt geöffnet — in ETS ein Projekt öffnen, dann erneut versuchen.
- Der Agent meldet fehlende Berechtigung — im ETS-Panel eine höhere Stufe freigeben. Denken Sie daran, dass sie beim Neustart von ETS zurückfällt. Prüfen Sie außerdem, ob das Werkzeug in den Connector-Einstellungen von Claude auf Blocked steht.
- Ein Agent auf diesem Rechner verbindet sich nicht mehr — ein Neustart von ETS ändert weder den Endpoint noch das Token. Prüfen Sie, ob jemand Regenerate gedrückt hat und ob das Panel noch den Port anzeigt, mit dem Ihr Agent eingerichtet ist.
- Der Kopplungscode ist abgelaufen — Cancel drücken und Schritt 1 mit einem frischen Code neu beginnen.
- Eine Werkzeuggruppe fehlt — sie ist im Panel unter Which tools are on? abgeschaltet.