Digital-Thread-Konnektoren

Der Digital Thread bindet Kundensysteme wie MES, ERP und PLM über Konnektoren an und verknüpft so «was wann geschehen ist und womit es zusammenhängt». Diese Seite ordnet die Konnektoren nach Familien — welche Werkzeuge jede Familie liefern muss, wofür der Digital Thread sie nutzt und worauf zu achten ist. Wie Registrierung, Konformität und Aktivierung in der Oberfläche ablaufen, steht unter Digital Thread.

Diese Seite bezieht sich auf das Re-Release (2026-10-20) vom Oktober 2026

Ab Re-Release (2026-10-20) verwendet der Digital Thread keine Konnektoren mehr, die unter der nachstehenden Mindestversion liegen. Mit älteren Versionen angebundene Konnektoren müssen angehoben werden → Version anheben

Auf einen Blick — elf Familien

Familie	Anzeigename	Spezifikation · Mindestversion	Pflichtwerkzeuge	Aktionswerkzeuge (🔒)	Frischegrenze · Synchronisierung	Hauptsächliche Verwendung
mes	MES	mes-mcp/0.7	7	drei	2 Stunden · 1 Stunde	Auftragsbereitschaft · Heutige Aufträge · Wiederherstellungsplan · Timeline — Grundlage
scm	SCM	mes-mcp/0.7	5	zwei	24 Stunden · 12 Stunden	Materialbereitschaft · PO-Thread · Lieferwiederherstellung
sched	Feinplanung (APS)	mes-mcp/0.7	2	eins	2 Stunden · 1 Stunde	Referenzplan des Wiederherstellungsplans
erp	ERP	erp-mcp/0.4	2	keine	24 Stunden · 12 Stunden	Personen · Qualifikationen, PO · Wareneingang, Kundenaufträge, Fertigungsstückliste
plm	PLM	plm-mcp/0.2	3	keine	24 Stunden · 12 Stunden	Konstruktionsänderungen · Versionsprüfung · Stücklistenabgleich
qm	Qualität	qm-mcp/0.2	3	keine	24 Stunden · 12 Stunden	Qualitätsbereitschaft · Verzug durch Abweichungen
cmms	Instandhaltung (CMMS)	cmms-mcp/0.2	2	keine	4 Stunden · 2 Stunden	Anlagenbereitschaft · Wiederherstellung von Wartungsfenstern
tool	Werkzeugverwaltung	tool-mcp/0.2	2 + Funktionen	keine	24 Stunden · 12 Stunden	Werkzeug-Inspektion · Werkzeugbereitschaft
wms	Lager (WMS)	wms-mcp/0.2	3	keine	2 Stunden · 1 Stunde	Bestand verspäteter Teile
lims	Labor (LIMS)	lims-mcp/0.2	2	keine	12 Stunden · 6 Stunden	Prüfergebnisse je Los · Fehlschlagereignisse
ehs	Sicherheit (EHS)	ehs-mcp/0.3	2 + Funktionen	keine	1 Stunde · 30 Minuten	Bereitschaft der Arbeitsfreigabe · Isolationsfenster

• scm und sched sind weitere Familien desselben Spezifikationsstrangs (mes-mcp) wie MES. Alle übrigen haben je eine eigene Spezifikation.
• MES ist die Grundlage. Ohne MES gilt die gesamte Bewertung der Auftragsbereitschaft als «nicht angebunden»; mit den anderen Familien allein ergibt sich keine Antwort.
• Aktionswerkzeuge gibt es nur im Strang mes-mcp (MES · SCM · Feinplanung). Die übrigen acht Familien sind nur lesend.

---

Für alle Konnektoren geltende Regeln

Im Spiegel liegen nur «Schlüssel»

Der Digital Thread legt das aus Konnektoren Gelesene im Spiegel des Werksgraphen nur als Schlüssel und Verbindungen ab — «Fertigungsauftrag WO-1 läuft auf Anlage M-3». Werte wie Bezeichnung, Menge, Datum oder Status werden nicht gespeichert; sie werden bei einer Anfrage erneut über die Lesewerkzeuge des Konnektors geholt. Fällt ein Konnektor aus, fehlen in der Antwort daher die Werte; ändert sich ein Wert im Quellsystem, erscheint er ab der nächsten Anfrage sofort geändert.

Antwortregeln der Werkzeuge (Spezifikation 0.2)

Regel	Wert
Größe einer Antwort	höchstens 16.000 Zeichen
Seitengröße	limit 1 – 200 (Standard 50), Folgeseite über cursor
Zeitfenster	maximal 31 Tage. Ausnahme — Liefertreue von Lieferanten, Instandhaltungshistorie von Anlagen und Kalibrierdatensätze: 366 Tage
Fehlercodes	invalid_argument · not_found · unauthorized · rate_limited · unavailable · conflict
Kennzeichnung «unbekannt»	unknown_fields in der Zeile, partial (nur teilweise gelesen) · unreadable (nicht gelesene Zeilen) in der Antwort. Unbekannte Werte nicht raten, sondern als null ausgeben
Zeitangaben	ISO 8601 mit Zeitzonen-Offset. Zeitangaben ohne Offset gelten als «unbekannt»

• Ein Aufruf ohne Bedingungen («gib alles») muss mit invalid_argument abgelehnt werden — die Konformitätsprüfung achtet darauf.
• Eine Abfrage mit unbekannter Anlagen-ID muss not_found liefern, nicht eine leere Liste.

Synchronisierung und Frische

