Digital Thread

Der Digital Thread ist ein Dienst, der alles, was im Werk geschieht, chronologisch und entlang seiner Zusammenhänge aufreiht. Er verbindet das Anlagen- und Tag-Stammverzeichnis sowie die Ereignisse der Platform mit dem, was externe Systeme wie MES, ERP, PLM, Qualität, Instandhaltung und Arbeitssicherheit liefern — Arbeitsaufträge, Teile, Personen, Konstruktionsänderungen, Abweichungen, Instandhaltung und Genehmigungen — zu einem einzigen Graphen. Ab 2026.10 ist er standardmäßig im AI-Stack enthalten — es gibt keinen Schalter zum Aktivieren.

Wer macht was

Wer	Wo	Was
Betreiber (Administrator)	AI-Admin-Konsole → Leiste Digital Thread	Konnektoren zu externen Systemen anbinden, Felder verknüpfen, prüfen, ob der Spiegel läuft und was der Bereitschaftsbewertung zugrunde liegt
Vor-Ort-Anwender	Copilot Fragen (/chat) — Werkzeug thread_	Fragt „Welche Arbeiten stehen heute an?“, „Was ist heute Morgen am Ladegerät passiert?“, „Was hängt an dieser Anlage dran?“ und erhält Antworten. Im Copilot gibt es keine eigene Digital-Thread-Ansicht → Digital Thread — was hinzukommt, wenn angebunden
Automatisierung · Vorschläge	Dieselben thread_-Werkzeuge · Aktionswerkzeuge	Die Automatisierung prüft zur festgelegten Zeit dasselbe; wird im Vorschlagsdetail freigegeben, entsteht im externen System ein Entwurf

---

Woraus er besteht

Komponente	Aufgabe
plantpulse-digital-thread-api (intern 7140)	Konnektorverzeichnis · Konformitätsprüfung · Bindungs-Synchronisation · Spiegelprojektion · Zeitleisten-/Verbindungsabfragen · Bewertung der Arbeitsbereitschaft · Chat-Werkzeuge
plantpulse-digital-thread-neo4j (nicht veröffentlicht)	Speicher für den Werksgraph-Spiegel. Ausschließlich für diesen Dienst und getrennt vom Neo4j von LightRAG
Schema dt in PostgreSQL pi	Konnektorverzeichnis · Bindungen · Identitätsdeklarationen · Aktionsprotokoll → Datenbankmodell

Beide Container öffnen keine Host-Ports. Admin-Konsole und Copilot rufen sie innerhalb des compose-Netzwerks auf → Service-Port-Map

Der Spiegel enthält nur «Referenzen»

Im Spiegel stehen nur IDs und Verbindungen von Ereignissen und Objekten, keine Inhalte. Es ist eine Kopie, die sich aus den Quellen (Platform-Stammverzeichnis · Ereignisse, externe Systeme) jederzeit neu erzeugen lässt. Werte wie Namen oder Gültigkeitsfristen aus externen Systemen werden bei der Abfrage aus dem Konnektor gelesen und nicht gespeichert.

---

Integrationskarte — Konnektoren anbinden

Nr.	Stelle	Aufgabe
①	Kopfzeile	Ansichtsschalter Karte / Liste / Bereitschaftsquellen (die Liste zeigt denselben Inhalt als Tabelle, zu den Bereitschaftsquellen siehe unten), Konnektor hinzufügen (vier Schritte unten), Aktualisieren
②	Übersichtskarten	Anzahl registrierter Konnektoren · aktive · Konformitätsfehler · Anzahl der von Konnektoren bereitgestellten Werkzeuge. Ist die Zahl der Konformitätsfehler ungleich 0, zuerst diesen Konnektor ansehen
③	Karte	Verbindet externes System → Konnektor → Werkzeug → Bindung → Werksgraph von links nach rechts. Ein Klick auf einen Knoten öffnet im Seitenfenster Konfiguration, Ergebnisse je Konformitätsprüfung und die letzten Aktionsaufrufe; die Karte hebt nur die Kette dieses Knotens hervor

Bei elf Familien wird die Karte breit. Grenzen Sie über die Filterzeile oberhalb der Karte nach Familie und Status ein und navigieren Sie per Ziehen, Mausrad und Strg+Mausrad (Zoom) → AI-Admin-Konsole — Integrationskarte

Farben und Linien der Karte lesen sich so:

Darstellung	Bedeutung
Grün	Aktiv — Konformitätsprüfung bestanden
Rot	Konformitätsfehler
Grau	Deaktiviert
Durchgezogene Bindung	Vom Konnektor deklariert
Gestrichelte Bindung	Vom Betreiber festgelegt oder aus der Standard-Feldtabelle des Dienstes (Felder, die die Synchronisation immer mitführt)
🔒 Aktionswerkzeug	Werkzeug, das im externen System Entwürfe/Anforderungen erzeugt — wird von der Konsole nicht aufgerufen (siehe „Schutzmechanismen“ unten)

Konnektor registrieren — vier Schritte

Ein Klick auf Konnektor hinzufügen öffnet das Seitenfenster.

1. Externes System — Familie (Tabelle unten), Systemname und Konnektorname festlegen.
2. Endpunkt und Zugangsdaten — MCP-Endpunkt des Konnektors sowie Auth-Header und -Wert eintragen und Registrieren und erkennen klicken. Der Dienst liest Werkzeugliste und Standort aus dem Konnektor und meldet „N Werkzeuge an Standort … gefunden“. Der Konnektor wird deaktiviert angelegt.
3. Konformität — Konformitätsprüfung ausführen. Jede Prüfung ergibt bestanden oder fehlgeschlagen; fehlgeschlagene Prüfungen nennen den Verstoß.
4. Aktivieren — 🔴 Aktivieren ist nur nach bestandener Konformitätsprüfung möglich. Nach dem Aktivieren stehen die Werkzeuge dieses Konnektors an diesem Standort zur Verfügung.

Endpunkt- oder Zugangsdatenänderungen deaktivieren den Konnektor

Werden beim Bearbeiten Endpunkt oder Zugangsdaten geändert und gespeichert, wird der Konnektor deaktiviert und das Konformitätsergebnis gelöscht. Beginnen Sie erneut bei Schritt 3. Dasselbe gilt, wenn sich die Werkzeugliste des Konnektors ändert (Werkzeugerkennung).

Zugangsdaten sind schreibgeschützt lesbar

Auf dem Bildschirm steht nur „Gesetzt / Nicht gesetzt“. Lässt man das Feld beim Bearbeiten leer, bleibt der gespeicherte Wert erhalten. Die Werte werden mit PI_DT_SECRET_KEY verschlüsselt gespeichert — geht dieser Schlüssel verloren, lassen sich die gespeicherten Zugangsdaten nicht mehr entschlüsseln und müssen je Konnektor neu eingegeben werden → Passwörter · API-Schlüssel ändern

Was die Konformitätsprüfung misst

Sie ruft den Konnektor tatsächlich auf und prüft, ob er spezifikationsgemäß antwortet. Typische Prüfungen:

Gruppe	Gemessen wird
Erkennung	Ob capabilities das Schema einhalten, ob Werkzeugnamen in der Spezifikation der deklarierten Version vorkommen, ob alle Pflichtwerkzeuge der Familie vorhanden sind
Deklaration	Ob Lesewerkzeuge als schreibgeschützt gekennzeichnet sind, ob das Eingabeschema der Spezifikation entspricht
Ausgabe	Ob das Ergebnis eines Beispielaufrufs dem Spezifikationsschema entspricht — auch Felder einer neueren Version als der deklarierten führen zum Fehlschlag
Zeit · Paginierung · Limits	Zeitformat, keine Duplikate oder Lücken beim vollständigen Durchblättern, Ablehnung zu breiter Zeiträume und bedingungsloser Listen
Fehler · Größe	Ob für nicht existierende IDs not_found zurückgegeben wird, ob die Antwort unter 16.000 Zeichen bleibt
Ereignisse · Bindungen	Form des Ereignis-Envelopes, ob das Ereignisziel über Bindungen auflösbar ist, ob dasselbe Ereignis bei zweimaligem Lesen dieselbe ID hat
Latenz	Ob p95 der Pflicht-Lesewerkzeuge unter 2 Sekunden liegt

