Einschalten

Der Hauptschalter, der Port, auf dem der Endpunkt lauscht, und die vier Dinge, die ihn lokal halten.

Als Markdown ansehen

Eine frische Installation bietet Agenten nichts an. Der Agentenzugriff ist einen Schalter entfernt, und dieser Schalter ist das erste der drei Tore, die hier an die Stelle einer Anmeldung treten: der Hauptschalter, die Schalter je Bereich und das Journal.

Der Schalter und der Port

Der Hauptschalter ist ab Werk aus. Schalten Sie ihn auf der Seite Agentenzugriff ein (die Seite zu öffnen setzt die Berechtigung zur Agentenverwaltung Ihrer lokalen Rolle voraus); der Endpunkt lauscht danach unter http://127.0.0.1:<port>/mcp über Streamable HTTP. Agenten können sich auch verbinden, während die Anwendung ausgeblendet im Infobereich läuft.

Einstellung Wirkung Werte Standard
Agentenzugriff aktivieren (MCP) Startet oder stoppt den Endpunkt. Aus bedeutet: kein Endpunkt, nichts angeboten. ein / aus aus
Port Lokaler Port, auf dem der Endpunkt lauscht. Eine Änderung startet den Agentenzugriff neu, und jedes Verbindungsbeispiel auf der Seite wird angepasst. 1024–65535. Ein Port, auf den der Agentenzugriff nicht umziehen kann, wird abgelehnt, bevor etwas gespeichert wird: Der Grund steht unter dem Feld, das Feld kehrt zum geltenden Port zurück, und nichts wird neu gestartet. Sechs Einträge werden abgelehnt: ein Wert außerhalb des Bereichs ("Geben Sie eine Zahl zwischen 1024 und 65535 ein."); der Port des Webservers, eingestellt unter Fernzugriff ("Port N ist bereits der Webserver. Wählen Sie einen anderen Port, oder verschieben Sie zuerst den Webserver."); der Port des OPC UA-Servers unter Konfiguration, ob er läuft oder gestoppt ist ("Port N ist bereits der OPC UA-Server. Wählen Sie einen anderen Port, oder verschieben Sie zuerst den Server."); der Port des Modbus-Servers auf der Seite Connector, ob er ein- oder ausgeschaltet ist ("Port N ist bereits der Modbus-Server. Wählen Sie einen anderen Port, oder verschieben Sie zuerst den Modbus-Server."); der Port des MQTT-Brokers auf der Seite Connector, ob er ein- oder ausgeschaltet ist ("Port N ist bereits der MQTT-Broker. Wählen Sie einen anderen Port, oder verschieben Sie zuerst den MQTT-Broker."); und ein Port, den etwas anderes auf diesem Rechner bereits hält ("Port N ist auf diesem Rechner belegt. Schließen Sie, was ihn hält, oder wählen Sie einen anderen Port."). 18181

Neben dem Schalter zeigt eine Zustandsplakette Versiegelt, solange der Schalter aus ist, und Offen, solange er ein ist, sodass der Zustand des Endpunkts auf einen Blick an der Plakette ablesbar ist.

Unter dem Endpunkt fasst eine Zählung ohne eigene Überschrift die Schalter unter Freigegebene Bereiche weiter unten auf der Seite zusammen. Ihre erste Zeile gibt für jede der vier Stufen an, wie viele ihrer Bereiche eingeschaltet sind, jeweils hinter einem Punkt, der in der Farbe der Stufe leuchtet, solange mindestens einer davon ein ist, und grau bleibt, solange keiner ein ist: Sind alle Bereiche ein, steht dort 5 Lesen, 6 Konfigurieren, 4 Bedienen und 1 Wiederherstellen. Die Zeile darunter zählt sie zusammen, "16 von 16 Gruppen von Fähigkeiten offen", und solange ein Bereich der Stufe Bedienen oder Wiederherstellen ein ist, sagt sie dahinter, wie viele der offenen Gruppen auf die reale Anlage schreiben dürfen: "5 mit Schreibzugriff im Betrieb". Sie zählt die Schalter der Bereiche und sonst nichts, sodass auf einen Blick lesbar ist, wie weit die Station geöffnet ist. Solange der Hauptschalter aus ist, wird die Zählung zusammen mit dem Endpunkt und dem Port ausgegraut, liest die Schalter aber weiter, die ihren gespeicherten Stand behalten: Sie zeigt, was der Agentenzugriff öffnet, sobald der Schalter wieder ein ist.

Solange der Schalter aus ist, stehen URL kopieren und Port unter dem Endpunkt ausgegraut, und der Mauszeiger auf einem der beiden nennt den Grund: "Der Agentenzugriff ist ausgeschaltet. Schalten Sie ihn zuerst unter Zugriff ein." Die Karte Freigegebene Bereiche sagt denselben Satz über ihren ausgegrauten Schaltern.

Alles auf der Seite wird automatisch gespeichert; es gibt keine Schaltfläche zum Speichern.

Wie der Endpunkt geschützt ist

  • Nur Loopback. Der Socket bindet an 127.0.0.1, nie an eine Netzwerkschnittstelle. Das Anlagennetz erreicht ihn nicht.
  • Anfragen aus dem Browser werden abgewiesen. Die Bindung allein würde eine bösartige Webseite nicht daran hindern, ihre eigene Domäne auf 127.0.0.1 umzubiegen, deshalb prüft der Endpunkt zusätzlich die beiden Kopfzeilen, die ein Browser nicht fälschen kann: Eine Anfrage, deren Host nicht lokal ist oder die einen fremden Origin trägt, wird mit 403 abgewiesen, bevor sie überhaupt eine Sitzung öffnen kann. Jede Abweisung wird im Bereich Agent in Ereignisse protokolliert, sodass eine aus einem Browser-Tab abgetastete Station eine Spur hinterlässt.
  • Keine Anmeldung am Endpunkt, und das mit Absicht. Die Tore sind der Hauptschalter, die Schalter je Bereich und das Journal. Wenn Sie den Endpunkt jemals über einen Tunnel veröffentlichen, muss die Anmeldung im Tunnel liegen (siehe ChatGPT und andere über die Cloud geführte Clients).
  • Die Werkzeugliste ist die Liste der freigegebenen Bereiche. Die Werkzeuge eines gesperrten Bereichs werden gar nicht erst angeboten: Sie fehlen, statt mit Nein zu antworten. Jede Änderung an einem Schalter startet den Endpunkt neu, damit das, was ein Agent sieht, immer dem entspricht, was Sie erlaubt haben. Die beiden Hilfewerkzeuge sind die einzige Ausnahme: Sie lesen die Dokumentation der Anwendung und nichts von der Station, deshalb kommen sie mit dem Endpunkt, was auch immer die Schalter sagen (Hilfe).