MCP
Verbinden Sie einen Agenten mit Ihrem Mandanten. Diese Seite beschreibt das Token, den Endpunkt, die Methoden und was der Agent lesen und ändern darf.
Verbindung
- Methode
- POST
- Pfad
- /api/mcp
- Host
- https://api.jupiter-erp.com
- Protokoll
- JSON-RPC 2.0, MCP 2025-03-26
- Token
- Bearer-Token
- Mandant
- Header, bei OAuth am Token
Ein kopiertes Token legen Sie im Panel unter Profil → API & MCP an. Dafür ist der Header X-Account-Uuid Pflicht. Fehlt er, antwortet der Endpunkt mit 412. Hat das Token ein festes Konto, muss die UUID dazu passen. Hat es keins, gilt die UUID für ein Konto, dem Sie angehören. Ein Sitzungs-Token der Anmeldung wird abgelehnt.
Ein OAuth-Token trägt den Mandanten aus der Zustimmung. Der Header darf fehlen. Steht er trotzdem in der Anfrage, muss er zum Token passen. Die UUID steht nie in einem Tool-Argument.
Der Zugang liegt in der Testphase und im Enterprise-Paket. Beträge in den Tool-Antworten sind Cent, wie in der Account API.
Pro Minute gelten 300 Aufrufe pro Token und 600 pro Account. Die Zähler sind von der Account API getrennt.
Anbinden
- 1
Token anlegen
Unter Profil → API & MCP ein eigenes Token für den Agenten erstellen und den Wert sofort kopieren.
- 2
Endpunkt eintragen
POST https://api.jupiter-erp.com/api/mcp mit Authorization: Bearer. Ein kopiertes Token sendet zusätzlich X-Account-Uuid.
- 3
Tools abrufen
initialize und tools/list liefern nur die Funktionen, die dieses Token auf diesem Mandanten nutzen darf.
Erste Anfrage
POST /api/mcp
Authorization: Bearer <token>
X-Account-Uuid: <account-uuid>
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"agent","version":"1"}}}Methoden
- initialize
- Protokollversion, Servername und ein Kurztext für den Agenten.
- tools/list
- Die Lese-Tools und call_api für Anlegen und Ändern, die dieses Token auf diesem Konto nutzen darf.
- tools/call
- Ruft ein Tool mit Argumenten auf. Fehlt die Berechtigung oder das Modul, enthält die Antwort keine Daten.
- ping
- Erreichbarkeit, ohne Daten zu lesen.
Eine Nachricht ohne id ist eine Benachrichtigung und antwortet mit HTTP 202 und leerem Body. Eine Anfrage mit id antwortet mit HTTP 200 und einem JSON-RPC-Ergebnis.
Ohne Token antwortet der Endpunkt mit 401. Ein kopiertes Token ohne X-Account-Uuid antwortet mit 412. Ein Sitzungs-Token, ein fremdes Konto, ein gesperrtes Konto oder ein gesperrter MCP-Zugang antwortet mit 403.
Tools
Kurze Lese-Tools entsprechen dem Jupiter KI-Assistenten im Panel. call_api führt eine Account-API-Route aus, im Rahmen von Token und Modul. account_api_routes nennt die Pfade. Beträge in call_api sind Cent.
| Tool | Berechtigung |
|---|---|
| contacts, contacts_analytics | contacts.read |
| documents, document_payments | Read-Berechtigung der Belegart |
| receipts, booking_account_catalog | receipts.read, Dauerbelege zusätzlich recurring_receipts.read |
| tasks | tasks.read |
| projects | projects.read |
| products | products.read |
| service_entities | Read-Berechtigung des Service-Typs |
| files | files.read und Drive-Modul |
| bank_transactions | bank_transactions.read und Banking-Modul |
| accounting_reports, tax_insights | accounting_reports.read, BWA und OPOS mit ihrer eigenen Berechtigung |
| depreciation | depreciation.read |
| warehouses | warehouses.read |
| text_templates | text_templates.read |
| get_account_analytics, product_sales, banking_analytics, time_tracking_analytics, search_entities | nur die Bereiche, die das Token lesen darf |
| get_account_subscription, date | gültiges Token und Account |
| jupiter_help | nur öffentliche Handbuchartikel |
| call_api | die Berechtigung der aufgerufenen Account-API-Route |
| account_api_routes | gültiges Token und Account |
Grenzen
call_api akzeptiert nur Pfade unter /api/account. Abo, Nutzer, Webhooks und der Chat des Jupiter KI-Assistenten sind geschlossen. Ein Sitzungs-Token wird abgelehnt.
Was das Token auf der Account API darf, darf der Agent über call_api. Eine neue Rechnung bleibt ein Entwurf. Das Hochladen eines Belegs startet die Erkennung nicht. Dafür gibt es einen eigenen Aufruf, das Ergebnis liegt auf dem Entwurf.
Pro Token gelten 100 erfolgreiche Anlagen pro Tag. Ist das Kontingent voll oder fehlt die Berechtigung, enthält die Antwort keine Daten und es wird nichts gespeichert. Dateien werden als Base64 übergeben.
Downloads
Dieselbe Beschreibung als OpenAPI 3.0. Der Vertrag beschreibt den HTTP-Endpunkt, nicht die Fachdaten der Tools.