Okay, das neue Projekt meinerseits ein MCP Server, der entsprechend eingebunden werden kann und Abfragen bzw. Erstellungen innerhalb von OpenXE via API Schnittstelle ermöglicht.
https://github.com/Avatarsia/openxe-mcp-server
Wichtig anzumerken, ist es zwar möglich, Angebote, Aufträge, Rechnungen, Oliverscheine und so weiter erstellen zu lassen, allerdings aufgrund eines Bugs innerhalb von OpenXE gibt es keinerlei Verlinkungen zwischen den entsprechenden Aufträgenrechnungen lieferschein, auch trotz der Tatsache, dass die Datenbankenträge vorhanden sind.
Auch noch anzumerken ist, dass die Rechnungen als in Bearbeitung markiert werden und nicht abgesendet werden oder sonstiges.
Getestet habe ich das Ganze gegen eine Beispielinstanz mit Cloud Code, aber noch nicht an einer tatsächlich produktiven Instanz.
Verifizierte Funktionen zur Zeit
Lesen & Suchen
- Kunden/Lieferanten suchen und filtern
- Artikel mit Preisen und Lagerbeständen abrufen
- Aufträge, Angebote, Rechnungen, Lieferscheine auflisten
- Beleg-Positionen und Protokoll-Historie einsehen
- Artikelkategorien und Versandarten durchsuchen
- Dateien/Anhänge auflisten
- Zeiteinträge auflisten (Mitarbeiter, Projekt, Zeitraum)
- Stechuhr-Status abfragen
- Wochen-Zeitübersicht (Soll/Ist, Überstunden, Urlaub)
Anlegen & Bearbeiten
- Kunden anlegen und bearbeiten
- Lieferadressen verwalten
- Aufträge mit Artikelliste erstellen
- Artikelkategorien anlegen
- CRM-Notizen und Wiedervorlagen anlegen
- Zeiteinträge erstellen, bearbeiten, löschen
- Ein-/Ausstempeln, Pause starten/stoppen
Belege
- Auftrag → Rechnung weiterführen
- Aufträge und Rechnungen freigeben
- Rechnungen als bezahlt markieren
- Beleg-PDFs abrufen
Unter der Haube
- HTTP Digest Auth (realm=Xentral-API)
- Slim Mode: Listen liefern nur Schlüsselfelder (~3K statt ~150K Tokens)
- Gelöschte Datensätze (DEL) werden automatisch ausgeblendet (optional einblendbar)
- Auto-Pagination bei großen Datenmengen
- Router-Modus: nur 2 Tools statt 47 (spart ~8K Tokens Kontext)
- Getestet gegen Live-Instanz mit 200 Kunden, 500 Aufträgen, 314 Artikeln
Bekannte Einschränkungen (OpenXE-Core-Bugs, Issues eingereicht)
- Weiterführen (Auftrag→Rechnung) erzeugt keinen Protokoll-Eintrag über die API (https://github.com/OpenXE-org/OpenXE/issues/244)
- Datei-Upload: Objekt-Zuordnung wird serverseitig ignoriert (https://github.com/OpenXE-org/OpenXE/issues/245, https://github.com/OpenXE-org/OpenXE/pull/246)
- Trackingnummern über API erstellt erscheinen nicht im UI Pakete-Tab (https://github.com/OpenXE-org/OpenXE/issues/247, https://github.com/OpenXE-org/OpenXE/pull/248)
- Lieferadressen REST v1 crasht unter PHP 8.x — Legacy-Fallback eingebaut (https://github.com/OpenXE-org/OpenXE/issues/249)