• Der Digital Thread synchronisiert jeden Konnektor im Abstand der halben Frischegrenze seiner Familie (mindestens 5 Minuten, siehe Tabelle oben). Mit DT_CONNECTOR_SYNC_INTERVAL_S gilt dieses Intervall für alle Konnektoren. Die erste Synchronisierung läuft 2 Minuten nach dem Start.
• Je Durchlauf wird das Fenster jetzt ±15 Tage gelesen. Verbindungen, die in diesem Fenster nicht auftauchen, werden nicht gelöscht, sondern geschlossen (sie bleiben in der Verbindungshistorie, standardmäßig 180 Tage). Protokollverbindungen wie Rückmeldungen, Genealogie oder Prüfungen werden nicht geschlossen.
• War die Antwort abgeschnitten (truncated) oder nur teilweise lesbar (partial), wird in diesem Durchlauf keine Verbindung geschlossen.
• Liegt die letzte Synchronisierung länger zurück als die Frischegrenze, rechnet der Wiederherstellungsplan mit diesen Daten keine Zahlen, sondern weist sie als «veraltete Eingabe» aus. Die Grenze lässt sich je Familie über DT_CONNECTOR_MAX_AGE ändern.
• Familien mit Ereigniswerkzeug legen nach der Synchronisierung Ereignisse als Timeline-Referenz ab (ohne Inhalt). Mehrfaches Lesen desselben Ereignisses erzeugt keine Dubletten; je Durchlauf sind es bis zu 5.000 Einträge.

Aufrufgrenzen

Deklariert ein Konnektor capabilities.limits.rate_limit_per_min, ruft der Digital Thread nur innerhalb dieser Grenze auf. Unbeaufsichtigte Aufrufe wie Synchronisierung oder Konformitätsprüfung nutzen höchstens 80 % der Grenze (maximal 10 Minuten Wartezeit), dialogorientierte Aufrufe wie im Chat warten höchstens 20 Sekunden. Liefert der Konnektor Retry-After, wird dies bis zu einer Stunde beachtet. Ohne Deklaration erfolgt keine Warteschlange.

Vor-Ort (Standort) muss zum MES passen

Ein Konnektor wird genau einem Vor-Ort-Standort zugeordnet. Familien mit einem anderen Standort als dem MES des betreffenden Werks fallen aus der Bewertung heraus, und in der Antwort bleibt site_mismatch:<Familie> stehen (einzige Ausnahme PLM — Konstruktionsdaten sind werksübergreifend). 🔴 Wird ein konzernweites ERP am Standort der Zentrale registriert, fällt ERP aus der Bewertung des betreffenden Werks heraus. Registrieren Sie es je Werk mit demselben Standort wie das dortige MES.

Direkt ins Quellsystem springen (Deeplinks)

Hinterlegen Sie je Konnektor eine Linkvorlage (links — base_url · label · allow_http · templates), erhalten die Objekte in Verbindungs- · Timeline- · Wirkungsbereichs- · Knotendetail-Antworten open_url · open_label, und im Belegpanel des Copilot erscheint eine Schaltfläche wie «In SAP öffnen». Der Schaltflächentext ist label (leer: Konnektorname). Als Platzhalter sind nur {base} · {key} · {key.1} – {key.9} zulässig, standardmäßig nur https (bei allow_http: true auch http), und der resultierende Host muss mit dem Host von base_url übereinstimmen. Eine Änderung der Linkvorlage lässt Konformität und Aktivierungsstatus unberührt. Ohne Vorlage entfällt die Linkspalte vollständig. Wie man sie in der Konsole einträgt (Integrationskarte › Seitenfenster des Konnektors › External links), steht unter Digital Thread — Externe Links.

Knotendetail — bei jedem Klick aufgerufene Lesewerkzeuge

Klickt man im Belegpanel des Copilot auf einen Knoten (aktueller Wert im Ursprungssystem), ruft der Digital Thread beim Konnektor der führenden Familie dieser Art das unten stehende Werkzeug einmal auf. Die Werte werden weder im Spiegel noch im Dienst gespeichert; übernommen werden nur die je Art festgelegten Felder (Namen · Personalnummern · Kontaktdaten von Personen werden nicht übernommen). Dauert ein Aufruf länger als 15 Sekunden, erscheint «Keine Antwort vom Ursprungssystem».

Art	Familie	Aufgerufenes Werkzeug
PO-Zeile	ERP	erp_list_purchase_orders
Kundenauftragszeile	ERP	erp_list_sales_orders
Arbeitsauftrag · Arbeitsgang	MES	mes_get_work_order (Arbeitsgang über den übergeordneten Arbeitsauftrag)
Teilenummer	PLM	plm_get_bom
Lieferant	SCM	scm_get_supplier_delivery_performance (letzte 90 Tage)

• Prüfungen · Nichtkonformitäten (QM) und Instandhaltungsaufträge (CMMS) sind «Unbekannt», da die Spezifikation kein Lesen einzelner Datensätze vorsieht — die Listenwerkzeuge nehmen nur ein Zeitfenster entgegen und können nicht nach Nummer filtern.
• Die Reihenfolge der Konnektorauswahl entspricht der bei Links — unter den aktiven Konnektoren der führenden Familie mit passender Version derselbe Standort wie der Knoten (PLM vom Standortabgleich befreit) → Primärkonnektor → zuerst registrierter.

Version anheben — unterhalb der Mindestversion wird nicht verwendet

• Konnektoren, die eine Version unterhalb der Mindestversion aus der Tabelle oben deklarieren, werden von der Synchronisierung abgewiesen (409 connector_outdated) und gelten in Bewertung und Wiederherstellungsplan als «nicht angebunden». In der Antwort erscheint connector_outdated:<Familie> unter «Fehlendes», in der Registrierung sind spec_status: outdated und die Zielversion (upgrade_to) sichtbar.
• Nach dem Anheben auf eine neue Version durchlaufen Sie erneut Werkzeugermittlung → Konformitätsprüfung → Aktivierung → Synchronisierung. Bei einem Versionswechsel wird der Konnektor bei der Werkzeugermittlung deaktiviert und das Konformitätsergebnis gelöscht.
• Bei mehreren Konnektoren führt bin/reregister-connectors.sh diese Schritte je Konnektor stellvertretend aus (MES zuerst, danach SCM · Feinplanung · ERP). Mit --dry-run sehen Sie das Ergebnis vorab.

Konformitätsprüfung extern ausführen

Konnektorentwickler können dieselbe Prüfung auch ohne Digital Thread ausführen.

python -m app.connectors.conformance_cli <Konnektor-MCP-URL> --family <Familie>

Ein Prüflauf muss innerhalb von 15 Minuten abgeschlossen sein (Wartezeiten aufgrund von Aufrufgrenzen zählen nicht mit). Vorübergehende Unterbrechungen ändern das Ergebnis nicht; nur bestätigte Fehlschläge werden protokolliert und deaktivieren den Konnektor.

---

MES — Fertigungsaufträge · Arbeitsgänge · Rückmeldungen

Spezifikation mes-mcp 0.7 · Familie mes · Frischegrenze 2 Stunden (Synchronisierung stündlich) · Grundlage des Digital Thread

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
mes_capabilities	✅	Deklaration von Version · Standort · Grenzen	—
mes_list_equipment	✅	Zuordnungstabelle MES-Anlage ↔ Plattform-Asset (asset_id), Anlagenhierarchie	asset_id · equipment_id
mes_list_work_orders	✅	Fertigungsaufträge je Anlage und Zeitraum — Status · Artikel · Menge · Plan-/Istzeiten · Termin · Meilensteine · Auftragsprojekt (0.4) · Kundenauftragsposition (0.7)	asset_id oder from · to, status, due_before
mes_get_work_order	✅	Arbeitsgänge und Stücklistenpositionen eines Fertigungsauftrags	work_order_id
mes_list_production_results	✅	Produktionsrückmeldungen — Gutteile · Ausschuss · Verschrottung, Lose · Seriennummern	from · to
mes_list_downtime_events	✅	Stillstände und Gründe	from · to
mes_events	✅	Ereignisumschlag — wird in die Timeline übernommen	from · to, types
mes_get_genealogy	optional	Genealogie von Losen · Seriennummern (bis zu 3 Stufen vor- und rückwärts)	direction
mes_get_precedence	optional	Graph der Vorgänger-/Nachfolgerbeziehungen von Arbeitsgängen samt Puffer	direction, depth 1–5
mes_list_maintenance_history · mes_list_nonconformances · mes_list_personnel	optional	Instandhaltungshistorie · Abweichungen · Personen und Qualifikationen — Ersatzquelle, wenn CMMS · QM · ERP fehlen	Zeitraum
mes_get_operation_requirements	optional	Je Arbeitsgang verfügbare Anlagen · erforderliche Qualifikationen · Rüstgruppen	work_order_id
mes_list_calendars · mes_list_maintenance_windows · mes_get_power_limit	optional	Kalender für Anlagen · Personen (inkl. Rüstwechsel), geplante Wartungsfenster, Gleichzeitigkeitsgrenze der Leistung vor Ort — Ressourcenrestriktionen des Wiederherstellungsplans	Zeitraum
mes_get_mbom	optional	Fertigungsstückliste — wenn MES/MPM führend ist (0.6)	material_id

🔒 Aktionswerkzeuge — werden nur nach Freigabe durch eine Person über die Vorschlagskarte des Copiloten aufgerufen. Sie erzeugen im Quellsystem lediglich «Entwürfe · Anforderungen»; die Bestätigung erfolgt dort durch eine Person.

Werkzeug	Erzeugt
mes_create_work_order_draft	Entwurf eines Fertigungsauftrags (Artikel · Menge · Anlage · Start · Termin)
mes_create_hold_request	Anforderung zum Sperren / Entsperren von Fertigungsauftrag · Los · Seriennummer
mes_create_maintenance_request	Instandhaltungsanforderung (Anlage · Priorität · Fehlercode · Belegverweis)

• Im Spiegel abgelegt — Anlage → Plattform-Anlage · übergeordnete Anlage, Fertigungsauftrag → Anlage · Meilenstein · Projekt · Kundenauftragsposition, Arbeitsgang → Fertigungsauftrag · Anlage · erforderliche Qualifikation, Stücklistenposition → Teilenummer, Vorgänger/Nachfolger, Rückmeldelos → Anlage · Fertigungsauftrag, Genealogie, Fertigungsstückliste. Mengen, Zeiten, Kalender, Wartungsfenster, Leistung und Stillstandsgründe werden erst bei der Anfrage gelesen.

Wofür es verwendet wird

Funktion	Verwendung
Auftragsbereitschaft	Fertigungsaufträge und Arbeitsgänge bilden das Gerüst der Bewertung. Ohne sie gilt die gesamte Bewertung als «nicht angebunden». Fehlen die Arbeitsgangsanforderungen, ist die Position Personal «unbekannt»
Heutige Aufträge (thread_today_work)	Heute geplante Arbeitsgänge und Anlagenzustand
Wiederherstellungsplan (thread_explain_recovery)	Fertigungsaufträge · Vorgänger/Nachfolger · Ressourcen (Kalender · Wartungsfenster · Leistung) · Fertigungsstückliste
Timeline · Auswirkungsbereich	mes_events und Genealogie

Häufige Stolpersteine bei der Konformität

Zyklen in der Elternkette der Anlagen führen zum Fehlschlag. Liefert ein Fertigungsauftrag wbs_parent_id, muss auch project geliefert werden. Pflicht-Lesewerkzeuge müssen unter 2 Sekunden p95 liegen.

---

SCM — Beschaffung · Wareneingang · Lieferanten

Spezifikation mes-mcp 0.7 · Familie scm · Frischegrenze 24 Stunden (Synchronisierung alle 12 Stunden)

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
scm_capabilities	✅	Deklaration von Version · Standort · Grenzen	—
scm_list_supply_lines	✅	Offene Beschaffungs- · Lieferpositionen — Bestellung · Wareneingang · offene Menge, Wunsch- · Zusage- · Bestätigungstermin, verknüpfte Fertigungs- und Kundenaufträge	eines von Teilenummer · Fertigungsauftrag · Lieferant
scm_list_inbound_shipments	✅	Lieferavis (ASN) — voraussichtliche Ankunft · Transportstatus	from · to
scm_list_goods_receipts	✅	Wareneingang und Prüfstatus	from · to
scm_get_work_order_shortage	✅	Fehlteile eines Fertigungsauftrags — je Teilenummer Bedarf · Verfügbarkeit · erwarteter Wareneingang · Fehlmenge, nächster Ankunftstermin	work_order_id
scm_events	optional	Ereignisumschlag	from · to
scm_get_supplier_delivery_performance	optional	Liefertreuequote der Lieferanten · mittlerer / p90-Verzug (max. 366 Tage)	supplier_id
scm_list_alternates	optional	Alternativteile · Alternativlieferanten	material_id
scm_list_incoming_inspections · scm_list_supplier_nonconformances	optional	Ergebnisse der Wareneingangsprüfung · Abweichungen bei Lieferantenteilen	Zeitraum
scm_list_supplier_capacity	optional	Lieferfähigkeit von Lieferanten (Transporttage · Kapazität je Zeitraum)	Lieferant oder Teilenummer

🔒 Aktionswerkzeuge

Werkzeug	Erzeugt
scm_create_expedite_request_draft	Entwurf einer Terminvorzugsanfrage (PO-Position · Bedarfstermin) — der Einkauf versendet sie im Quellsystem
scm_create_supplier_inquiry_draft	Entwurf einer Lieferantenanfrage (Termin · Qualität, bis 1.000 Zeichen)

• Im Spiegel abgelegt — PO-Position → Lieferant · Teilenummer · verknüpfter Fertigungsauftrag · Kundenauftragsposition, Wareneingangslos → Lieferant. Lieferpositionen werden auf die in Lieferavis und Wareneingang genannten Lieferanten eingegrenzt gelesen (da die SCM-Spezifikation Massenabfragen untersagt).

Wofür es verwendet wird — Materialbereitschaft (Fehlteile), PO-Thread, Wiederherstellungsplan (Fehlteile · Lieferavis · Lieferfähigkeit — ohne Lieferfähigkeit antwortet der Beschaffungsteil nur mit «Auswirkung»), PO-Spalte in den heutigen Aufträgen.

---

Feinplanung (APS) — veröffentlichter Plan

Spezifikation mes-mcp 0.7 · Familie sched · Frischegrenze 2 Stunden (Synchronisierung stündlich)

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
sched_capabilities	✅	Deklaration von Version · Standort	—
sched_events	✅	Ereignisse zu Meilensteinen · Änderungen von Plandaten	from · to
sched_list_planned_operations	optional	Arbeitsgangtermine des veröffentlichten Plans — Planversion · Anlage · Planzeit · Rüsten · Einfrieren · Reihenfolge	from · to
sched_get_resource_calendars	optional	Schichten und geplante Stillstände je Anlage	from · to
sched_list_scenarios	optional	Liste der Szenarien (What-if-Pläne) samt KPI	status

🔒 Aktionswerkzeug — sched_create_scenario_draft: erzeugt die Arbeitsgangverschiebungen des Wiederherstellungsplans (max. 200) als Szenarioentwurf im APS. Es veröffentlicht keinen Plan — Bewertung und Veröffentlichung erfolgen durch eine Person im APS.

Dient als Referenzplan des Wiederherstellungsplans. Gelesen wird der veröffentlichte Plan von gestern bis 15 Tage voraus; damit werden die Planzeiten der Vorgänger-/Nachfolgerbeziehungen durch die APS-Werte überschrieben. Abgeschlossene oder laufende Arbeitsgänge werden nicht überschrieben (Ist schlägt Plan). Eingefrorene Arbeitsgänge werden auf ihre Zeit fixiert; kann ein Arbeitsgang wegen verspäteter Vorgänger nicht zu dieser Zeit starten, wird er nicht fixiert, sondern unter «Annahmen» vermerkt. Ohne APS ist die Auftragszuordnung des MES die Referenz, und in der Antwort erscheint unter «Nicht berücksichtigt» der Hinweis «APS-Plan unbekannt».

---

ERP — Personen · Beschaffung · Kundenaufträge · Fertigungsstückliste

Spezifikation erp-mcp 0.4 · Familie erp · Frischegrenze 24 Stunden (Synchronisierung alle 12 Stunden) · nur lesend

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
erp_capabilities	✅	Deklaration von Version · Standort	—
erp_list_personnel	✅	Personen (pseudonyme ID) · Qualifikationen · Zuordnungen	on_date, qualification_code
erp_list_availability	optional	Verfügbarkeitsfenster von Personen — Arbeitszeit · Urlaub · Überstunden	from · to
erp_get_mbom	optional	Fertigungsstückliste — wenn ERP führend ist	material_id
erp_list_purchase_orders	optional	Positionen von Materialbestellungen (standardmäßig offene) — verknüpfte Arbeitsgänge · Kundenauftragspositionen	leer = alle offenen Positionen
erp_list_goods_receipts	optional	Wareneingang	from · to
erp_list_sales_orders	optional	Kundenauftragspositionen — Kunde · Kunden-PO · Vertragstermin · Bestätigungstermin · Vertragsstrafe · verknüpftes Projekt · Meilenstein · Fertigungsauftrag	leer = alle offenen Positionen

• Personen gelangen ausschließlich als pseudonyme ID in den Spiegel. Namen und Gültigkeitsfristen von Qualifikationen werden erst bei der Anfrage gelesen.
• Im Spiegel abgelegt — Person → Qualifikation · zugeordneter Fertigungsauftrag · Arbeitsgang, PO-Position → Lieferant · Teilenummer · Fertigungsauftrag · Kundenauftragsposition, Kundenauftragsposition → Kunde, Projekt · Meilenstein · Fertigungsauftrag → Kundenauftragsposition, Fertigungsstückliste. Nennen ERP und SCM dieselbe PO-Positionsnummer, ist es im Spiegel dieselbe Position.