Die Prüfungen laufen mit Stichproben aus dem Zeitraum «letzte 7 Tage ~ nächste 7 Tage». Enthält dieser Zeitraum keinerlei Daten, lässt sich das Schema nicht prüfen — testen Sie daher mit einem Konnektor, der reale Daten liefert.

Unterstützte Spezifikationen und Familien

Die Registrierungsmaske bietet elf Familien zur Auswahl, die neun Spezifikationssträngen folgen. Familien ohne Spezifikation lassen sich nicht registrieren. Welche Werkzeuge je Familie bereitzustellen sind, wo sie verwendet werden und worauf zu achten ist, steht familienweise in Digital-Thread-Konnektoren.

Familie (Anzeigename)	Spezifikation · Mindestversion	Inhalt (nur Schlüssel)
mes (MES)	mes-mcp/0.7	Anlagen · Arbeitsaufträge · Arbeitsgänge · Meilensteine · Auftragsprojekte · Ist-Lose · Genealogie · Fertigungsstückliste
scm (SCM)	mes-mcp/0.7	Lieferanten · Beschaffung · Lieferlinien · Versand · Wareneingang · Fehlteile · Lieferkapazität
sched (Feinplanung (APS))	mes-mcp/0.7	Arbeitsgangtermine des freigegebenen Plans · Ressourcenkalender · Szenarien
erp (ERP)	erp-mcp/0.4	Personen (pseudonymisierte ID) · Qualifikationen · Zuordnungen, Materialbestellungen · Wareneingang · Kundenaufträge, Fertigungsstückliste
plm (PLM)	plm-mcp/0.2	Konstruktionsänderungsaufträge · Konstruktionsstückliste · Dokument-Metadaten
qm (Qualität)	qm-mcp/0.2	Prüflose · Abweichungen (NCR)
cmms (Instandhaltung (CMMS))	cmms-mcp/0.2	Instandhaltungsaufträge · Wartungsfenster
tool (Werkzeugverwaltung)	tool-mcp/0.2	Bestandsverzeichnis für Werkzeuge · Vorrichtungen · Messmittel und deklarierte Funktionen (Ausgabe · Kalibrierung · Standzeit · Werkzeuge je Arbeitsgang)
wms (Lager (WMS))	wms-mcp/0.2	Bestand · Bewegungen (nicht im Spiegel, werden bei Bedarf gelesen)
lims (Labor (LIMS))	lims-mcp/0.2	Proben · Prüfergebnisse
ehs (Arbeitssicherheit (EHS))	ehs-mcp/0.3	Arbeitsfreigaben · Freischaltung (LOTO) · Vorfallreferenzen · Inspektion · Gefährdungsbeurteilung · Rollenqualifikationen

• 🔴 Konnektoren, die eine niedrigere als die Mindestversion deklarieren, werden nicht verwendet (ab 2026.10 Re-Release (2026-10-20)) — die Synchronisation wird abgelehnt und die Bewertung meldet «nicht angebunden». Zum Anheben siehe Version anheben.
• Deklariert ein bereits angebundener Konnektor eine neue Version, wird er bei der Werkzeugerkennung deaktiviert — führen Sie für diesen Konnektor Konformitätsprüfung → Aktivieren erneut aus.
• Aktionswerkzeuge (🔒 — erzeugen Entwürfe und Anforderungen) gibt es nur im Strang mes-mcp — Sperranforderung, Instandhaltungsanforderung und Arbeitsauftragsentwurf im MES, Mahnung und Lieferantenanfrage-Entwurf im SCM, Szenarienentwurf in der Feinplanung. Die übrigen acht Spezifikationen sind schreibgeschützt.
• Diese Spezifikationen beziehen sich nicht auf bestimmte Produkte, sondern auf den gemeinsamen Nenner. Setzen Sie vor Ihr System einen Konnektor, der dieser Spezifikation folgt.

Adapter für kommerzielle Produkte — Stand Vorab-Verifizierung

Die Adapter für SAP S/4HANA (ERP · Instandhaltung), IBM Maximo (Instandhaltung), Siemens Teamcenter (PLM) und Dassault 3DEXPERIENCE (PLM) haben die Konformitätsprüfung gegen einen Mock-Server bestanden, wurden aber nicht am realen Produkt verifiziert → Adapter für kommerzielle Produkte

Mehrere Konnektoren derselben Familie an einem Standort

An einem Standort können mehrere Konnektoren derselben Familie angebunden werden (z. B. je Linie ein anderes MES). Je Familie gibt es genau einen Primärkonnektor; der zuerst registrierte Konnektor wird Primärkonnektor.

• Zur Übergabe legen Sie einen anderen Konnektor als Primärkonnektor fest — der bisherige tritt automatisch zurück. Der Primärkonnektor darf nicht leer bleiben.
• Stellen zwei Konnektoren denselben Werkzeugnamen bereit, wird der später angebundene abgelehnt. Entfernen Sie das Werkzeug auf Konnektorseite.
• Sendet eine Vorschlagskarte des Copilot eine Aktion, geht diese bei mehreren Konnektoren derselben Familie an den Primärkonnektor.

Externe Links — im Ursprungssystem öffnen

Klickt man im Belegpanel von Copilot-Fragen auf einen Thread-Knoten (PO-Zeile · Arbeitsauftrag · Teilenummer …), erscheint ein Link wie «In SAP öffnen» zum Bildschirm dieses Datensatzes im Ursprungssystem → Digital Thread — Antwortbelege. Dieser Link entsteht nur, wenn der Administrator für den Konnektor eine Link-Vorlage hinterlegt hat. Ohne Vorlage gibt es keinen Link (Installationsstandard).

Eingetragen wird unter Integrationskarte › Konnektorknoten › Seitenfenster External links.

