Xentral über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Xentral ERP klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Xentral + Cursor

Verbinde Xentral ERP mit deiner KI: Artikel und Bestände je Lager und Lagerplatz, Kunden und Lieferanten, Aufträge, Lieferscheine mit Sendungsverfolgung, Rechnungen mit Zahlungsstatus, Gutschriften, Bestellungen und Verbindlichkeiten durchsuchen und Auftragsentwürfe anlegen. Über die aktuelle Xentral API mit einem Personal Access Token.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

XENTRAL_URL, XENTRAL_TOKEN

Schritt 1 — Zugangsdaten holen

1. Klicke in Xentral unten links auf Administration, dann auf Account settings (Kontoeinstellungen) → Developer settings (Developer Einstellungen) → Personal Access Tokens. Schneller geht es, wenn du „Personal Access Token“ in die Smart Search tippst. Dafür brauchst du ein Admin-Konto.
2. Klicke auf Create token (Token erzeugen) und gib dem Token einen Namen wie AnythingMCP-Read, eine Beschreibung und eine Laufzeit (standardmäßig 180 Tage).
3. Vergib Read für die Bereiche, die die KI sehen soll: Artikel und Bestände, Kunden (CRM), Verkaufsbelege (Aufträge, Lieferscheine, Rechnungen, Gutschriften), Einkauf (Bestellungen, Lieferanten, Verbindlichkeiten) und Einstellungen wie Zahlungsweisen und Projekte. Create und Delete auf Aufträge gibst du nur dazu, wenn die KI Auftragsentwürfe vorbereiten darf. Die Admin-Scopes lässt du weg.
4. Klicke auf Create und kopiere das Token sofort: Xentral zeigt es nur einmal an.
5. Setze XENTRAL_URL auf die Adresse, unter der du Xentral öffnest, zum Beispiel https://acme.xentral.biz (oder deine eigene Domain), ohne /api, ohne Pfad und ohne Schrägstrich am Ende. Trage das Token ohne das Wort Bearer in XENTRAL_TOKEN ein, dann installiere den Connector.
6. Beginne mit xentral_list_products: Kommen Artikel zurück, passen URL und Token.

Laufzeit und Rechte des Tokens: Ein Token läuft an dem Datum ab, das du gewählt hast, und Xentral löscht Tokens, die 180 Tage lang nicht benutzt wurden. Die Rechte lassen sich nachträglich nicht ändern: Für andere Rechte erstellst du ein neues Token und ersetzt XENTRAL_TOKEN. Die KI sieht nur die Bereiche, die das Token lesen darf.

IDs statt gedruckter Nummern: Jedes Tool erwartet die interne Xentral-ID, nicht die gedruckte Artikel-, Beleg- oder Kundennummer. Die KI sucht die ID deshalb zuerst mit einem Listen-Tool, über einen Filter auf number, documentNumber oder customerNumber oder über search. Die ID eines Kunden ist zugleich seine Adress-ID: Belege zeigen sie als address.id, und xentral_create_sales_order erwartet sie als addressId. Kundenfilter treffen nur exakt. Um einen Kunden über einen Teil des Namens zu finden, durchsucht die KI seine Belege mit xentral_list_invoices oder xentral_list_sales_orders und übernimmt von dort address.id.

Filter: Die Listen-Tools nehmen Bedingungen an, die alle zutreffen müssen, jeweils mit Feld (key), Operator (op) und Wert (value). Offene Rechnungen zum Beispiel: [{"key": "paymentStatus", "op": "in", "value": ["pending", "partiallyPaid"]}]. Zu den Operatoren gehören equals, in, contains, startsWith, greaterThanOrEquals und lessThan; jedes Tool nennt die Felder, die es annimmt. Belegdaten haben das Format YYYY-MM-DD.

Belege suchen und sortieren: Bei Aufträgen, Lieferscheinen, Rechnungen, Gutschriften und Bestellungen durchsucht search Belegnummer, Name und Nummer von Kunde oder Lieferant, E-Mail, PLZ und externe Bestellnummern. sort nimmt Feldnamen, ein vorangestelltes Minus sortiert absteigend (-documentDate), und include bettet zugehörige Daten wie lineItems (Positionen) oder address ein.

Status: Aufträge sind draft, released, completed oder cancelled; Rechnungen, Lieferscheine und Bestellungen können außerdem sent sein. Der Zahlungsstatus (paymentStatus) von Rechnungen und Gutschriften ist pending, paid, partiallyPaid, cancelled, partiallyCancelled, badDebt oder debited.

Bestände: xentral_get_product_stock liefert Summen und dieselben Zahlen je Lager und je Verkaufskanal. sellable ist, was du einem Kunden noch zusagen kannst, physical, was im Regal liegt, reserved, was offene Aufträge blockieren. Lager enthalten Lagerplätze: xentral_list_product_storage_locations zeigt, wo ein Artikel liegt, xentral_list_storage_location_items, was auf einem Lagerplatz liegt.

Versand und Zahlungen: xentral_list_delivery_note_shipments liefert zu einem Lieferschein Versanddienstleister, Trackingnummer und Tracking-Link. xentral_get_invoice_balance zeigt die Zahlungen, die auf eine Rechnung gebucht sind, und was noch offen ist.

Seiten: Beleglisten nehmen page und perPage (bis 1000, standardmäßig 25), die übrigen Listen page und pageSize (10 bis 50).

Schreiben: xentral_create_sales_order legt nur einen Auftragsentwurf für einen bestehenden Kunden an: ohne Auftragsnummer, und nichts wird reserviert oder versendet, bis jemand den Entwurf in Xentral prüft und freigibt. Lässt die KI Preise weg, nimmt Xentral die Preise des Kunden und des Artikels. xentral_delete_sales_order_draft löscht solch einen Entwurf und ist bei der Installation ausgeschaltet; freigegebene, abgeschlossene oder stornierte Aufträge lässt Xentral nicht löschen. Alle anderen Tools lesen nur.

Nur lesen: Gib dem Token nur Read-Rechte und schalte xentral_create_sales_order auf der Connector-Seite aus.

Rate Limit: Xentral erlaubt etwa 100 Anfragen pro Minute und Instanz, unabhängig vom Tarif; darüber antwortet es mit 429 und einem Retry-After-Header. Eine gefilterte Liste ist besser als viele Einzelabfragen.

Häufige Fehler: 401 heißt, dass das Token falsch, abgelaufen oder gelöscht ist. 403 heißt, dass dem Token das Recht für diesen Bereich fehlt: Erstelle ein neues Token mit diesem Recht. 400 „Generic request validation failed“ oder „filter must be an array“ deutet auf ein Filterfeld oder einen Operator, den das Tool nicht annimmt, oder auf einen falsch aufgebauten Wert. 404 „Route not found“ heißt, dass XENTRAL_URL einen Pfad wie /api/v1 enthält oder die Instanz diesen Endpunkt noch nicht anbietet. 409 beim Löschen eines Auftrags heißt, dass er kein Entwurf mehr ist.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Xentral-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele Stück von Artikel 700123 können wir in jedem Lager noch verkaufen, und auf welchen Lagerplätzen liegt er?“
• „Welche Rechnungen sind noch offen oder nur teilweise bezahlt? Zeig mir Kunde, Betrag und Mahnstufe, die ältesten zuerst.“
• „Wo ist das Paket zu Auftrag 200345? Nenn mir den Versanddienstleister und den Tracking-Link.“
• „Lege einen Auftragsentwurf für Kunde 10001 an: 20 Stück Artikel 700123 und 5 Stück Artikel 700456, Wunschliefertermin 20. Oktober.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden