Einen Agenten anbinden

Ein KI-Agent kann in Ihrem Mandanten nachschlagen und, wenn das Token es erlaubt, Daten anlegen oder ändern. Sie verbinden ihn mit einem Zugriffstoken. Abo, Nutzer und der Chat des Jupiter KI-Assistenten bleiben im Panel.

Voraussetzungen

• Das Konto enthält das Feature „API-Zugang“ (Testphase oder Enterprise-Tarif).
• Ein eigenes Zugangstoken für den Agenten mit den Berechtigungen, die er braucht.

Verbindung einrichten

1. Öffnen Sie im Benutzermenü Einstellungen → API & MCP und legen Sie ein eigenes Token für den Agenten an. Die Schritte stehen unter API- und MCP-Zugang verwalten.
2. Kopieren Sie das Token sofort. Es wird danach nicht mehr angezeigt.
3. Tragen Sie im Agenten den Endpunkt POST https://api.jupiter-erp.com/api/mcp ein. Ein kopiertes Token sendet Authorization: Bearer und die Account-UUID als X-Account-Uuid. Ein Token aus der Zustimmung trägt den Mandanten bereits. Dann darf der Header fehlen.
4. Der Agent ruft danach die Funktionen ab, die dieses Token auf diesem Mandanten nutzen darf.

Die technische Beschreibung steht in der MCP-Referenz.

Was der Agent tun kann

Er liest Kontakte, Belege, Aufgaben, Projekte und Auswertungen, soweit Token und Modul das erlauben. Die Lese-Funktionen entsprechen dem Jupiter KI-Assistenten im Panel.

Über denselben Zugang kann er die Account API aufrufen: anlegen, ändern, versenden, festschreiben. Eine neue Rechnung bleibt ein Entwurf. Festschreiben und Versand laufen nur mit der passenden Berechtigung. Das Hochladen eines Belegs startet die Erkennung nicht von selbst.

Beträge in den Antworten stehen in Cent.

Was geschlossen bleibt

Abo, Nutzer, Webhooks und der Chat des Jupiter KI-Assistenten sind über diesen Zugang nicht erreichbar. Ein Sitzungs-Token aus der Anmeldung im Panel wird abgelehnt.

Pro Token gelten 100 erfolgreiche Anlagen am Tag. Pro Minute gelten 300 Aufrufe pro Token und 600 pro Account. Die Zähler sind von der Account API getrennt.

Zugang entziehen

Löschen Sie das Token im Benutzermenü unter Einstellungen → API & MCP. Der Zugriff über die Account API und über MCP endet sofort.

Häufige Fragen

Sieht der Agent Daten anderer Mandanten?

Nein. Ein kopiertes Token wählt den Mandanten über die Account-UUID im Header. Ein Token aus der Zustimmung bleibt an dem Mandanten, der dort gewählt wurde.

Bucht der Agent von selbst?

Nein. Er arbeitet mit den Daten, die das Token freigibt. Prüfen und Buchen bleiben bei Ihnen. Der Jupiter KI-Assistent im Panel ist ein eigener Chat.

Verwandte Artikel

• API- und MCP-Zugang verwalten
• Mit dem KI-Assistenten arbeiten