Wenn ERP und SCM gemeinsam vorliegen — beim Termin gilt der Lieferanten-Bestätigungstermin aus SCM, sofern vorhanden, sonst der aus ERP. Bei Status und offener Menge ist ERP führend; verknüpfte Fertigungsaufträge werden aus beiden Quellen zusammengeführt. Weichen Werte voneinander ab, werden beide unter «Abweichungen» in der Antwort ausgewiesen.

Wofür es verwendet wird

Funktion	Verwendung
Auftragsbereitschaft — Personal · Material	Personal zuerst aus ERP (sonst MES). Auch ohne SCM wird Material anhand offener und verknüpfter Positionen der ERP-Bestellungen bewertet
Auftragskontext	Je Arbeitsgang der erfüllte Kundenauftrag und die Pufferzeit
Wiederherstellungsplan	Personalressourcen · PO · Pufferzeit der Kundenaufträge
Stücklistenabgleich	Zuerst die ERP-Fertigungsstückliste (sonst MES)

Häufige Stolpersteine bei der Konformität

Liefert eine Kundenauftragsposition keinerlei Schlüssel für Projekt, Meilenstein oder Fertigungsauftrag, ist das kein Fehlschlag, sondern eine Information (sie ist lediglich nicht mit der Werksarbeit verknüpft). Doppelte Auftragspositionsnummern sind ein Fehlschlag.

---

PLM — Konstruktionsänderungen und Stückliste

Spezifikation plm-mcp 0.2 · Familie plm · Frischegrenze 24 Stunden (Synchronisierung alle 12 Stunden) · durchgehend nur lesend

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
plm_capabilities	✅	Deklaration von Version · Standort · Funktionen	—
plm_list_change_orders	✅	Konstruktionsänderungsaufträge (ECO · ECN) — Status · betroffene Teilenummern und Versionen · Bestandsbehandlung · Wirksamkeit · Zeitpunkt, ab dem die neue Version verwendbar ist	from · to (bezogen auf den Änderungszeitpunkt, Pflicht), material_id, status[]
plm_get_bom	✅	Konstruktionsstückliste einer Teileversion — Unterteile (lines) und Verwendungsstellen (where_used)	material_id (Pflicht), revision (leer = aktuelle released-Version). Ab 0.2 mit Seitenaufteilung (limit max. 200)
plm_list_documents	optional	Dokument- und Zeichnungsmetadaten zu einer Teilenummer (Name · Art · Version · Status · Öffnen-Link). Dateiinhalte werden nicht geliefert	material_id (Pflicht), revision

• Status der Änderungsaufträge: draft · in_review · approved · released · design_released (0.2) · implemented · cancelled, Bestandsbehandlung: pending · use_as_is · rework · scrap · none, Wirksamkeit: immediate · date · unit · serial.
• Im Spiegel abgelegt — ausschließlich Schlüssel und Verbindungen von Änderungsauftrag, Teilenummer und Dokument (Auftrag → Teilenummer, Unterteil → Oberteil, Dokument → Teilenummer). Die Stückliste wird von der geänderten Teilenummer bis zu 4 Stufen nach oben durchlaufen. Status, Daten, Dokumentnamen und Links werden nicht abgelegt, sondern erst bei der Anfrage gelesen.
• Timeline-Ereignisse — Änderungsauftrag geändert · freigegeben · Status geändert (0.2). Sie hängen an den betroffenen Teilenummern.

Wofür es verwendet wird

Funktion	Verwendung
Wiederherstellungsplan (thread_explain_recovery)	Von den Änderungsaufträgen der letzten 30 Tage bis morgen wirken nur genehmigte und freigegebene als Restriktion. Bei Bestandsbehandlung use_as_is erfolgt keine Sperre; bei rework · scrap · none wird das Teil bis zum «Zeitpunkt, ab dem die neue Version verwendbar ist» gesperrt. design_released wird nur angezeigt und sperrt nicht
Auftragsbereitschaft — Position Zeichnung	Lassen sich Änderungsaufträge nicht lesen, ist diese Position «unbekannt»; ohne Stückliste verengt sich der Bewertungsumfang
Versionsprüfung (thread_part_revision_status)	Betrachtet die aktuelle released-Version und offene Änderungen (93 Tage) und antwortet mit current · outdated · change_open · unknown
Stücklistenabgleich · Auswirkungsbereich	Vergleicht die Konstruktionsstückliste mit Fertigungsstückliste und Rückmeldungen → oben Fertigungsstückliste

Häufige Stolpersteine bei der Konformität

Wird in einer Stücklistenantwort mit truncated: true zugleich next_cursor geliefert, ist das ein Fehlschlag. open_url eines Dokuments muss ein http(s)-Link sein (data: unzulässig).

---

QM — Prüfungen und Abweichungen

Spezifikation qm-mcp 0.2 · Familie qm · Frischegrenze 24 Stunden (Synchronisierung alle 12 Stunden) · durchgehend nur lesend

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
qm_capabilities	✅	Deklaration von Version · Standort	—
qm_list_inspections	✅	Prüflose — Wareneingangs-, Prozess- und Endprüfung, Ergebnis (passed · failed · conditional · pending), verknüpfte Abweichungsnummern	from · to (Pflicht), material_id · lot_id · work_order_id
qm_list_nonconformances	✅	Abweichungen (NCR) — Fehler · Menge · Entscheid (Nacharbeit · Verschrottung · Rücksendung …) · Nacharbeitsplan · geplanter Zeitpunkt des Ersatzteils	from · to (Entdeckungszeitpunkt, Pflicht), Teilenummer · Los · Fertigungsauftrag · Lieferant · status[]

• Im Spiegel abgelegt — Schlüssel und Verbindungen von NCR und Prüfung: NCR → Teilenummer · Los · Seriennummer, NCR → gesperrter Fertigungsauftrag · Arbeitsgang, Los → Prüfung, Los → Lieferant.
• Timeline-Ereignisse — Abweichung aufgetreten · Nacharbeit abgeschlossen, Prüfung bestanden · nicht bestanden · bedingt (pending ist kein Ereignis).

