Xentral mit einem KI-Assistenten verbinden (MCP, lokal und read-only)

Das Neueste von Xentral Xentral-API
, , , ,
1

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

  1. Im Xentral-Admin einen Personal Access Token anlegen und kopieren.
  2. Auf dem eigenen Rechner den Einrichtungs-Assistenten starten (siehe unten). Er läuft lokal über stdio, ganz ohne Cloud.
  3. Den Client (z. B. Claude Desktop) auf den lokalen MCP-Server zeigen lassen. Der Assistent schreibt die Konfiguration für dich.
  4. 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

2

Hi @mirza, klasse dank dir! Wir haben auch einen nativen MCP Server mit einer ganzen Reihe an Tools. Bei Interesse bitte einfach ein Ticket eröffnen - die Freischaltung erfolgt derzeit noch manuell.

3

Top, danke fürs Teilen!

In diesem Fall könnt ihr euch gerne auch den Open-Source-Code ansehen und sinnvolle Funktionen oder Verbesserungen in den nativen MCP-Server übernehmen.

Gibt es beim nativen MCP-Server bestimmte Einschränkungen oder Limits, zum Beispiel hinsichtlich der Anzahl der Aufrufe pro Monat, der verfügbaren Tools oder des API-Umfangs?

Außerdem würde mich interessieren, warum die Freischaltung aktuell nur auf Anfrage beziehungsweise manuell erfolgt. Befindet sich der native MCP-Server noch in einer Invite-only-, Beta- oder Testphase?

4

Hi @mirza,

ja der MCP ist derzeit noch in einer Invite-only-Beta aber wird in Kürze (ich denke Ende Juli/Anfang August) in die Public Beta gehen. Aktuell erfolgt die Freischaltung lediglich auf Anfrage.

Derzeit gibt es keine Einschränkungen hinsichtlich der Aufrufe pro Monat oder des API-Umfangs - wir müssen erstmal schauen welche Load da auf uns zukommt. Jedoch nutzt der MCP Endpunkte/Business-Logiken unserer neuen Architektur die bisher nur hinter Feature-Flags existieren - dabei handelt es sich um fest definierte Business Entities die für die Nutzung mit KI optimiert wurden (z.B. Logiken wie: “Versand kann nur stattfinden wenn Bestand auf Lager” oder “eine Rechnungsnummer darf niemals 2x existieren”) um Halluzinationen und Governance Fehler zu reduzieren.

In Bezug auf die verfügbaren Tools gibt es lediglich die Einschränkung, dass wir zu Beginn noch nicht alle Tools zur Verfügung stellen werden sondern schreibende Funktionen zu Beginn einschränken.

Gerne schauen wir uns deine Open Source Version an! VG, Daniel

5

Hi @mirza,

hier noch mehr Infos zum MCP…hatte ich vergessen zu verlinken :slight_smile:

https://help.xentral.com/hc/de/articles/27851077595676-MCP-Server-Beta-Xentral-f%C3%BCr-LLMs-%C3%B6ffnen

BR, Daniel