KI-Chat-Anbindung (MCP)

Was ist das

WERKSPUR bietet einen MCP-Server an. MCP (Model Context Protocol) ist ein offener Standard, über den ein KI-Chat-Programm Werkzeuge eines anderen Systems aufruft. Ein angebundenes Chat-Programm kann damit Aufträge, Kennzahlen und Maschinenzustände abfragen und eine Notiz ins Schichtbuch schreiben.

Die Anbindung hat nichts mit dem eingebauten KI-Assistenten zu tun. Der Assistent arbeitet in der Oberfläche von WERKSPUR und schlägt Konfiguration vor. Die MCP-Anbindung liefert Daten an ein Chat-Programm außerhalb.

Wann einsetzen

Fragen in eigenen Worten. „Wie war die OEE letzte Woche?“ oder „Was macht Auftrag 4711?“ beantwortet das Chat-Programm aus den Daten Ihrer Anlage.
Auswertungen ohne neue Ansicht. Das Chat-Programm nutzt die gespeicherten Abfragen, die es mit seinem Token sehen darf.
Notizen aus dem Gespräch. Eine Beobachtung landet als Notiz im Schichtbuch, mit dem Token als Urheber.

Endpunkt und Anmeldung

Der Endpunkt ist POST https://<Ihr-Server>/mcp. Er spricht Streamable HTTP und arbeitet ohne Sitzung. Jeder Aufruf bringt sein Token selbst mit. Auf GET /mcp antwortet der Server mit 405.

Die Anmeldung läuft über ein API-Token, wie bei der übrigen API. Die Seite API & Authentifizierung beschreibt die Tokens im Detail. Es gibt keine eigene Rechteverwaltung für MCP:

Das Token braucht mindestens die Rolle operator.
Die Rolle des Tokens gilt für jeden Aufruf. Ein Token mit der Rolle operator sieht, was ein Bediener sieht. Ein Token mit der Rolle admin sieht alles.
Die Mindestrolle einer Abfrage oder Aktion gilt auch hier.

Ohne Token antwortet der Endpunkt mit 401. Eine neue Installation hat keine Tokens, die Anbindung ist also erst nach dem Einrichten erreichbar.

Einrichten

Legen Sie als Admin unter „API-Tokens“ ein Token an. Wählen Sie die Rolle bewusst, denn sie bestimmt, was das Chat-Programm sehen und tun darf.
Kopieren Sie den Tokenwert sofort. WERKSPUR zeigt ihn nur einmal.
Tragen Sie im Chat-Programm einen eigenen MCP-Server ein. Die Adresse ist https://<Ihr-Server>/mcp. Das Token steht im Header Authorization als Bearer wsk_<TOKEN_VALUE>.

Das Chat-Programm muss den Server über das Netz erreichen. Ein Programm auf einem Rechner im Firmennetz erreicht ihn direkt. Ein Dienst in der Cloud erreicht nur einen Server, der aus dem Internet zugänglich ist.

Die Werkzeuge

Werkzeug	Zweck	Eingaben
`list_queries`	Listet die gespeicherten Abfragen, die das Token ausführen darf, mit ihren Parametern	keine
`run_query`	Führt eine gespeicherte Abfrage aus	`name`, `args`
`get_kpis`	Liefert OEE, Stillstandskosten, Ausschusskosten und OEE je Maschine für einen Zeitraum	`from`, `to` als `JJJJ-MM-TT`
`get_machine_state`	Liefert den aktuellen Zustand einer oder aller Maschinen, mit dem Zeitpunkt des letzten Wechsels	`machine_id`, optional
`get_order`	Lädt einen Auftrag mit Arbeitsschritten und Status	`number`
`add_logbook_note`	Schreibt eine Notiz ins Schichtbuch	`text`, `machine` optional, `idempotency_key` optional

Dazu gelten diese Regeln:

run_query liefert höchstens 200 Zeilen. Gibt es mehr, steht truncated auf true. Das Chat-Programm sollte dann enger filtern.
get_kpis ohne Datum liefert die letzten 30 Tage. Das Werkzeug stützt sich auf die mitgelieferten Kennzahlen-Abfragen. Fehlt eine davon, nennt die Antwort sie unter unavailable und liefert den Rest.
add_logbook_note ruft die Aktion logbuch-notiz auf. Deren Mindestrolle gilt. Mit einem idempotency_key (8 bis 128 Zeichen) legt eine Wiederholung keine zweite Notiz an. Das Audit-Protokoll nennt das Token als Urheber.

Das Chat-Programm kann nur diese sechs Werkzeuge nutzen. Es kann keine beliebige Aktion auslösen und kein freies SQL ausführen.

Fehler und Grenzen

Fehlermeldungen bleiben allgemein. Scheitert eine Abfrage in der Datenbank, bekommt das Chat-Programm einen kurzen Hinweis ohne SQL-Text. Die Einzelheiten stehen im Serverprotokoll.
Eingeschränkte Lizenz. Ist die Lizenz abgelaufen, lehnt der Server jeden Aufruf von /mcp mit 403 ab, auch lesende. Der Endpunkt nimmt nur POST an, und eine eingeschränkte Lizenz lässt nur Lesezugriffe per GET zu. Mehr dazu steht unter Lizenzbetrieb.
Daten verlassen das Haus. Was ein Werkzeug liefert, geht an das Chat-Programm und dessen Anbieter. Geben Sie dem Token nur die Rolle, deren Daten Sie dort sehen wollen.