Wofür es verwendet wird

Funktion	Verwendung
Wiederherstellungsplan	Bei Entscheid Nacharbeit oder Reparatur Sperre bis zum Ende des Nacharbeitsplans, bei Verschrottung oder Rücksendung bis zum geplanten Zeitpunkt des Ersatzteils. Fehlt der Zeitpunkt, wird keine Zahl ermittelt, sondern «unbekannt» ausgewiesen
Auftragsbereitschaft — Position Qualität	Zuerst QM, sonst die Abweichungen aus dem MES (mes_list_nonconformances)
Werkzeug-Inspektion (thread_check_tooling)	Wird bei der Suche nach Ursachenkandidaten für Abweichungen mitgelesen

---

CMMS — Instandhaltung

Spezifikation cmms-mcp 0.2 · Familie cmms · Frischegrenze 4 Stunden (Synchronisierung alle 2 Stunden) · durchgehend nur lesend

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
cmms_capabilities	✅	Deklaration von Version · Standort	—
cmms_list_work_orders	✅	Instandhaltungsaufträge — Art (vorbeugend · Störungsbehebung · vorausschauend · Inspektion · Kalibrierung) · 7 Statusstufen · Plan-/Istzeiten · Anlagenstillstand ja/nein · verwendete Ersatzteile · wartende Fertigungsaufträge	from · to (Pflicht), equipment_id · asset_id · type[] · status[] · open_only
cmms_list_pm_schedules	optional	Fenster, in denen die vorbeugende Instandhaltung die Anlage stilllegt — Dauer · frühester Start · spätestes Ende · verschiebbar (movable)	from · to (Pflicht), Anlage
cmms_get_asset_history	optional	Zusammenfassung der Instandhaltungshistorie einer Anlage (Anzahl · Störungen · MTBF · MTTR · Stillstandszeit)	from · to (max. 366 Tage), Anlage

• Im Spiegel abgelegt — Nummern und Verbindungen der Instandhaltungsaufträge: Instandhaltung → Anlage (bei vorhandener Plattform-Asset-ID direkt an die Plattform-Anlage), Instandhaltung → Ersatzteil, Instandhaltung → wartender Fertigungsauftrag. Neben den Aufträgen innerhalb des Fensters werden auch solche gelesen, die davor begonnen haben und noch offen sind.
• Timeline-Ereignisse — Instandhaltung angefordert · begonnen · beendet, vorbeugende Instandhaltung geplant. Aufträge ganz ohne Zeitangabe bleiben ohne Ereignis als «ohne Zeitangabe» stehen.

Wofür es verwendet wird

Funktion	Verwendung
Wiederherstellungsplan	Gelesen werden Fenster der vorbeugenden Instandhaltung und offene Aufträge von gestern bis 15 Tage voraus. Nicht abgeschlossene Störungsbehebungen sperren die Anlage bis zum voraussichtlichen Ende, nicht verschiebbare vorbeugende Instandhaltung ebenfalls. Verschiebbare vorbeugende Instandhaltung verlagert die Optimierung innerhalb des Plans. Ohne CMMS erscheint der Instandhaltungsplan in der Antwort unter «Nicht berücksichtigt»
Auftragsbereitschaft — Position Anlage	Fehlen Wartungsfenster und Aufträge beide, gilt «unbekannt»
Abgleich mit Sicherheit (EHS)	Vergleicht Instandhaltungsaufträge mit Arbeitsfreigaben und Isolationen
Label für Anomaliefälle	Abgeschlossene Störungsbehebungsaufträge liefern Labels für Anomaliefälle (DT_WO_LABELS_ENABLED)

• Liegt dasselbe Wartungsfenster auch im MES vor, gewinnt das CMMS.

---

TOOL — Werkzeuge · Vorrichtungen · Messmittel

Spezifikation tool-mcp 0.2 · Familie tool · Frischegrenze 24 Stunden (Synchronisierung alle 12 Stunden) · durchgehend nur lesend

Werkzeugverwaltungssysteme leisten sehr Unterschiedliches; deshalb deklariert der Konnektor Funktionen und liefert nur die Werkzeuge dieser Funktionen. Ein System, das nur kalibriert, darf allein calibration deklarieren.

Funktion	Gelieferte Werkzeuge	Im Bestandsverzeichnis gefüllte Spalten
inventory	(nur Verzeichnis)	Menge
issue_return	tool_list_issues — Ausgabe · Rückgabe (wer · für welchen Fertigungsauftrag · Arbeitsgang · Prüfung · Los)	—
calibration	tool_list_calibrations — Kalibrierdatensätze (Beurteilung vor und nach der Kalibrierung, maximale Abweichung, nächste Fälligkeit). Max. 366 Tage	Kalibrierung
tool_life	tool_list_life_events — Nachschärfen · Austausch · Standzeitende · Standzeitwarnung	Standzeit
presetting	tool_list_requirements — Liste der für Fertigungsauftrag · Arbeitsgang benötigten Werkzeuge	Voreinstellung

• Immer zu liefern sind tool_capabilities und tool_list_tools (Bestandsverzeichnis für Werkzeuge · Vorrichtungen · Messmittel — Status available · issued · in_calibration · out_of_tolerance · quarantined · worn_out · retired). Das Ereigniswerkzeug tool_events ist unabhängig von den Funktionen optional.
• 🔴 Von einer deklarierten Funktion müssen alle Werkzeuge geliefert werden, Werkzeuge nicht deklarierter Funktionen dürfen nicht geliefert werden, und die zugehörigen Verzeichnisspalten müssen leer bleiben — die Konformitätsprüfung achtet darauf.
• Im Spiegel abgelegt — Werkzeugschlüssel und Verbindungen: Werkzeug → aufgenommene Anlage, Fertigungsauftrag · Arbeitsgang · Prüfung · Los · Seriennummer → tatsächlich verwendetes Werkzeug. Werte zu Standzeit, Kalibrierung und Menge werden nicht abgelegt.
• Timeline-Ereignisse — Ausgabe · Rückgabe · Kalibrierung bestanden/nicht bestanden · Standzeitende · Austausch. Fehlt tool_events, werden aus den Kalibrierdatensätzen nur Kalibrierereignisse gebildet.

