Mit einem persönlichen Zugangstoken greifen eigene Programme über die Account API auf Ihr Konto zu, und ein KI-Agent arbeitet über MCP mit Ihren Daten. Sie legen fest, für welches Konto das Token gilt, welche Berechtigungen es hat und wie lange es gültig ist.
Voraussetzungen
- Das Konto enthält das Feature „API-Zugang“. Es ist in der Testphase und im Enterprise-Tarif enthalten. Fehlt es, zeigt Jupiter ERP „Persönliche Zugangstokens erfordern das Feature „API-Zugang“ (Testphase oder Enterprise).“
Token erstellen
- Öffnen Sie das Benutzermenü, dann Einstellungen → API & MCP, Reiter API-Tokens.
- Klicken Sie auf Neuer Token.
- Vergeben Sie einen Name, an dem Sie das Token wiedererkennen, zum Beispiel „Export-Skript Buchhaltung“.
- Optional: Setzen Sie ein Ablaufdatum. Leer lassen bedeutet kein Ablaufdatum.
- Wählen Sie das Konto. Die Berechtigungen des Tokens gelten nur für dieses Konto.
- Wählen Sie die Berechtigungen. Sie können nur Rechte vergeben, die Sie im Konto selbst haben. Geben Sie nur frei, was die Anwendung wirklich braucht.
- Lesen Sie den Datenschutzhinweis und setzen Sie den Haken Ich habe den Hinweis gelesen und bestätige ihn.
- Klicken Sie auf Erstellen und dann auf Token kopieren. Das Token wird nur jetzt angezeigt.
Token verwenden
- Account API: Jede Anfrage sendet das Token im Header
Authorization: Bearer …und die Account-UUID alsX-Account-Uuid. Die Endpunkte stehen in der Account-API-Referenz. Den Link Dokumentation zu API und MCP finden Sie auch auf der Token-Seite. - MCP: Wie Sie einen Agenten verbinden, steht unter Einen Agenten anbinden.
Behandeln Sie ein Token wie ein Passwort. Hinterlegen Sie es nur in vertrauenswürdigen Systemen, etwa als Umgebungsvariable, und nie in Quellcode oder E-Mails.
Token prüfen und löschen
Die Liste zeigt pro Token Name, Konto, Berechtigungen und Ablaufdatum. Über Berechtigungen anzeigen sehen Sie alle Rechte im Detail. Mit Löschen widerrufen Sie ein Token. Anwendungen und Agenten, die es nutzen, verlieren sofort den Zugriff.
Tipp: Legen Sie für jede Integration ein eigenes Token an. Dann widerrufen Sie bei Bedarf gezielt eines, ohne andere Integrationen zu stören.
Typische Probleme
„Dieses Konto enthält keinen API-Zugang.“
Das gewählte Konto hat weder Testphase noch Enterprise-Tarif. Wählen Sie ein anderes Konto oder passen Sie den Tarif unter System → Abonnement an.
Die API lehnt Anfragen ab (HTTP 401 oder 403).
Das Token hat die nötige Berechtigung nicht, ist abgelaufen oder gehört zu einem anderen Konto als der UUID im Header. Prüfen Sie die Angaben in der Token-Liste.
Ich habe ein Token versehentlich veröffentlicht.
Löschen Sie es sofort und erstellen Sie ein neues.
