Hallo zusammen,
viele von uns würden gern einfach in natürlicher Sprache Fragen an die eigenen Xentral-Daten stellen. Zum Beispiel "Welche Bestellungen sind heute offen?" oder "Wie ist der Lagerbestand für Artikel X?".
Mit dem Model Context Protocol (MCP) geht das jetzt über KI-Clients wie Claude Desktop.
Ich habe die Einrichtung einmal Schritt für Schritt aufgeschrieben, weil die Frage öfter aufkam.
Was ist MCP, kurz gesagt
MCP ist ein offener Standard, über den ein KI-Client Werkzeuge nutzen kann.
Für Xentral heißt das: der Client liest über die Xentral-API deine Daten und beantwortet Fragen dazu. Rein lesend, es wird nichts verändert.
Voraussetzungen
- Eine Xentral-Instanz mit API-Zugang
- Ein Personal Access Token (im Xentral-Admin unter den API-Einstellungen erstellen)
- Node.js auf dem eigenen Rechner (https://nodejs.org/)
- Ein MCP-fähiger Client, zum Beispiel Claude Desktop
Schritt für Schritt
- Im Xentral-Admin einen Personal Access Token anlegen und kopieren.
- Auf dem eigenen Rechner den Einrichtungs-Assistenten starten (siehe unten). Er läuft lokal über stdio, ganz ohne Cloud.
- Den Client (z. B. Claude Desktop) auf den lokalen MCP-Server zeigen lassen. Der Assistent schreibt die Konfiguration für dich.
- Fertig. Jetzt kannst du Fragen stellen, der Client liest die Antworten aus Xentral.
Sicherheit
- Read-only. Es werden nur lesende Endpunkte aufgerufen, nichts wird zurückgeschrieben.
- Der Token bleibt auf deinem Rechner. Bei der lokalen Variante verlässt er die Maschine nicht.
- Zugang jederzeit widerrufbar, indem du den Token im Xentral-Admin löschst.
Womit ich das gemacht habe
Ich habe dafür ein kleines Open-Source-Tool gebaut und auf npm ver
Lokal-first, read-only, plattformunabhängig.
Einrichtung per Assistent: Xentral-mcp
npx xentral-mcp setup
Der Assistent fragt Host und Token ab und schreibt die Client-Konfiguration.
Repo und Doku: https://github.com/mjmirza/xentral-mcp
Über Feedback, Fragen oder Bug-Reports im Repo freue ich mich. Wenn es hilft, ergänze ich die Anleitung gern.
Viele Grüße
Mirza Iqbal