Wofür es verwendet wird

Funktion	Verwendung
Werkzeug-Inspektion (thread_check_tooling)	Beantwortet drei Punkte — fragwürdige Messungen (mit einem Messmittel gemessen, dessen Kalibrierfrist abgelaufen war, oder das nach der Verwendung die Kalibrierung nicht bestand), tatsächlich verwendete Werkzeuge und Ursachenkandidaten für Abweichungen (Standzeit · Ausgabe · QM-Abweichung). Abfragezeitraum 1–31 Tage (Standard 30 Tage), Kalibrierdatensätze bis ein Jahr zurück
Auftragsbereitschaft — Position Werkzeug	Fehlt die Liste der benötigten Werkzeuge oder das Bestandsverzeichnis, gilt «unbekannt»

---

WMS — Lagerbestand und Bewegungen

Spezifikation wms-mcp 0.2 · Familie wms · Frischegrenze 2 Stunden (Synchronisierung stündlich) · nur lesend

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
wms_capabilities	✅	Deklaration von Version · Standort	—
wms_list_stock	✅	Bestand — je Teilenummer · Lagerort · Los Bestand · reserviert · verfügbar, Bestandsstatus (Stichtag as_of)	material_id · location_id (Abfrage ohne Bedingung wird abgelehnt)
wms_list_movements	✅	Bestandsbewegungen — Zugang · Abgang · Umlagerung · Korrektur · Rücksendung	from · to (Pflicht), Teilenummer · Fertigungsauftrag

• Wird nicht im Spiegel abgelegt. Bestände ändern sich stündlich und werden daher erst bei der Anfrage gelesen.
• Timeline-Ereignisse — je Bewegung ein Ereignis Zugang · Abgang · Umlagerung · Korrektur · Rücksendung.
• Wofür es verwendet wird — der Wiederherstellungsplan zeigt zu jedem verspäteten Teil den Lagerbestand (verfügbar · Bestand · reserviert · gesperrt · in Prüfung). Wurde nur teilweise gelesen, gilt für Teilenummern ohne Zeile nicht 0, sondern «unbekannt». Ohne WMS erscheint der Bestand in der Antwort unter «Nicht berücksichtigt».

---

LIMS — Proben und Prüfergebnisse

Spezifikation lims-mcp 0.2 · Familie lims · Frischegrenze 12 Stunden (Synchronisierung alle 6 Stunden) · nur lesend

Werkzeug	Pflicht	Aufgabe	Wichtigste Eingaben
lims_capabilities	✅	Deklaration von Version · Standort	—
lims_list_samples	✅	Proben und Prüfergebnisse — Teilenummer · Los · Seriennummer · Lieferant · Fertigungsauftrag · Prüfung, Status (registered · in_testing · completed · cancelled), Gesamtbeurteilung	from · to (Entnahmezeitpunkt, Pflicht), Teilenummer · Los · Status

• Im Spiegel abgelegt — Probe → Los · Seriennummer (sonst Teilenummer) · Fertigungsauftrag · Prüfung, Los → Lieferant. Prüfwerte, Spezifikationen und Beurteilungen werden nicht abgelegt.
• Timeline-Ereignisse — je beurteilter Probe bestanden oder nicht bestanden. Noch nicht beurteilte Proben sind kein Ereignis.
• Wofür es verwendet wird — Prüfergebnisse werden an Lose gehängt, und der Auswirkungsbereich wird ab der Probe verfolgt. Ein LIMS-Fehlschlag wird nicht zu einer QM-Abweichung hochgestuft — für Abweichungen ist QM führend.

---

EHS — Arbeitsfreigabe · Isolation · Sicherheit

Spezifikation ehs-mcp 0.3 · Familie ehs · Frischegrenze 1 Stunde (Synchronisierung alle 30 Minuten — die kürzeste aller Familien) · nur lesend

Immer zu liefern sind ehs_capabilities und ehs_events (Freigabe genehmigt · begonnen · unterbrochen · beendet, Isolation angebracht · aufgehoben, Unfallmeldung, Inspektion abgeschlossen, Gefährdungsbeurteilung abgelaufen); die übrigen werden wie bei der Werkzeugverwaltung über deklarierte Funktionen geliefert.

Funktion	Werkzeug	Aufgabe
permits	ehs_list_permits	Arbeitsfreigabe — Art · Status · Anlage · Bereich · Fertigungsauftrag · Instandhaltungsauftrag · Arbeitsgang, Gültigkeitsdauer, Isolation erforderlich ja/nein
isolations	ehs_list_isolations	Isolation (LOTO) — Isolationspunkt · Freigabe · Zeitpunkte für Planung/Anbringung/Prüfung/Aufhebung
incidents	ehs_list_incidents	Unfallverweise — Unfall · Beinaheunfall · unsicherer Zustand · Umweltfreisetzung, Schweregrad
inspections	ehs_list_inspections	Sicherheitsinspektion — Anzahl der Feststellungen · offene Maßnahmen
risk_assessments	ehs_list_risk_assessments	Gefährdungsbeurteilung — Genehmigungsdatum · Frist zur Überprüfung
training	ehs_list_training	Rollenqualifikation (Schulung) — pseudonyme ID · Gültigkeitsdauer