Feld	Eintrag
Base URL	Wurzel des Bildschirms im Ursprungssystem (z. B. https://s4.example.com). Nur https. Keine user:pass@ · Query · Fragmente
Button label	Angezeigter Text, bis zu 60 Zeichen (z. B. «In SAP öffnen»). Bleibt es leer, wird der Konnektorname unverändert als Schaltflächentext verwendet
Allow http:// (in-house demo only)	Nur für interne Demosysteme mit Klartext-http einschalten. Produktivsysteme müssen https verwenden
Templates by object kind	Je Art (po_line · work_order · part · ncr …) eine URL-Vorlage. Mit Add template erweitern. Mindestens eine ist erforderlich
Sample key for the preview	Mit einem Beispielschlüssel wird die aus der Vorlage erzeugte Adresse vorab angezeigt (nur zur Orientierung)

Es gibt nur drei Platzhalter.

Platzhalter	Eingesetzt wird
{base}	Die Base URL (ohne abschließendes /)
{key}	Der gesamte Objektschlüssel (URL-kodiert — auch / als %2F)
{key.1} ~ {key.9}	Der N-te Teil des an / aufgeteilten Schlüssels. Für PO-Nummer und Positionsnummer einer PO-Zeile 4500001/10 getrennt

po_line   {base}/sap/bc/ui2/flp#PurchaseOrder-display?PurchaseOrder={key.1}&PurchaseOrderItem={key.2}
customer  {base}/sap/bc/ui2/flp#Customer-display?Customer={key}

• Bei Save links prüft der Digital Thread die Vorlagen. Fehlt in einer Vorlage {key} · {key.N}, enthält sie unbekannte Platzhalter · Arten · Leerzeichen, oder verlässt die resultierende Adresse den Host der Base URL, wird abgelehnt und der Grund angezeigt. 🔴 Maßgeblich ist die Prüfung beim Speichern; die Vorschau im Bildschirm dient nur der Orientierung.
• Remove links löscht die Vorlagen dieses Konnektors. Hinzufügen oder Löschen von Vorlagen ändert weder Konformitätsergebnis noch Aktivierungsstatus.
• Fügt man unter Fill from JSON eine Link-Konfiguration ({"base_url": …, "templates": …}) oder den Vorschlag eines Demosystems ({"links": …}) ein, wird das Formular ausgefüllt.
• Haben mehrere Konnektoren Vorlagen für dieselbe Art, wird unter den aktiven Konnektoren desselben Standorts wie der Knoten zuerst die führende Familie dieser Art verwendet (PO-Zeile · Kundenauftrag ERP, Arbeitsauftrag · Arbeitsgang MES, Teilenummer · Dokument · Konstruktionsänderung PLM, Nichtkonformität · Prüfung QM, Instandhaltungsauftrag CMMS), danach der Primärkonnektor. Gibt es dieselbe Nummer an mehreren Standorten und führen die Adressen auseinander, wird kein Link ausgegeben.
• Der Copilot zeigt neben der Schaltfläche den Zielhost an; Knoten außerhalb des Bereichs erhalten keinen Link. Die Berechtigung der Person, die den Link öffnet, prüft das Ursprungssystem erneut.
• Geänderte Vorlagen greifen sofort. Bereits gespeicherte Belegkarten von Antworten behalten jedoch den Link zum Zeitpunkt der Antwort; der Link im per Knotenklick geöffneten aktuellen Wert im Ursprungssystem wird aus der aktuellen Vorlage erzeugt.

Felder verknüpfen (Bindung) — per Drag-and-drop

Damit verknüpfen Sie Felder, die die Synchronisation nicht standardmäßig mitführt, mit Objekten des Werksgraphen, ändern den Typ eines vom Konnektor deklarierten Feldes oder deaktivieren es.

1. Klicken Sie auf der Karte die Gruppe Lesewerkzeuge an. Im Seitenfenster öffnet sich die Feldliste je Werkzeug.
2. Ziehen Sie ein Feld auf einen Typ (Anlage · Arbeitsauftrag · Teil …) in der Spalte Werksgraph rechts auf der Karte (oder klicken Sie das Feld an und wählen anschließend den Typ).
3. Klicken Sie im Bestätigungsdialog des Seitenfensters auf Binden. Legen Sie ein deklariertes Feld auf einen anderen Typ, erscheint zusätzlich «Überschreibt den deklarierten Typ».
4. Zum Deaktivieren 🚫, zum Löschen den Papierkorb in der Feldzeile oder den gestrichelten Knoten auf der Karte verwenden.

• Betreiberbindungen haben Vorrang vor Konnektordeklarationen.
• Änderungen gelten ab der nächsten Synchronisation. Wenn Sie nicht auf die periodische Synchronisation (siehe unten) warten möchten, klicken Sie im Seitenfenster auf Jetzt synchronisieren — Objekt- und Verbindungszahlen werden angezeigt. Nur aktive Konnektoren lassen sich synchronisieren.
• Das ID-Feld des Datensatzes selbst ist nicht änderbar.
• Wer wann was geändert hat, steht im Bindungs-Änderungsprotokoll und im Audit-Log der Admin-Konsole (thread.write).

Fertigungsstückliste (M-BOM)

Die Konstruktionsstückliste (plm_get_bom im PLM) sagt «woraus etwas besteht», die Fertigungsstückliste «wie es im Werk tatsächlich gefertigt wird» — Phantompositionen, Halbfabrikate, Ersatzmaterial und in welchem Arbeitsgang verbraucht wird. Je nach führendem System liefert sie einer der beiden Konnektoren.

M-BOM führend	Konnektor	Werkzeug
ERP	erp deklariert erp-mcp/0.2	erp_get_mbom
MES · MPM	mes deklariert mes-mcp/0.6	mes_get_mbom

Beide Werkzeuge liefern dieselbe Struktur. Sind beide aktiv, wird zuerst das ERP gelesen.

• Wiederanlaufpläne werden genauer. Mit M-BOM lässt sich über den verbrauchenden Arbeitsgang eingrenzen, welchen Arbeitsgang eine von einer Konstruktionsänderung oder Abweichung betroffene Teilenummer blockiert. Ohne M-BOM wird angenommen, dass «je Arbeitsauftrag blockiert wird», und dies unter «Nicht berücksichtigt» in der Antwort vermerkt.
• BOM-Dreifachabgleich — Konstruktionsstückliste, Fertigungsstückliste und Zeichnungsstückliste werden verglichen und fehlende Unterteilenummern, Mengen, Einheiten und Versionsrückstände nur gemeldet. Es wird nichts korrigiert. Es gibt keine Oberfläche; der Abruf erfolgt über die Service-API (/api/v1/bom/reconcile).

Materialbestellungen und Kundenaufträge — der Thread entlang der PO

Ab 2026.10 Re-Release 3 verbindet der Thread beide Enden über Aufträge.

자재 PO 줄 ─(걸림)→ 작업지시 ─(속함)→ 마일스톤 · 프로젝트 ─(이행)→ 고객 주문 줄 ─(주문자)→ 고객

Materialbestellzeilen — ERP und SCM werden zusammengeführt. Führend für die PO ist das ERP (erp_list_purchase_orders aus erp-mcp/0.3); das SCM kennt den vom Lieferanten bestätigten Termin. Sind beide angebunden, werden gleiche po_id · po_line zu einer Zeile zusammengeführt.

Feld	Welcher Wert gilt
Termin (zugesagt · bestätigt)	Liegt im SCM eine Lieferantenbestätigung (confirmed_date) vor, SCM, sonst ERP
Status · offene Menge und übrige Felder	ERP (führend)

• 🔴 Weichen die Werte beider Quellen ab, wird nicht stillschweigend einer gewählt. Gewählter Wert und Regel werden zusammen als conflicts[] ausgegeben und erscheinen ebenso in der Antwort des Wiederanlaufplans.
• Zeilen, die nur in einer Quelle existieren, behalten deren Werte.
• Auch ohne SCM funktionieren Materialposition der Bereitschaft und Wiederanlaufplan allein mit dem ERP. Dabei gilt «offene PO-Zeilen an einem Arbeitsauftrag = Material, auf das dieser Arbeitsauftrag wartet»; da ERP-POs nichts über Bestände aussagen, ist der Bestand unbekannt — diese Annahme wird im assumptions der Antwort vermerkt.

Kundenauftragszeilen — Pufferzeit und Risiko. Kundenauftragszeilen liefert erp_list_sales_orders im ERP (Kunde · Kunden-PO-Nummer · Vertragstermin · Zusagetermin · Vertragsstrafenbedingungen usw.). Eine Zeile knüpft über Meilenstein (Versand), Arbeitsauftrag oder Projekt an das Werksgeschehen an.

• Pufferzeit (slack_days) = 00:00 (lokal) des Folgetags des Liefertermins (Zusagetermin, falls vorhanden, sonst Vertragstermin) − voraussichtliche Fertigstellung. Einheit 0,1 Tage. Für die voraussichtliche Fertigstellung werden nur Zahlen aus Planung und Verzugsrechnung verwendet — fehlen diese, ergibt sich slack_days: null mit Begründung.
• Zeilen, die nur über ein Projekt anknüpfen, kennen den Liefertag nicht; die Pufferzeit wird daher per slack_basis als «Obergrenze» ausgewiesen, die Vorgänge nach diesem Arbeitsauftrag nicht mitzählt.
• slack_basis ist die Bezugsgröße der Pufferzeit — work_order_planned_end (Planende des Arbeitsauftrags) · work_order_planned_end_project_only (Obergrenze auf derselben Basis) · delay_propagated (nachdem die Wiederanlaufrechnung Teileverzüge fortgepflanzt hat). Bereitschaft und Tagesliste nutzen die ersten beiden, die Wiederanlaufrechnung (explain_recovery · Auswirkungstabelle) delay_propagated. Auch bei derselben Kundenauftragszeile können beide Werte stark abweichen; der Copilot unterscheidet darüber «Planpuffer» und «(mit Verzug)».

Pufferzeit	risk
Kleiner 0	late (Termin überschritten)
Kleiner 2 Tage	at_risk (Risiko)
Sonst	on_track (Puffer)
Nicht berechenbar	unknown (unbekannt)

Liefert der ERP-Konnektor keine Kundenaufträge (Version unter 0.3 oder deaktiviert), bleibt das Kundenauftragsfeld nicht leer, sondern wird «unbekannt»; die Begründung steht in customer_orders_unknown_because.

Konnektor-Synchronisation — Intervall und Jetzt synchronisieren

Die Konnektor-Synchronisation überträgt Bindungen und Ereignisse aktiver Konnektoren in den Spiegel. Ab 2026.10 Re-Release 3 läuft sie periodisch im Dienst — das ist etwas anderes als die 10-Minuten-Projektion des Graphspiegels (Platform-Stammverzeichnis · gelernte Kanten).

• Intervall — Jeder Konnektor wird im Abstand der Hälfte der Aktualitätsgrenze seiner Familie (mindestens 300 Sekunden) synchronisiert. Beispiel: MES und Planung stündlich, EHS alle 30 Minuten, ERP alle 12 Stunden. So bleibt der Spiegel stets innerhalb der Grenze. Nach einem Neustart des Dienstes wird jeder aktive Konnektor kurz darauf einmal synchronisiert.
• Das Fenster ist «jetzt ± 15 Tage».
• Verschwundene Verbindungen werden geschlossen. Verbindungen, die die Quelle in diesem Fenster nicht mehr meldet, werden nicht gelöscht, sondern geschlossen (Endzeitpunkt wird eingetragen) → Verbindungshistorie
• 🔴 War die vom Konnektor gelieferte Liste abgeschnitten, wird das Schließen übersprungen — andernfalls würden auch intakte Verbindungen geschlossen. prune_skipped in der Antwort nennt den Grund; in der Konsole erscheint die gelbe Zeile „Diese Synchronisation hat verschwundene Verbindungen nicht geschlossen — die Erfassung war abgeschnitten …“.
• Schlägt ein Konnektor fehl, laufen die übrigen weiter. Der fehlgeschlagene wird im nächsten Intervall erneut versucht.
• Synchronisationen desselben Konnektors laufen nacheinander in einer Warteschlange.

Jetzt synchronisieren im Seitenfenster der Integrationskarte führt dieselbe Synchronisation sofort einmal aus — nutzen Sie es direkt nach dem Aktivieren eines Konnektors oder nach dem Ändern einer Feldbindung. Als Ergebnis erscheinen Objekt- und Verbindungszahlen; verschwundene Verbindungen werden wie bei der periodischen Synchronisation geschlossen.

Status ansehen. Unter /health des Digital Thread erscheint connector_sync — aktiv ja/nein, Durchlauf, letztes Ergebnis je Konnektor und Liste der fehlschlagenden Konnektoren (failing). Dies ist reine Information; ein fehlgeschlagener Konnektor setzt den Servicestatus nicht auf «Achtung» (es handelt sich um ein Fremdsystem).

Konfiguration. Über Installations-env änderbar. Bleiben alle leer, gelten die obigen Standardwerte → Konfiguration

Schlüssel	Standard	Bedeutung
DT_CONNECTOR_SYNC_ENABLED	true	Periodische Synchronisation. Bei false bleibt nur Jetzt synchronisieren in der Konsole
DT_CONNECTOR_SYNC_INTERVAL_S	0	Synchronisationsintervall (Sekunden). Bei 0 familienabhängig (Hälfte der Grenze)
DT_CONNECTOR_MAX_AGE	leer	Aktualitätsgrenze je Familie. Beispiel: mes=2h,erp=1d
DT_LINK_HISTORY_DAYS	leer (= 180)	Aufbewahrungstage geschlossener Verbindungen

Referenz-Demokonnektoren

Unter den Referenz-Demokonnektoren des Digital-Thread-Repositorys (nicht im Produkt-Image enthalten) deklariert das ERP der Schwerindustrie-Auftragsfertigungswelt heavy die Version erp-mcp/0.3 und liefert Bestellungen, Wareneingänge und Kundenaufträge. Damit lässt sich der PO-Thread dieser Version in der Testumgebung nachvollziehen.

Verbindungshistorie — Status zum jeweiligen Stichtag

Vom Konnektor geladene Verbindungen (Arbeitsauftrag → Anlage, Konstruktionsänderung → Teilenummer, Unterteilenummer → Oberteilenummer …) werden, wenn sie in der Quelle verschwinden, nicht gelöscht, sondern geschlossen. Daher lassen sich Fragen beantworten wie „An welcher Anlage hing dieser Arbeitsauftrag letzten Dienstag?“ oder „Welche übergeordnete Baugruppe hatte diese Teilenummer vor der Konstruktionsänderung?“.

• Das Chat-Werkzeug thread_trace_links und Verbindungsabfragen akzeptieren as_of (den Zeitpunkt). Standard sind nur die «jetzt offenen» Verbindungen.
• Geschlossene Verbindungen bleiben 180 Tage (DT_LINK_HISTORY_DAYS) erhalten. Für frühere Zeitpunkte lautet die Antwort nicht «gab es nicht», sondern «unbekannt».
• Das Schließen von Verbindungen übernimmt die Konnektor-Synchronisation — sowohl die periodische Synchronisation als auch Jetzt synchronisieren in der Konsole schließen (über die Service-API prune: true in POST /api/v1/connectors/{id}/sync). prune_applied in der Antwort sagt, ob geschlossen wurde, prune_skipped den Grund des Überspringens (abgeschnittene Liste).
• Stammverzeichnis-Projektion, gelernte Kanten und Identitätsverbindungen haben keine Historie (immer «jetzt»).

Wenn Systeme unterschiedliche Nummern führen — Identität (SAME_AS)

Heißt dieselbe Teilenummer im PLM BLD-SX-S1 und im MES 100234-01, reißt der Thread und der Wiederanlaufplan meldet „im MES nicht gefunden“. In diesem Fall wird nur für von Menschen geprüfte Paare Gleichheit deklariert. Im Spiegel entsteht eine SAME_AS-Verbindung; die Nummern in den Quellen bleiben unverändert.

• 🔴 Es wird nicht automatisch verknüpft. Falsch verknüpfte Identitäten erzeugen falsche Verzugszahlen. Der Dienst zeigt lediglich Kandidaten (gleich bei Ignorieren von Groß-/Kleinschreibung, Trennzeichen und führenden Nullen; von anderen Konnektoren genannte Paare) — deklariert wird von Hand.
• Es gibt keine Oberfläche — Deklaration und Rücknahme erfolgen über die Service-API (/api/v1/identities, Kandidaten über /api/v1/identities/suggestions). Bei Rücknahme wird auch die Spiegelverbindung gelöscht; wer wann deklariert bzw. zurückgenommen hat, bleibt protokolliert.
• Deklarationen mit applied: false in der Liste bedeuten, dass eine der beiden Nummern noch nicht im Spiegel ist — sie werden nach der Synchronisation verknüpft.
• Die Zeitleiste folgt Identitäten bis zu zwei Schritten weit und zeigt so auch Ereignisse unter anderer Nummer; der Wiederanlaufplan nennt in der Antwort, «über welche Deklaration» verknüpft wurde.

Wenn Daten veralten — Aktualitätsgrenze

Konnektorantworten tragen einen Stand «auf welchen Zeitpunkt bezogen» (as_of). Liegt dieser Zeitpunkt länger zurück als die familienspezifische Grenze, geben Wiederanlaufplan und Bereitschaftsbewertung keine Zahlen und kein Urteil aus, sondern stoppen mit „veraltete Quelle“ (stale_inputs). So werden keine falschen Antworten aus veralteten Daten erzeugt.

Familie	Grenze
ehs	1 Stunde
mes · sched · wms	2 Stunden
cmms	4 Stunden
lims	12 Stunden
scm · erp · plm · qm · tool	1 Tag

Bei einem Stopp prüfen Sie zuerst, ob die Quelle hinter dem Konnektor (Replikat, Batch-Export) stehen geblieben ist. Welcher Konnektor veraltet ist, zeigt das Kennzeichen veraltet in der Ansicht Bereitschaftsquellen der Integrationskarte.

Grenzen werden über Installations-env geändert

Ab 2026.10 Re-Release 3 lassen sich die familienspezifischen Grenzen über DT_CONNECTOR_MAX_AGE in der Installations-env ändern (z. B. mes=2h,erp=1d, Einheiten s · m · h · d). Bleibt der Wert leer, gilt die obige Tabelle. Auch das periodische Synchronisationsintervall der Konnektoren folgt der Hälfte dieser Grenze → Konnektor-Synchronisation

---

Graphspiegel — läuft er sauber?

Nr.	Stelle	Aufgabe
①	Kopfzeile	Aktualisieren. Diese Ansicht ist schreibgeschützt
②	Übersichtskarten	Bewertung der letzten Projektion (normal · teilweise abgeschlossen · fehlgeschlagen …) · Zeitpunkt des letzten Erfolgs · Objektanzahl im Spiegel · Anzahl projizierter Verbindungen
③	„Letzter Lauf“ · „Graph-Sonde“	Links: Endzeitpunkt, Durchlauf · aufeinanderfolgende Fehler · Intervall, Ergebnisse je Schritt (Platform-Stammverzeichnis · gelernte Kanten). Rechts: Erreichbarkeit des dedizierten Neo4j und Knotenanzahl je Label
④	„Inhalt des Spiegels“	Je Position (Assets · Tags · Hierarchie · Versorgung/Abhängigkeit · Vorgängerbeziehungen …) die Herkunft (Platform-Stammverzeichnis · Lernen (insight)) und die Anzahl

Ein periodischer Job im Dienst überträgt alle 10 Minuten das Platform-Stammverzeichnis (Standort · Anlagenhierarchie · Tags · Anlagenbeziehungen) und die von Zeitreihen-Insights gelernten Verbindungen in den Spiegel. Der erste Durchlauf erfolgt eine Minute nach dem Start. Platform-Ereignisse werden separat laufend eingelesen; Ereignisreferenzen bleiben 180 Tage im Spiegel.

Bewertung	Bedeutung	Zu tun
Normal	Stammverzeichnis und gelernte Kanten wurden geladen	—
Teilweise abgeschlossen	Stammverzeichnis geladen, nur gelernte Kanten nicht (die bisherigen Kanten bleiben erhalten)	Wurde Zeitreihen-Insight gerade erst gestartet, löst sich das im nächsten Durchlauf
Fehlgeschlagen	Stammverzeichnis nicht geladen — der Spiegel veraltet gegenüber dem Stammverzeichnis. Die Karte auf der Startseite der Admin-Konsole wechselt auf gelb	Erscheint „Muss vom Betreiber behoben werden“, liegt ein Konfigurations- oder Zugangsdatenproblem vor → Logs

---

Wo er vor Ort und im Chat genutzt wird

Für den Copilot ist der Digital Thread eine optionale Integration. Der Copilot hat keine eigene Digital-Thread-Ansicht, -Karte oder -Menü (die alte /thread-Ansicht, die Karte «Heutige Arbeiten» im Chat-Startbildschirm und die Zeitleiste in der Anlagenansicht sind in der neuen Oberfläche entfallen); bei Anbindung kommen lediglich drei Dinge hinzu.

Was hinzukommt	Was es ist
Werkzeuge, die Fragen nutzt	Die thread_-Werkzeuge aus Chat-Werkzeuge unten
Werkzeuge, die die Automatisierung auswählt	Die Gruppe Digital Thread in der Werkzeugliste beim Erstellen einer Automatisierung sowie Vorlagen, die diese Anbindung voraussetzen → Automatisierung
Belege und Entwürfe zu Vorschlägen	Die Belege im Vorschlagsdetail und der bei Freigabe im externen System erzeugte Entwurf (siehe „Schutzmechanismen“ unten) → Vorschläge

• Digital-Thread-Vorlagen für Automatisierungen erscheinen nur, wenn die Werkzeuge vorhanden sind. Von den vierzehn Vorlagen der Galerie stützen sich PO mit Termin­risiko · Qualitätsabweichungsverfolgung · Zeichnungsrevisions-Benachrichtigung auf thread_-Werkzeuge; fehlen diese in der Installation oder darf der Ersteller sie nicht nutzen, erscheinen sie gar nicht in der Galerie (nicht etwa ausgegraut als «nicht verfügbar»). Sind Konnektoren angebunden und die Chat-Werkzeuge unten aktiv, erscheinen sie in der Galerie dieser Person — für Zeichnungsrevisions-Benachrichtigung muss zusätzlich zu thread_today_work eines der standardmäßig deaktivierten Versionsstatus-Werkzeuge (thread_part_revision_status oder thread_work_readiness) aktiviert sein. Bereits gespeicherte Automatisierungen öffnen und laufen unabhängig von der Galerie weiter.
• Belege zu Vorschlägen öffnen sich im rechten Panel. Ein Klick auf eine Belegzeile im Vorschlagsdetail (Dokumentoriginal · Zeichnung · Video) öffnet kein neues Tab, sondern ein weiteres Panel über dem Detail; mit Zurück in der Panel-Kopfzeile gelangen Sie an dieselbe Scrollposition des Details zurück. Zeichnungsbelege lassen sich aus der Panel-Vorschau über Im Viewer öffnen (neues Tab) aufrufen.
• Das Belegpanel von Antworten in Fragen liest das Ursprungssystem ein weiteres Mal. Klickt man im Verknüpfungsgraphen auf einen Knoten, liest der Digital Thread mit dem Lesewerkzeug des führenden Konnektors dieser Art diesen einen Datensatz aktuell und zeigt ihn als aktuellen Wert im Ursprungssystem (nicht gespeichert, 15 Sekunden je Konnektoraufruf); der Verlauf dieses Objekts zeigt die Ereignisse des Spiegels in 30-Tage-Schritten (Aufbewahrung 180 Tage). Fehlt dieser Konnektor oder ist er ausgeschaltet, erscheint lediglich «Unbekannt — Anbindung optional», kein Fehler. Der Link zum Ursprungssystem erscheint nur, wenn eine Externe Links-Vorlage vorhanden ist → Digital Thread — Antwortbelege

In Installationen ohne Anbindung erscheinen diese Werkzeuge schlicht nicht in der Liste; die Copilot-Oberfläche zeigt weder leere Felder noch einen Hinweis «nicht angebunden». Was Vor-Ort-Anwender fragen können, steht in Digital Thread — was hinzukommt, wenn angebunden.

Anlagen-Zeitleiste — über Fragen

Fragen Sie nach Vorgängen an einer Anlage etwa mit „Was ist an dieser Anlage zuletzt passiert?“, liefert thread_get_timeline die Ereignisse aus dem Spiegel chronologisch — Anlagenstatus · Termine, Arbeitsaufträge, KPI-Bestätigungen, Alarme, Incidents, KI-Vorschläge und -Funde. Was womit verbunden ist, beantwortet thread_trace_links.

Lautet die Antwort, die Anlage sei noch nicht im Digital Thread, hat die Spiegelprojektion diese Anlage noch nicht geladen — prüfen Sie den Zeitpunkt des letzten Erfolgs in der Graphspiegel-Ansicht oben.

Arbeitsbereitschaft für Schichtführer und Bereitschaftsquellen

Die Arbeitsbereitschaft gibt für jeden Arbeitsgang, der innerhalb einer Schicht ab jetzt (Standard 12 Stunden, maximal 48 Stunden) beginnen soll, GO · AT_RISK · NO_GO · UNKNOWN aus und liefert die blockierten zuerst zurück. Die Bewertung nimmt der Digital Thread vor; Fragen und Automatisierung geben den Wert lediglich weiter. In Fragen wird die Bereitschaft an jeder Zeile von thread_today_work (standardmäßig aktiv) mitgeführt; thread_work_readiness, das allein nach der Bereitschaft fragt, ist standardmäßig deaktiviert und muss vom Administrator aktiviert werden.

Je Arbeitsgang werden acht Positionen geprüft — Vorgänger-Arbeitsgang · Material · Werkzeug/Kalibrierung · Personal/Qualifikation · Freigabe/Freischaltung · Qualitätssperre · Anlageninstandhaltung · Zeichnungsversion. Jeder Position ist eine Konnektorfamilie zugeordnet (MES · SCM · Werkzeugverwaltung · ERP · Arbeitssicherheit · Qualität · Instandhaltung · PLM); die Tabelle dazu steht in AI-Admin-Konsole — Bereitschaftsquellen.

• 🔴 Unbekannt ist kein GO. Positionen ohne Quellkonnektor oder ohne Antwort sind UNKNOWN und zählen nicht als bestanden.
• Ohne MES-Konnektor sind die Arbeitsaufträge unbekannt und es findet gar keine Bewertung statt («kein MES — keine Bewertung»).
• Sind die Quelldaten älter als die Aktualitätsgrenze, stoppt die Bewertung («veraltete Quelle — Bewertung gestoppt»).
• Die Bewertung meldet nur — sie stößt keine Arbeiten an und ordnet niemanden neu zu.

Aufgabe des Betreibers ist es, Quellen anzubinden. Enthält die Bereitschaftsantwort viele UNKNOWN, suchen Sie in der Ansicht Bereitschaftsquellen der Integrationskarte nach Positionen mit fehlt (grau) oder veraltet und binden den Konnektor dieser Familie an bzw. bringen die Quelle wieder in Gang.

Die Bereitschaftsantwort (GET /api/v1/readiness, GET /api/v1/readiness/{작업지시}) enthält ab 2026.10 Re-Release 3 zusätzlich Folgendes.

Stelle	Feld	Bedeutung
Je Position	reason_code · reason_params	Begründung als maschinenlesbarer Code mit Werten. Der Copilot formuliert daraus Sätze in der Sprache des Anwenders (das englische reason ist derselbe Code ausformuliert)
Antwortkopf	purchase_orders	Nur wenn ERP-Bestellungen gelesen wurden — aus ERP-Zeilen gebildete Fehlmengenzeilen (derived_shortage_lines), abweichende Werte gegenüber SCM (conflicts) und die dabei getroffenen Annahmen (assumptions). Wurde nicht gelesen: null
Antwortkopf	customer_orders_unknown_because	Grund, warum Kundenaufträge nicht gelesen werden konnten (ERP liefert erp_list_sales_orders nicht usw.). Bei Erfolg: null
Je Arbeitsgang	customer_orders[]	Die Kundenauftragszeile, die dieser Arbeitsauftrag erfüllt — Termin · Pufferzeit · risk · Grundlage der Pufferzeit (slack_basis)

Position Zeichnungsversion

Die Zeichnungsversion prüft für die im Arbeitsgang verwendeten Teilenummern zweierlei.

1. Konstruktionsänderung — Gibt es im PLM eine veröffentlichte Konstruktionsänderung und liegen nur Teile des alten Stands vor, ist das Ergebnis NO_GO. Ohne PLM-Konnektor: UNKNOWN.
2. Werkstattzeichnung — Weicht die Version der in RAG indizierten Zeichnung von der im PLM veröffentlichten Version ab, ist das Ergebnis NO_GO. Dieser Vergleich findet nur statt, wenn die unten beschriebene Zeichnungsreferenz im Spiegel vorliegt. Fehlt sie, entfällt lediglich diese eine Prüfung; der Positionswert bleibt unverändert.

Den Versionsstatus einer Teilenummer (aktuelle Version · alte Version · Änderung läuft · nicht prüfbar) kann man auch separat abfragen — über das Chat-Werkzeug thread_part_revision_status; ebenso nutzt das Versionskennzeichen im Zeichnungsverzeichnis diesen Wert. Nicht prüfbar heißt nicht «aktuell».

Liste der heutigen Arbeiten — der Tag des Schichtführers

Das von Fragen und Automatisierung genutzte Werkzeug thread_today_work liefert diese Liste (in der alten Version nutzte auch die Karte „Heutige Arbeiten“ im Chat-Startbildschirm des Schichtführers dieselbe Liste). Über die Service-API ist es GET /api/v1/today?date=YYYY-MM-DD (das Datum bezeichnet einen Tag in der Installationszeitzone PP_TZ; leer = heute).

• Zeilen = die für den Tag geplanten offenen Arbeitsgänge (MES) + die aktuell in der Platform laufenden Arbeitsgänge. Auch wenn das MES «abgeschlossen» meldet, wird die Zeile geführt, solange sie in der Platform läuft.
• Felder der Zeile — Bereitschaft (readiness), erfüllter Kundenauftrag (customer_orders[], Pufferzeit slack_days · risk), erwartete Material-PO (materials[] — voraussichtliche Ankunft · Verzugstage), in der Werkstatt zu verwendende Zeichnung (drawings[] — Versionskennzeichen current · outdated · change_open · unknown), Aufträge und Anlagenstatus der Platform (platform), Hinweise (attention[]).
• Die Werte von attention sind readiness_no_go (Bereitschaft NO_GO) · material_late (Material verspätet) · outdated_drawing_on_file (Zeichnung alter Version hängt an) · drawing_change_open (Konstruktionsänderung läuft) · customer_due_at_risk (Kundentermin gefährdet) · platform_running_outside_plan (ungeplanter Arbeitsgang außerhalb des MES-Plans läuft).
• Sortierung — zuerst nach knapper Pufferzeit, dann NO_GO, alte Zeichnungsversion und geplanter Start.
• 🔴 Nicht lesbare Felder sind null mit <칸>_unknown_because (Begründung). Eine leere Liste bedeutet «gelesen, aber nichts vorhanden» — verwechseln Sie beides nicht.
• In der Platform laufende Aufträge werden über das externe Kennungspaar (external_system + external_id) der Zeile in der Platform-Auftragsliste (/api/v5/order/query) mit MES-Arbeitsgängen verknüpft — nur wenn external_system des Paares dem Namen des MES-Konnektors entspricht (z. B. demo-mes für das Demo-MES, PLANTPULSE-SIM für den Simulator); external_id ist dann die MES-Arbeitsgang-ID. Das Auftragsdetail wird nicht separat abgerufen. Aufträge mit leerem Paar oder anderem Systemnamen werden keinem Arbeitsgang zugeordnet.
• Aufträge und Anlagenstatus der Platform werden nur für heute gelesen (bei anderem Datum platform: null). Sind Platform-API-Adresse bzw. Token (DT_PLATFORM_API_URL · DT_PLATFORM_API_TOKEN) leer, wird die Begründung ebenfalls in platform_unknown_because geführt.
• Fehler — bei falschem Datumsformat 400 „date must be YYYY-MM-DD: …“, bei nicht erreichbarem Verzeichnis oder Konnektor 503 {종류}: {상세}.

Das Chat-Werkzeug thread_today_work liefert dieselbe Liste auf unter 16.000 Zeichen gekürzt zurück; der Copilot hängt an das Ende der Antwort die Tabellen «Heutige Arbeiten» und «Betroffene Kunden-POs» an → Digital Thread — was hinzukommt, wenn angebunden

Zeichnungsreferenzen — was RAG liefert

Ist die Zeichnungsindizierung von RAG (DRAWING_INGEST_ENABLED, ab Werk deaktiviert) aktiv, sendet RAG bei jeder Indizierung einer Zeichnung die aus dem Schriftfeld gelesenen Angaben Zeichnungsnummer · Version · Teilenummer · Stücklisten-Teilenummer · Merkmals-ID an den Digital Thread. Im Spiegel entsteht nur die Verbindung «diese Zeichnungsversion beschreibt diese Teilenummer»; Werte wie Maße oder Werkstoff werden nicht übernommen. Trifft eine neue Version ein, werden die Verbindungen der alten geschlossen.

Beim Empfang vergleicht der Digital Thread mit Stückliste und Konstruktionsänderungen des PLM und meldet Stücklistenabweichungen, gegenüber der Konstruktionsänderung veraltete Versionen und von der Konstruktionsänderung abweichende Versionen. Zum Aktivieren siehe Konfiguration, zur Zeichnungsansicht AI-Admin-Konsole — Zeichnungsverzeichnis.

Chat-Werkzeuge

Werkzeug	Standard	Aufgabe
thread_get_timeline	aktiv	Vorgänge an einem Objekt in chronologischer Folge
thread_trace_links	aktiv	Womit und wie ein Objekt verbunden ist, Pfad zwischen zwei Objekten
thread_today_work	aktiv	Liste der heutigen Arbeiten des Schichtführers — je Arbeitsgang Bereitschaft · Pufferzeit des Kundenauftrags · erwartete Material-PO · zu verwendende Zeichnungsversion (oben)
thread_impact_range	aktiv	Wie weit eine verspätete PO · ein Lieferant · eine Anlage · ein fehlerhaftes Los reicht — Arbeitsaufträge · Kundenaufträge · Kunden (vorwärts = Verzug, rückwärts = Qualitätsrückverfolgung), auch Verbindungen zu einem früheren Zeitpunkt (as_of)
thread_interval_production	aktiv	Arbeitsaufträge · Lose · Seriennummern, die während eines Anomalie- oder Stillstandsintervalls auf der Anlage liefen, und die Kunden, die diese Lose erreichen (max. 31 Tage)
thread_explain_recovery	aktiv	Um wie viel sich Termine bei verspäteten Teilen verschieben, samt Wiederanlaufplan (What-if). Siehe unten
thread_work_readiness	aktiv	Arbeitsbereitschaft für Schichtführer — je Arbeitsgang GO · AT_RISK · NO_GO · UNKNOWN mit Begründung je Position
thread_part_revision_status	aktiv	Ob Teilenummer und Version aktuell verwendbar sind (Abgleich mit PLM-Freigabestand und Konstruktionsänderungen)
thread_check_tooling	aktiv	Aus dem Werkzeugverwaltungs-Konnektor — Messungen mit überfälliger Kalibrierung oder gefallenen Messmitteln, in Arbeitsaufträgen eingesetzte Werkzeuge, verschlissene Werkzeuge als Ursachenkandidaten von Abweichungen

Das MCP Gateway registriert diesen Server als eingebauten Server und übernimmt alle neun bei der ersten Erkennung aktiviert (2026.10 Re-Release (2026-10-20) — vorher aktivierte der Copilot nur vier). Vom Administrator einmal geänderte Werte werden nicht überschrieben; neue Werkzeuge des Digital Thread kommen deaktiviert hinzu. Aktiviert und deaktiviert wird unter AI-Admin-Konsole › MCP Gateway › Tools → MCP Gateway · MCP-Werkzeugkarte

today_work · work_readiness · part_revision_status · check_tooling erscheinen nur in der Liste, wenn das Konnektorverzeichnis konfiguriert ist, explain_recovery nur, wenn es eine Quelle für die Wiederanlauf-Eingaben gibt. Die hier gesetzten Werte gelten für Fragen und Automatisierung gemeinsam — ein deaktiviertes Werkzeug kann weder von Fragen noch von der Automatisierung genutzt werden. Es gibt keine Stelle, an der die Copilot-Oberfläche den Digital Thread direkt aufruft.

Die Zahlen von thread_explain_recovery stammen aus dem Optimierungslöser des Digital Thread; das Modell gibt sie nur weiter. Je nach aktiven Konnektoren erweitert sich der Inhalt der Antwort.

Aktiver Konnektor	Was die Antwort zusätzlich enthält
PLM · QM	Je Konstruktionsänderung bzw. Abweichung die dadurch blockierte Arbeit und den zusätzlichen Verzug am Meilenstein. Sind Zeitpunkt, Bearbeitung oder Wirksamkeit unbekannt und keine Zahl möglich, wird ohne Zahl die Begründung genannt
SCM (mes-mcp/0.5 Lieferkapazität)	Je verspätetem Teil, ob eine frühere Lieferung über die Lieferantenkapazität möglich ist und welcher Meilensteinverzug dann bliebe. Ist die Kapazität unbekannt, wird nur die Auswirkung genannt, keine Wiederanlaufzahl
ERP erp-mcp/0.2 · MES mes-mcp/0.6 (Fertigungsstückliste)	Die Blockierung durch Konstruktionsänderung bzw. Abweichung wird nicht auf den ganzen Arbeitsauftrag, sondern auf den die Teilenummer verbrauchenden Arbeitsgang eingegrenzt
Feinplanung (APS)	Die Arbeitsgangtermine des freigegebenen Plans dienen als Basis der Wiederanlaufrechnung
Instandhaltung (CMMS) · Arbeitssicherheit (EHS)	Wartungsfenster, anlagenstoppende Störungsbehebungen und Freischaltungen werden als Anlagenrestriktionen mitgeführt
Werkzeugverwaltung · Lager (WMS)	Werkzeug-Bereitstellungsstatus der Arbeitsaufträge im Betrachtungsumfang, Bestand verspäteter Teile (verfügbar · vorhanden · reserviert · in Prüfung)
ERP erp-mcp/0.3 (Bestellungen · Kundenaufträge)	Auch ohne SCM werden verspätete Materialien über ERP-Bestellungen ermittelt. Betroffene Kundenauftragszeilen (customer_orders[] — Termin · Pufferzeit · Risiko) sowie zwischen ERP und SCM abweichende PO-Werte (purchase_order_conflicts[]) werden mitgeführt. Können Kundenaufträge nicht gelesen werden, steht die Begründung in customer_orders_unknown_because

Fehlende Konnektoren werden in der Antwort unter «Nicht berücksichtigt» vermerkt — das Modell muss das als «unbekannt» formulieren.

Dieses Werkzeug ist ab Werk aktiv. Schlägt der Wiederanlaufplan einen Mahnungs-«Entwurf» vor, erscheint unter der Antwort auf Fragen eine Aktionskarte («Mögliche Aktionen») (siehe „Schutzmechanismen“ unten). Sollen keine Karten erscheinen, deaktivieren Sie dieses Werkzeug unter AI-Admin-Konsole › MCP Gateway › Tools → MCP Gateway

---

Schutzmechanismen

Der Digital Thread greift auf externe Systeme zu, hat aber keinen Weg, Anlagen zu steuern oder bestätigte Datensätze zu schreiben.

Mechanismus	Inhalt
Lesewerkzeuge	Werden bei der Abfrage aufgerufen; die zurückgegebenen Werte werden nicht gespeichert. Auch alle thread_-Chat-Werkzeuge sind schreibgeschützt
Aktionswerkzeuge (🔒)	Werkzeuge, die im externen System Entwürfe und Anforderungen erzeugen. Sie werden ohne menschliche Freigabe nicht aufgerufen — fehlen Freigebender, Freigabezeitpunkt, Begründung, Vorschlags-ID oder Idempotenzschlüssel, lehnt der Dienst ab
Admin-Konsole	Ruft Aktionswerkzeuge nicht auf (Anfragen werden mit 403 abgewiesen)
Copilot-Vorschlagsdetail	Freigeben und Entwurf erstellen — erfordert die Berechtigung «Freigabe — Entwurf aus Vorschlagskarte» (im Standardpaket nur Administratoren) sowie zwingend eine Begründung. Möglich nur, wenn ein aktiver Konnektor diese Aktion bereitstellt. Das Ergebnis bleibt als „Entwurf erstellt“ auf der Karte stehen; bestätigt wird im Zielsystem durch einen Menschen
Chat-Aktionskarte (2026.10)	Erscheint, wenn eine Antwort von thread_explain_recovery einen Mahnungsentwurf vorschlägt oder eine Antwort von insight_list_findings einen offenen Störungsrisiko-Fund enthält. Freigeben und ausführen erfordert eine Begründung; wer freigeben darf, bestimmt die Arbeitsrolle — SCM-Mahnungsentwürfe der Werkleiter, MES-Instandhaltungsanforderungsentwürfe Schichtführer · Instandhaltung · Werkleiter, Administratoren immer. Die fragende Person kann ihre eigene Karte nicht freigeben (Vier-Augen-Prinzip). Instandhaltungsanforderungsentwürfe im Vorschlagsdetail gibt nur der Administrator frei (Standardpaket). Die Instandhaltungsanforderungskarte erscheint nur, wenn der MES-Konnektor mes_create_maintenance_request bereitstellt. Karten sehen nur die Eigentümer der Konversation
Wiederholte Anfrage	Kommt dieselbe Anfrage mit demselben Idempotenzschlüssel erneut, wird der Konnektor nicht erneut aufgerufen, sondern der zuerst erzeugte Entwurf zurückgegeben

Die einzige Stelle zur Registrierung externer Konnektoren ist die Integrationskarte

Externe Systemkonnektoren werden nur hier in der Integrationskarte registriert. Die alte Ansicht Werkzeugserver (MCP) des Copilot ist mit 2026.10 Re-Release (2026-10-20) entfallen, und die dort verbliebenen alten Registrierungen werden mit dieser Version gelöscht. Auch wenn man sie als externen Server an das MCP Gateway anbindet, lassen sich die Konnektorwerkzeuge (mes_ · erp_ …) nicht aktivieren. Hatten Sie in älteren Versionen Konnektoren im Copilot registriert, notieren Sie Endpunkt und Headername, registrieren Sie sie hier erneut und geben Sie den Auth-Wert neu ein → MCP-Werkzeugkarte

---

Wenn Probleme auftreten

Symptom	Ursache und Abhilfe
Integrationskarte meldet „Konnektorverzeichnis nicht verfügbar: 503 … config_error“	Der Verzeichnisspeicher (PG) oder der Verschlüsselungsschlüssel (PI_DT_SECRET_KEY) ist leer. Die Spiegelansicht läuft davon unabhängig
„Aktivieren“ funktioniert nicht	Die Konformitätsprüfung wurde nicht ausgeführt oder ist fehlgeschlagen, oder danach haben sich Endpunkt, Zugangsdaten oder Werkzeuge geändert — erneut prüfen
Authentifizierungsfehler bei der Registrierung	Konnektor-Token oder Headername sind falsch
Fehler „gespeicherte Zugangsdaten nicht entschlüsselbar“	Der versiegelnde Schlüssel liegt weder im aktuellen noch im vorherigen Schlüssel (PI_DT_SECRET_KEY_PREVIOUS). Tragen Sie den alten Schlüssel als vorherigen Schlüssel ein und starten Sie neu, oder geben Sie die Zugangsdaten erneut ein
Bewertung des Graphspiegels ist „fehlgeschlagen“	Ergebnisse je Schritt und Service-Logs prüfen — bin/logs.sh plantpulse-digital-thread-api
Nach der Synchronisation heißt es, die Anlage sei nicht im Spiegel	Die vom Konnektor zugeordnete Anlagen-ID existiert nicht im Platform-Stammverzeichnis. Prüfen, ob die Projektion lief und ob die Anlagenzuordnungstabelle des Konnektors stimmt
Feldbindung geändert, der Spiegel bleibt unverändert	Die nächste periodische Synchronisation steht noch aus — Jetzt synchronisieren im Seitenfenster klicken. Installationen mit DT_CONNECTOR_SYNC_ENABLED=false synchronisieren ausschließlich darüber
In der Quelle verschwundene Verbindungen bleiben im Spiegel «offen»	Bei der Synchronisation war die Liste abgeschnitten und das Schließen wurde übersprungen (gelbe Zeile „Die Erfassung war abgeschnitten“, prune_skipped in der Antwort) — bei einer vollständig gelesenen Synchronisation werden sie geschlossen. Bei anhaltendem Abschneiden Paginierung und Limits des Konnektors prüfen
Nach ERP-Versionsanhebung ist der ERP-Konnektor deaktiviert	Ändert sich die deklarierte Version, wird bei der Werkzeugerkennung deaktiviert — Konformitätsprüfung → Aktivieren erneut durchführen
Kundenauftrag in heutigen Arbeiten / Wiederanlaufplan ist «unbekannt»	Der ERP-Konnektor liefert erp_list_sales_orders von erp-mcp/0.3 nicht oder ist deaktiviert. Die Begründung steht in customer_orders_unknown_because
Unklar, ob die periodische Konnektor-Synchronisation läuft	connector_sync unter /health des Digital Thread — letztes Ergebnis je Konnektor und Liste failing
Wiederanlaufplan / Bereitschaft stoppt mit „veraltete Quelle“ (stale_inputs)	Die Daten eines Konnektors sind älter als die Aktualitätsgrenze. Über das Kennzeichen veraltet in der Ansicht Bereitschaftsquellen finden und prüfen, ob die Quelle hinter diesem Konnektor stehen geblieben ist
Wiederanlaufplan meldet „im MES nicht gefunden“ (unresolved_ids)	Die von PLM bzw. QM genannte Nummer existiert im MES unter anderer Nummer — Identität deklarieren
Bereitschaftsantwort voller UNKNOWN	Die Quellkonnektoren fehlen — in der Ansicht Bereitschaftsquellen die Familie der Positionen mit fehlt anbinden
Chat-Aktionskarte erscheint nicht	Der Administrator hat thread_explain_recovery deaktiviert, die Antwort enthält keine Entwurfsgrundlage (Bestellposition · Bedarfstermin) oder es gibt keinen aktiven Konnektor, der diese Aktion bereitstellt

---

Verwandte Dokumente

• AI-Admin-Konsole — Digital-Thread-Leiste und gemeinsame Menüs (Logs · API-Schlüssel · Einstellungen)
• Copilot-Admin-Konsole — Chat-Werkzeuge aktivieren und deaktivieren
• Digital Thread — was hinzukommt, wenn angebunden — wie Vor-Ort-Anwender über Fragen fragen
• Digital-Thread-Konnektoren — Werkzeuge je Familie · Einsatzstellen · Mindestversionen
• MCP-Werkzeugkarte — thread_-Werkzeuge
• Konfiguration — Schalter für die Zeichnungsindizierung (DRAWING_INGEST_ENABLED), Konnektor-Synchronisation · Aktualitätsgrenzen (DT_CONNECTOR_* · DT_LINK_HISTORY_DAYS)
• Benutzerberechtigungen und Arbeitsrollen — wer Aktionskarten freigeben darf
• Datenbankverwaltung — die beiden Neo4j und pi.dt