Ein Skript soll nachts einen Bericht abrufen oder nach einem Build auf MainPath zugreifen. Beides braucht eine Anmeldung, die ohne offenen Browser funktioniert. Seit dem 5. August 2026 kannst du dafür persönliche Schlüssel für die MainPath API anlegen.
Erstellen, ansehen und widerrufen
Die Schlüsselverwaltung findest du in deinen Kontoeinstellungen. Dort erstellst du neue Schlüssel, siehst die vorhandenen Einträge und widerrufst Schlüssel, die du nicht mehr brauchst.
Der geheime Wert wird direkt nach dem Erstellen einmalig angezeigt. Kopiere ihn in die Geheimnisverwaltung deiner Pipeline oder in deinen Passwortmanager. Danach lässt er sich nicht erneut abrufen. Geht er verloren, erstellst du einen neuen Schlüssel und widerrufst den alten. So kann auch jemand mit Zugriff auf dein Konto den gespeicherten geheimen Wert später nicht auslesen.
Anmeldung für Skripte und Pipelines
Mit einem persönlichen Schlüssel authentifiziert sich die mp CLI, ohne dass du dich vorher im Browser anmeldest. Dasselbe gilt für eigene Skripte, die mit der MainPath API arbeiten. Typische Einsatzzwecke sind:
- Abläufe nach einem Build: Eine Pipeline löst auf MainPath einen Schritt aus oder liest Daten ab.
- Wiederkehrende Aufgaben: Auswertungen, Aufräumarbeiten oder Berichte laufen nach Zeitplan.
- Eigene Werkzeuge: Interne Kommandozeilenprogramme oder kleine Oberflächen greifen auf Plattformdaten zu.
Für diese Abläufe muss während der Ausführung niemand einen Anmeldedialog bestätigen.
Pipeline für Kunden-App
Weitere Zugänge außerhalb der Weboberfläche
MainPath bietet neben der Weboberfläche die MainPath Toolbox für den Desktop, die mp CLI für die Kommandozeile und ein Plugin für VS Code. Über einen MCP Server können auch Agenten für die Softwareentwicklung mit MainPath arbeiten und Funktionen aufrufen, die du sonst manuell bedienst.
Ein Schlüssel für jeden Zweck
Lege für jeden Einsatzzweck einen eigenen Schlüssel an, etwa für die Pipeline, dein lokales Werkzeug und das nächtliche Skript. Musst du einen davon ersetzen, betrifft das nur den zugehörigen Ablauf.
Schlüssel sind persönlich. Aktionen mit deinem Schlüssel werden dir zugeordnet. Braucht eine andere Person Zugriff, erstellt sie einen eigenen Schlüssel. Landet deiner an der falschen Stelle, widerrufst du ihn und erstellst einen neuen.
Speichere Schlüssel niemals im Repository, auch nicht kurz zum Testen. Ein späteres Löschen aus der Datei entfernt den Wert nicht aus der bisherigen Git Historie.
Vom Schlüssel zum automatisierten Ablauf
Wähle zunächst den Ablauf, für den du einen Schlüssel brauchst, und lege fest, wo sein geheimer Wert gespeichert wird. Die Anleitung zu CLI und Plugin für Agenten beschreibt die Einrichtung der Werkzeuge. Wie automatisierte Abläufe zusammenhängen, zeigt die Seite zur Automatisierung mit CI/CD.