MCP — Echtzeit-Daten-Gateway
Überblick
PlantPulse Integriertes MCP ist ein MCP-Daten-Gateway (Model Context Protocol), das der KI Zugriff auf sämtliche Echtzeitdaten der PlantPulse IIoT-Plattform ermöglicht.
Über schreibgeschützte Datenwerkzeuge stellt es der KI alle Daten des Werksbetriebs bereit: Werkshierarchie, Sensordaten, Alarme, OEE, Arbeitsaufträge, Energie, Systemstatus und mehr. Auch die Ontologie-Werkzeuge (Wissensgraph) sind in diesem integrierten MCP enthalten.
MCP (Model Context Protocol) ist ein von Anthropic vorgeschlagenes Standardprotokoll für die Anbindung zwischen KI-Modellen und Datenquellen.
Umstellung 2026-07: Das integrierte MCP wird jetzt als Endpunkt /api/v5/mcp (api_key-Authentifizierung) der server-web-Komponente der PlantPulse Platform bereitgestellt. Die früheren eigenständigen Dienste plantpulse-mcp-server (:50000) und plantpulse-ontology (:8888) wurden archiviert; die Ontologie-Werkzeuge sind im integrierten MCP aufgegangen. Der eingebettete Agent von AI Chat Web (ToolRegistry) entdeckt die Werkzeuge dynamisch über tools/list.
Verfügbare Daten
Werksstruktur
Abfrage der gesamten Hierarchie Standort → Bereich → Linie → Anlage → Tag. Wird nur die Hierarchie benötigt, dient der Asset-Baum; werden Strukturübersicht und Tag-Anzahl benötigt, die Ontologie; für die Fortpflanzung von Auswirkungen der Beziehungsgraph.
Bei Abfragen über Namen findet search_domains zuerst die ID — gesucht wird über Teilübereinstimmung von Name, ID oder Beschreibung in 14 Domänen wie Standort, Anlage, Tag, Auftrag und Benutzer.
Echtzeitwerte und Historie
- Sammelabfrage aktueller Tag-Werte (max. 100 auf einmal)
- Tag-Historie über einen Zeitraum
- Snapshot aller Tags einer Anlage — der aktuelle Zustand wird je Anlage abgerufen, ohne jeden Tag einzeln anzugeben
Alarme
- Abfrage der Alarmliste (Filter nach Zeitraum und Schweregrad)
- Diagnosepaket zur Alarmursache — zu einem Alarm werden zugehörige Tags und Zustandsänderungen gebündelt geliefert
- Quittierung von Alarmen
Produktionskennzahlen (OEE / RAM / EMS)
Abfrage erfolgt anlagenbezogen.
| Bedarf | Werkzeug |
|---|---|
| Eine Zeile je Auftrag (welcher Auftrag war auffällig) | get_asset_kpi |
| Der gesamte Zeitraum in einer Zeile (wie lief diese Woche) | get_asset_stats |
| Details zu einem einzelnen Auftrag | get_order_metrics |
Verhältniswerte wie OEE liegen nicht als Prozentwert, sondern im Bereich 0~1 vor. Ein Wert, der in der Oberfläche als 85 % erscheint,
lautet in der Werkzeugantwort 0.85.
Erfassungsstatus
Abfrage von Status und Health-Historie der Edge-Gateways sowie der Liste der OPC-Erfassungsverbindungen. Fragen wie „Es kommen keine Daten an" lassen sich meist hier beantworten.
Anlagendokumente
Abfrage der Liste der an eine Anlage angehängten Dokumente. Die Suche nach dem Inhalt von Dokumenten übernimmt nicht MCP, sondern RAG.
Bereitgestellte Werkzeuge (22)
Dies ist die vollständige Liste der vom integrierten MCP bereitgestellten Werkzeuge. Wird ein Werkzeug hinzugefügt oder entfernt, schlagen die Contract-Tests der Plattform fehl — diese Liste entspricht also exakt dem tatsächlichen Bestand.
Zeit
| Werkzeug | Rückgabe |
|---|---|
get_current_time | Aktuelle Serverzeit — Bezugspunkt zur Auflösung relativer Zeitangaben („gestern", „letzte Woche") |
Struktur — was befindet sich wo
| Werkzeug | Rückgabe |
|---|---|
search_domains | Entitätssuche (Name → ID-Auflösung) |
get_asset_tree | Asset-Hierarchiebaum |
get_ontology | Ontologie-Übersicht des Standorts (Struktur + Tag-Anzahl je Anlage) |
query_ontology | Navigation im Asset-Beziehungsgraph (Fortpflanzung von Auswirkungen) |
query_sparql | SPARQL-Abfrage der Ontologie |
get_asset_documents | Liste der an eine Anlage angehängten Dokumente |
search_domainsDie meisten Werkzeuge erwarten eine ID. Da Benutzer Namen wie „Abfüller Linie 3 Daejeon" verwenden,
löst die KI die ID zunächst über search_domains auf und ruft dann das eigentliche Werkzeug auf. Lautet die Antwort
„Anlage nicht gefunden", weicht der Name meist vom in der Plattform registrierten Namen ab.
Verbindung — läuft die Erfassung
| Werkzeug | Rückgabe |
|---|---|
get_edge_status | Status des Edge-Gateways |
get_edge_health_history | Edge-Health-Historie (Abschnitte je Tag) |
list_connections | Liste der OPC-Erfassungsverbindungen |
Daten — Tags
| Werkzeug | Rückgabe |
|---|---|
get_tag_values | Aktueller Tag-Wert |
get_tag_history | Tag-Historie über einen Zeitraum |
Daten — Alarme
| Werkzeug | Rückgabe |
|---|---|
list_alarms | Alarmliste |
get_alarm_context | Diagnosepaket zur Alarmursache |
ack_alarm | Alarmquittierung |
Daten — Anlagen
| Werkzeug | Rückgabe |
|---|---|
get_asset_snapshot | Snapshot aller Tags einer Anlage |
get_asset_timeline | Ereignis-Zeitleiste der Anlage |
get_asset_stats | Betriebswirtschaftliche Statistik der Anlage über einen Zeitraum |
Produktion
| Werkzeug | Rückgabe |
|---|---|
list_orders | Liste der Arbeitsaufträge |
get_order_metrics | Arbeitsauftragsdetails und KPIs |
get_asset_kpi | KPIs je Anlage und Auftrag (OEE / EMS / RAM) |
Rollup
| Werkzeug | Rückgabe |
|---|---|
get_health | Health-Rollup der Asset-Hierarchie |
Von den 22 Werkzeugen verändert nur ack_alarm den Plattformzustand — es quittiert Alarme.
Die übrigen 21 sind ausnahmslos schreibgeschützt. Es gibt kein Werkzeug, das Anlagen steuert oder Einstellungen ändert.
Wesentliche Einstellungen
Da das integrierte MCP über server-web der Plattform bereitgestellt wird, verwaltet AI Chat Web (copliot-web) lediglich die clientseitigen Verbindungseinstellungen.
| Eintrag | Beschreibung | Standardwert |
|---|---|---|
mcp.api.url | Basis-URL des integrierten MCP (Platform server-web) | (bei Installation festgelegt) |
mcp.api.token | api_key-Authentifizierungstoken | (bei Installation festgelegt) |
mcp.tools.enabled | Verwendung der integrierten MCP-Werkzeuge | true |
Der Endpunkt lautet <mcp.api.url>/api/v5/mcp; die Kommunikation erfolgt per JSON-RPC 2.0 (tools/list · tools/call). Serverseitige Richtlinien wie Paginierung oder Abfragezeitraum für Alarme richten sich nach der Konfiguration von Platform server-web.
Merkmale
Vollständige Datenabdeckung
Alle für den Werksbetrieb erforderlichen Datendomänen werden über ein einziges MCP bereitgestellt. Abfragen sind auf allen Ebenen möglich — von Sensor-Rohdaten bis zur KPI-Aggregation.
Eng begrenzter Schreibumfang
Alle Datenabfragewerkzeuge sind schreibgeschützt; den Zustand verändert einzig die Alarmquittierung (ack_alarm). Da es überhaupt keine Möglichkeit zur Anlagensteuerung oder Konfigurationsänderung gibt, ist die Anbindung ohne Risiko eines KI-Eingriffs in den Prozess möglich.
MCP-Standardprotokoll
Der Anthropic-MCP-Standard wird eingehalten. Unterstützt werden HTTP-POST-Kommunikation auf Basis von JSON-RPC 2.0 sowie Eingabevalidierung nach JSON Schema.
KST-nativ
Sämtliche Zeitverarbeitung erfolgt auf Basis von KST (koreanische Standardzeit). Felder mit dem Suffix _iso liefern ein für Menschen gut lesbares Zeitformat.