• 🔴 Warum 0.3 die Mindestversion ist — ab 0.3 werden Instandhaltungsaufträge separat übergeben (maintenance_order_ids). work_order_* bezeichnet ausschließlich MES-Fertigungsaufträge. Da 0.2-Konnektoren Instandhaltungsnummern in das Auftragsfeld schrieben und damit im Spiegel nicht vorhandene Fertigungsaufträge entstanden, wird unterhalb 0.3 nicht synchronisiert.
• 🔴 Es werden keine personenbezogenen Daten übernommen. Felder für Unfallbeschreibung, Verletzungen oder Personendaten gibt es nicht; zusätzliche Felder führen zum Fehlschlag der Konformitätsprüfung. Personen erscheinen ausschließlich als pseudonyme ID.
• Im Spiegel abgelegt — Freigabe → Anlage · Bereich · Fertigungsauftrag · Instandhaltungsauftrag · Arbeitsgang, Isolation → Anlage · Freigabe, Unfall → Anlage · Bereich · Fertigungsauftrag · Instandhaltung. Inspektionen, Gefährdungsbeurteilungen und Qualifikationen werden erst bei der Anfrage gelesen.

Wofür es verwendet wird

Funktion	Verwendung
Auftragsbereitschaft — Position Freigabe	Als Gründe werden ausgewiesen: keine Freigabe vorhanden · keine Freigabe deckt den Arbeitsgang ab · erforderliche Isolation fehlt
Prüfung der Freigabeabdeckung	Ob im festgelegten Zeitraum (Standard 7 Tage, max. 31 Tage) Lücken bei Freigaben und Isolationen für Arbeiten und Instandhaltung bestehen und ob die Überprüfung der Gefährdungsbeurteilung überfällig ist
Wiederherstellungsplan	Isolationszeiträume gehen als Fenster der Nichtverfügbarkeit der Anlage ein. Noch nicht genehmigte oder unterbrochene Freigaben werden nur als «Hinweis» ausgewiesen

• Rollenqualifikationen (training) werden gelesen, aber noch nicht in der Bewertung verwendet. Chat-Werkzeuge gibt es nicht.

---

Adapter für kommerzielle Produkte — Stufe Vorabvalidierung

Für häufig eingesetzte kommerzielle Produkte stehen vier Adapter bereit. Alle vier befinden sich auf der Stufe, auf der die Konformitätsprüfung gegen einen Mock-Server bestanden ist; sie wurden noch nicht an realen Produkten validiert — die Validierung erfolgt bei der Einführung gemeinsam in der Kundenumgebung. Alle sind nur lesend.

Produkt	Familie · Version	Gelieferte Werkzeuge	Produktseitige Schnittstelle	Authentifizierung
SAP S/4HANA	ERP erp-mcp/0.4 · Instandhaltung cmms-mcp/0.2 (je Familie separat zu registrieren)	ERP: Personen · Bestellungen · Wareneingang · Kundenaufträge (Verfügbarkeitsfenster und Fertigungsstückliste noch nicht). Instandhaltung: alle vier	OData-V2-Standard-API (Bestellung · Materialbeleg · Kundenauftrag · Instandhaltungsauftrag · Wartungsplan · Equipment u. a.)	OAuth2 client credentials oder basic
IBM Maximo (Manage · 7.6)	Instandhaltung cmms-mcp/0.2	alle vier	REST (OSLC JSON) — Aufträge · vorbeugende Instandhaltung · Assets	API-Schlüssel (MAS) · maxauth (7.6) · basic
Siemens Teamcenter	PLM plm-mcp/0.2	alle vier (inkl. Dokumente)	SOA JSON — gespeicherte Abfragen · BOM-Fenster · where-used	Sitzungsanmeldung (Benutzer · Passwort)
Dassault 3DEXPERIENCE	PLM plm-mcp/0.2	alle vier (inkl. Dokumente)	3DPassport-Anmeldung → 3DSpace-APIs für Änderungen · Engineering · Dokumente	Benutzer · Passwort + Sicherheitskontext

• Die Adapter laufen als eigener Container getrennt vom Digital Thread auf Kundenseite und werden im Digital Thread wie gewöhnliche Konnektoren mit Endpunkt und Token registriert. Ist der Token leer, verweigert der Adapter den Start.
• Als Adresse des Quellsystems wird nur https akzeptiert. Geheimnisse können statt als Wert über eine Datei (…_FILE) übergeben werden.
• Jeder Adapter deklariert eine Aufrufgrenze pro Minute (z. B. Teamcenter 40/Minute, 3DEXPERIENCE 25/Minute). Weist das Quellsystem die Anmeldedaten zurück, wird 5 bis 60 Minuten pausiert und danach erneut versucht.
• Für die Familien MES, Qualität, Werkzeug, Lager, Labor und Sicherheit gibt es noch keine kommerziellen Adapter. Für diese Familien wird ein Konnektor nach der jeweiligen Spezifikation aufgesetzt und angebunden.

---

Für Konnektorentwickler

• Der Spezifikationstext liegt in der Quelle des Digital Thread unter app/connectors/spec/<Spec>-<Version>/ je Werkzeug als JSON vor. Eine neue Version enthält nur die Ergänzungen gegenüber der Vorgängerversion.
• Werkzeuge nicht gelieferter Funktionen aus der Liste entfernen. Ein Werkzeug, das eine leere Antwort liefert, wird als «Funktion vorhanden, keine Daten» gelesen.
• Unbekannte Werte über null und unknown_fields kenntlich machen. Füllt man sie mit 0 oder leeren Zeichenketten, werden sie als «gemessene 0» gelesen und die Bewertung wird falsch.
• Bei Lesewerkzeugen readOnlyHint: true einhalten, bei Werkzeugen mit Zeitfenster die Obergrenze von 31 Tagen.
• Ereignis-IDs müssen bei wiederholtem Lesen identisch sein — darüber filtert die Timeline Dubletten heraus.

Verwandte Dokumente

• Digital Thread — Registrierungsoberfläche · Bindung · Synchronisierung · Graphspiegel · Chat-Werkzeuge
• MCP-Werkzeugübersicht — die vom Chat aufgerufenen thread_-Werkzeuge
• Passwort- und API-Schlüsseländerung — PI_DT_SECRET_KEY zur Verschlüsselung der Konnektor-Anmeldedaten