Die folgenden Einstellungen zeigen den aktuellen Beta-Stand. Die Bilder und Rechenbeispiele dienen zur Orientierung; verwende für Deinen Betrieb die fachlich passenden Werte.
🔌 Wofür brauchst Du einen API Key?
Ein API Key erlaubt anderer Software, mit Deinem Keyline-Account zu arbeiten – etwa einem Webshop oder einem automatischen Materialabgleich. Unter Konfiguration → API Keys verwaltest Du die hier erstellten Schlüssel.
Der Key ist ein technischer Zugang für den Account. Er ist kein Maschinenparameter und verändert von sich aus weder Preise noch Produktionswege. Was eine Verbindung tatsächlich lesen oder ändern kann, hängt von ihren Rechten und den verwendeten API-Funktionen ab.
Für unterschiedliche Verbindungen sind getrennte Keys sinnvoll: Dann erkennst Du ihren Zweck und kannst einen einzelnen Zugang sperren, ohne alle anderen Verbindungen zu ersetzen.
📝 Einen Key gezielt anlegen
API-Key-Formular mit bereichsbezogenen Leserechten und Schreibrechten
Wähle API Key erstellen. Im Formular legst Du fest:
Verwendungszweck: eine verständliche Bezeichnung, etwa „Materialabgleich Testsystem“.
Was darf er? die benötigten API-Berechtigungen.
Ausführende Person: optional die Person, in deren Namen bestimmte Shopfloor-Aktionen gebucht werden.
Gültig bis: die Laufzeit des Keys.
Für das Anlegen und Sperren verlangt Keyline gegebenenfalls eine erneute Identitätsbestätigung. Die reine Übersicht kannst Du aufrufen, ohne einen Key zu erzeugen.
Speichere erst, wenn die Verbindung und ihre benötigten Rechte klar sind. Ein großzügig freigeschalteter Key ist technisch bequem, aber selten die beste Ordnung im Schnittstellenregal. 🙂
🎚️ Lesen und Ändern unterscheiden
Die Rechte sind nach Bereichen aufgeteilt, beispielsweise Jobs, Projekte, Einstellungen, Lager und Fertigung. Die technischen Kürzel stehen neben der verständlichen Bezeichnung:
.r: Daten des Bereichs lesen..rw: Daten des Bereichs lesen und ändern.
Beispiel: Soll eine Verbindung ausschließlich Lagerdaten abholen, wähle warehouse.r. Soll sie auch Lagerdaten schreiben, benötigt sie für diese Funktionen warehouse.rw. Ein Recht für Projekte ersetzt kein Recht für das Lager.
Weitere angebotene Berechtigungen betreffen beispielsweise die Classic-Anbindung oder die Gerätekopplung. Wähle sie nur für den passenden Zweck. Die genaue API-Funktion entscheidet, welche Bereichsberechtigung benötigt wird.
🤖 Welche Rechte braucht MCP?
Der Keyline-MCP-Server unter https://sandbox.keyline.app/mcp stellt einer kompatiblen KI bestimmte Werkzeuge bereit. Welche davon sichtbar sind, richtet sich nach den freigegebenen Bereichen: projects.r liest Projekte und Kalkulationen; projects.rw erlaubt die angebotenen Änderungen an Projekten, Jobs und Preisen.
Für Maschinen und Formeln gelten settings.r beziehungsweise settings.rw. Diese Einstellungswerkzeuge stehen zusätzlich nur mit administrativen Benutzerrechten zur Verfügung. Schreibrechte sind keine Freigabe für beliebige Änderungen an der gesamten Anwendung: MCP bietet einen festgelegten Werkzeugumfang, etwa für bestehende Maschinen, deren Formeln und Materialbedarfe.
Die Einrichtung der Verbindung hängt vom verwendeten KI-Programm ab. Prüfe dort Zielumgebung, Account und die tatsächlich freigegebenen Rechte. Der MCP-Zugang ersetzt keine fehlenden Funktionen: Materialpreise oder Produktvorlagen können derzeit nicht über diese Werkzeuge bearbeitet werden.
🧑🏭 Was macht die ausführende Person?
Die Personenzuordnung betrifft Aktionen in der Shopfloor-API, zum Beispiel Zeiten, Notizen und Abschlüsse. Sie legt fest, für wen diese Aktionen gebucht werden. Ohne ausführende Person kann der Key dort nur lesen.
Die Auswahl einer Person ersetzt keine API-Berechtigung. Für schreibende Fertigungsaktionen müssen sowohl die passenden Rechte als auch die erforderliche Personenzuordnung vorhanden sein.
Beispiel: Eine reine Auswertung liest Fertigungsdaten und benötigt keine künstlich zugeordnete Maschinenbedienerin. Eine Verbindung, die echte Produktionsrückmeldungen bucht, braucht dagegen eine fachlich passende Zuordnung.
Das Feld macht aus dem Key keine normale persönliche Browseranmeldung. Für Anwendungen, die sich im Namen einzelner Personen anmelden, ist OAuth der dafür vorgesehene Anmeldeweg.
⏳ Laufzeit und einmalige Anzeige
Wähle eine Laufzeit passend zum Zweck. Das Formular bietet Zeiträume von einem Tag bis zu längeren Laufzeiten an. Ein zeitlich begrenzter Test braucht üblicherweise keinen jahrelangen Zugang.
Nach dem Erstellen zeigt Keyline den vollständigen Key genau einmal. Kopiere ihn unmittelbar in die dafür vorgesehene sichere Konfiguration Deiner Verbindung. Später zeigt die Übersicht nur noch seine Kennung, den Zweck, die Rechte und das Ablaufdatum.
Ist der vollständige Key verloren gegangen, lässt er sich dort nicht noch einmal anzeigen. Erstelle einen Ersatz, aktualisiere die Verbindung und sperre den alten Zugang. Echte Keys gehören nicht in Knowledgebase-Artikel, Screenshots oder öffentliche Beispielaufrufe.
🛑 Sperren und Verbindung prüfen
In der Übersicht findest Du Keys über Kennung oder Verwendungszweck. Du siehst, welche Rechte sie besitzen, wann sie erstellt wurden und wann sie ablaufen. Abgelaufene Keys sind entsprechend gekennzeichnet.
Mit Key sperren entziehst Du genau diesem Schlüssel den Zugriff. Alles, was ihn verwendet, verliert den Zugang sofort. Die Sperre lässt sich nicht rückgängig machen; für einen erneuten Zugriff benötigst Du einen neuen Key.
Wenn eine Verbindung nach einem Austausch nicht funktioniert, prüfe Account, API-Adresse, Rechte, Ablaufdatum und die Übernahme des vollständigen neuen Keys. Die passende Sandbox- oder Produktivumgebung gehört ebenfalls dazu. Ein richtiger Key an der falschen Umgebung hilft Dir nicht weiter.
