MCP-Server für JTL-Wawi

JTL-Wawi per KI abfragen: Kunden, Aufträge, Versand & Retouren, read-only und ohne offenen Port

ChatGPT ist im Team längst angekommen - nur Ihre Wawi-Daten kennt es nicht.

Der MCP-Server macht Ihre JTL-Wawi für KI-Programme wie Claude oder ChatGPT direkt nutzbar: über 60 geprüfte Tools, eine Rolle je Mitarbeiter, lokal bei Ihnen. Fragen in natürlicher Sprache statt SQL - und besser, als eine REST-API erst selbst anzubinden.

Offizieller JTL-Servicepartner Über 10 Jahre JTL-Servicepartner
01 - Grundlagen

Was ist ein MCP-Server für JTL-Wawi?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Modelle mit Werkzeugen verbindet. Ein MCP-Server für JTL-Wawi stellt Ihre Wawi-Daten als fertige, klar definierte Tools bereit, die eine KI direkt aufrufen kann.

Das Ergebnis: Ihre KI beantwortet Fragen wie „Welche Aufträge von Kunde 10001 sind noch offen?" oder „Wo steckt die Retoure von Frau Müller?", indem sie das passende Tool aufruft, statt zu raten oder eigenes SQL zu schreiben.

Natürliche Sprache statt SQL

Ihr Team fragt in normalem Deutsch. Niemand muss Datenbankabfragen schreiben oder die JTL-Tabellenstruktur kennen.

Fertige Tools statt Rohzugriff

Der Server liefert geprüfte Werkzeuge mit klaren Eingaben und Ausgaben. Die KI bekommt keinen ungefilterten Datenbankzugriff, sondern genau das, was Sie freigeben.

02 - MCP vs. API

Warum ein MCP-Server besser ist, als die JTL-Wawi-API selbst anzubinden

Eine API ist nur die Tür. Bis Ihre KI sie nutzen kann, müssen Sie sie erst integrieren. Der MCP-Server überspringt diesen Schritt.

Native Tool-Calls statt Integrationsprojekt

Die KI ruft die Tools direkt auf, so wie sie es gelernt hat. Keine Schnittstellen zuzuordnen, keine eigene Zwischenschicht, kein selbstgebauter Verbindungs-Code, den jemand warten muss.

Geprüfte Tools statt frei generiertem SQL

Statt die KI selbst Datenbankabfragen erfinden zu lassen (fehleranfällig), liefert der MCP-Server definierte Tools mit gegen die Wawi verifizierten Ergebnissen. So wird das Fehlerrisiko minimiert.

Sofort mit jeder KI nutzbar

Claude, ChatGPT, Cursor oder eigene Agenten, alle MCP-fähigen Clients funktionieren ohne Zusatzarbeit. Sie binden einmal an, nicht pro Tool und pro Programm neu.

Sicherheit eingebaut statt nachgerüstet

Read-only, Rollen und Schlüssel sind Teil des Servers. Bei einer eigenen API-Anbindung müssten Sie das alles selbst absichern.

03 - Funktionsumfang

Über 60 Tools für die Fragen, die täglich an die JTL-Wawi gehen

Konkret und benannt, statt vager Versprechen. Jedes Tool ist gegen die Wawi-Oberfläche geprüft - die Antwort entspricht dem, was in der Wawi steht. Dazu kommen Systemabfragen wie Verbindungsstatus und eine Datenqualitätsprüfung.

Kunden & Aufträge

Kunden suchen und das Vollbild öffnen. Aufträge nach Nummer, Marktplatz-Nummer, Kunde oder Zeitraum finden, mit Status, Positionen und Lieferfähigkeit. Dazu Angebote, Belegkette und Zahlungsverhalten.

Versand & Retouren

Versandstatus pro Paket mit Tracking-Nummer, Link und Teilsendungen. Retouren mit Status, Grund und Gutschriftbezug. Dazu eine Ausnahmeliste: was heute im Versand hängt.

Artikel & Struktur

Artikel nach Nummer, Name oder EAN suchen. Varianten auflösen, Stücklisten aufklappen, Kategorien, Warengruppen, Hersteller und Merkmale abfragen - und Langsamdreher benennen.

Lager

Bestand prüfen - und erklären lassen, warum er so ist. Bewegungen, Chargen, Seriennummern, Lagerplätze, Wareneingänge. Dazu, was fällig wird: MHD und Inventur.

Einkauf

Lieferantenbestellungen mit Liefergrad und Wareneingang. Lieferanten, Bezugsquellen und Lieferantenperformance. Bestellvorschlag, Einkaufsvolumen und die Entwicklung der Einkaufspreise.

Auswertung & Finanzen

Bestseller und Umsatzreport, Rechnungen und Zahlungen, offene Posten. Beantwortet Fragen nach dem aktuellen Stand - für den Verlauf über Monate ist das Dashboard zuständig.

04 - Rollen & Rechte

Nicht jeder muss alles sehen

Der häufigste Einwand gegen KI auf Firmendaten lautet: „Dann sieht doch jeder alles." Deshalb hängt an jedem Zugang eine Rolle, und die Rolle entscheidet, welche Werkzeuge überhaupt sichtbar sind. Was eine Rolle nicht darf, taucht gar nicht erst auf - statt mit einer Fehlermeldung zu antworten.

Rolle Sieht Sieht nicht
Auskunft
Support, Kundendienst
Kunden, Belege, Bestände, Bestellstatus Einkaufspreise, Konditionen, Kreditlimit, Auswertungen
Lager
Kommissionierung, Wareneingang
Artikel, Bestände, Lagerplätze, Wareneingänge Preise, Kundendaten
Auswertung
Geschäftsführung, Einkauf
Auswertungen, Kapitalbindung, Einkaufspreise, Lieferantenkonditionen Kundenakten, Bonität einzelner Kunden
Admin alles

Die Rollen sind nach ihrem Umfang benannt, nicht nach einer Position - eine Lehre aus dem Betrieb. Wer eine Rolle „Geschäftsführer" nennt, verspricht die Rechte eines Geschäftsführers; gemeint war aber „Kennzahlen statt Kundenakten". Rolle und Sperre lassen sich jederzeit in der Verwaltungsoberfläche ändern und wirken sofort.

05 - Sicherheit & Datenschutz

Lokal, read-only und ohne offenen Port

Der Kern: Es ist kein eingehender Port ins Internet offen - die Angriffsfläche von außen bleibt dadurch minimal. Und beim Datenschutz sind wir bewusst transparent.

  • Read-only erzwungen: Nur-Lese-Datenbankbenutzer, der Server erlaubt nur lesende Abfragen. Schreiben ist technisch ausgeschlossen - auch bei einem KI-Fehler.
  • Kein offener Port: Anbindung über eine ausgehende Verbindung, keine eingehende Freigabe.
  • Daten bleiben bei Ihnen: Übertragen wird nur die Antwort auf die jeweils gestellte Frage, nie die Datenbank.
  • Zugänge steuerbar: ein Zugang je Person mit Rolle - Sperre und Rollenwechsel wirken sofort.
  • KI-Wahl liegt bei Ihnen: Wir empfehlen EU-gehostete Modelle (mit AVV) oder ein lokales LLM. Ehrlich gesagt: Bei US-Anbietern wie ChatGPT gehen Daten in die USA - darauf weisen wir aktiv hin.
  • Update-fest: Ein Schema-Check prüft vor JTL-Updates, ob alles noch passt - Änderungen zeigen sich als Prüfmeldung, nicht als falsche Antwort.
MCP-Server Demo: KI beantwortet eine Kundendaten-Anfrage aus der JTL-Wawi mit Testdaten
Kundenabfrage per Chat (Demo-Daten): Die KI ruft das geprüfte Tool auf - read-only.
MCP-Server Demo: Versandstatus mit Tracking-Link direkt aus der JTL-Wawi, Testdaten
„Wo ist die Sendung?" - Antwort mit Tracking-Link, direkt aus der Wawi (Demo-Daten).
06 - Einrichtung

In wenigen Minuten eingerichtet, ohne Kommandozeile

1. Datenbank verbinden

Nur-Lese-Zugang zur JTL-Datenbank in der Oberfläche eintragen und mit einem Klick testen.

2. Server starten

Per Knopfdruck starten. Der Server läuft lokal auf dem Wawi-Rechner.

3. Zugang mit Rolle anlegen

Je Mitarbeiter einen Zugang anlegen, Rolle wählen und die fertige Verbindungs-URL kopieren.

4. KI verbinden

URL im KI-Client eintragen. Fertig, ab jetzt Fragen in natürlicher Sprache stellen.

Verbinden per Konfiguration, Beispiel für MCP-Clients wie Cursor oder eigene Agenten:

{
  "mcpServers": {
    "jtl-wawi": {
      "url": "https://ihr-server.ts.net/mcp",
      "headers": { "X-API-Key": "ihr-zugangsschluessel" }
    }
  }
}

In Claude Desktop genügt die URL als Custom Connector. Der Zugangsschlüssel kann auch direkt an die URL angehängt werden.

Demo-Termin vereinbaren →
07 - Vergleich

MCP-Server vs. JTL-Wawi-API vs. KI-Desktop-Tool

Drei Wege, KI an die JTL-Wawi zu bringen. Hier die ehrlichen Unterschiede.

  upbox MCP-Server JTL-API selbst anbinden KI-Desktop-Tool
Sofort KI-fähig Ja, native Tools Nein, erst integrieren Ja, aber app-gebunden
Mit jedem MCP-Client Ja (Claude, ChatGPT, Cursor, eigene Agenten) Je nach Eigenbau Nein, nur die eine App
Read-only erzwungen Ja, auf DB-Ebene Selbst abzusichern Unterschiedlich
Kein offener Port Ja, ausgehender Tunnel Je nach Aufbau Meist lokal
Rollen je Mitarbeiter Ja, vier Rollen, sofort änderbar Selbst zu bauen Meist nicht
Versandstatus-Tool Ja Selbst zu bauen Oft nicht
Retouren-Tool Ja Selbst zu bauen Oft nicht
Antwort-Genauigkeit Geprüfte Tools, kein freies SQL Abhängig vom Code Teils frei generiertes SQL
EU-gehostete KI Ja Selbst zu wählen Unterschiedlich
08 - Für wen

Für wen sich der MCP-Server lohnt

Support-Teams

Versandstatus, Retouren und Auftragsdetails per Frage, statt durch Masken zu klicken. Schnellere Antworten an den Kunden.

Agenturen & Dienstleister

Eine saubere, sichere KI-Anbindung für Mandanten, lokal beim Kunden installiert, ohne eigenen Integrationsaufwand.

Händler mit eigenem KI-Stack

Wer Claude, ChatGPT oder eigene Agenten nutzt, bindet die Wawi einmal an und nutzt sie überall.

09 - Einordnung

Der MCP-Server beantwortet das Jetzt. Für das Davor gibt es das Dashboard.

Das ist keine Marketing-Aufteilung, sondern eine Eigenschaft der Warenwirtschaft. Ein MCP-Tool liest die Wawi live und weiß deshalb sehr genau, wie es heute aussieht. Wie viel am 14. April im Lager lag, steht dagegen nirgends in JTL: Der Bestand ergibt sich aus allen Buchungen davor und wird beim nächsten Wareneingang überschrieben. Wer ihn an dem Tag nicht festhält, bekommt ihn nie wieder.

MCP-Server: „Wie ist es gerade?"

Wo bleibt die Sendung? Ist der Artikel lieferbar? Welche Retoure hängt? Was ist beim Lieferanten überfällig? Fragen an den aktuellen Stand, direkt aus der Wawi, im Gespräch beantwortet.

Dashboard: „Wie hat es sich entwickelt?"

Kapitalbindung über Monate, Liegezeiten, Reichweite, Marge je Artikel, Werbekosten gegen Deckungsbeitrag. Zahlen, die festgehalten werden müssen, bevor man sie auswerten kann.

Beides kommt aus einer Hand und läuft bei denselben Kunden - zusammen mit JTL-Wawi-Betreuung, JTL-Shop und Automatisierung. Auch unser KI-Assistent OpenClaw holt seine Wawi-Antworten über diesen MCP-Server. Zum JTL-Dashboard →

10 - Häufige Fragen

Häufige Fragen zum MCP-Server für JTL-Wawi

Eine lokale Brücke, die Wawi-Daten als KI-aufrufbare Tools bereitstellt. Über das Model Context Protocol beantworten Claude, ChatGPT oder Cursor damit Fragen in natürlicher Sprache, etwa zu Kunden, Aufträgen, Versand oder Retouren, ohne dass jemand SQL schreiben muss.

Eine REST-API müssen Sie erst anbinden: Schnittstellen zuordnen, Zugänge einrichten, die Verbindung dauerhaft pflegen. Beim MCP-Server ruft die KI fertige, getestete Tools direkt auf. Kein eigener Programmieraufwand, keine Schnittstellen-Anbindung, sofort einsatzbereit.

Nein. Der Zugriff ist read-only über einen eigenen Nur-Lese-Datenbankbenutzer, und der Server lässt nur lesende Abfragen zu. Schreiben, Ändern oder Löschen ist auf Datenbankebene unterbunden.

Nein. Die Erreichbarkeit läuft über eine ausgehende Verbindung (Tunnel bzw. Tailscale/WireGuard). Es bleibt kein eingehender Port ins Internet offen.

Der MCP-Server ist so aufgebaut, dass die Wawi-Daten Ihre Infrastruktur nicht verlassen: lokal bei Ihnen, read-only, ohne offenen Port, die Wawi-Daten verlassen Ihre Infrastruktur nicht. Ob auch die KI-Auswertung im EU-Raum bleibt, hängt vom gewählten Modell ab. Wir empfehlen EU-gehostete Modelle (mit AVV) oder ein lokales LLM, bei dem nichts das Haus verlässt. Bei US-Anbietern wie ChatGPT/OpenAI ist ein belastbarer AVV nicht ohne Weiteres möglich und Daten gehen in die USA. Darauf weisen wir aktiv hin.

Über 60 Tools in sieben Bereichen: Kunden & Aufträge, Versand & Retouren, Artikel & Struktur, Lager, Einkauf, Auswertung & Finanzen sowie Systemabfragen. Dazu gehören unter anderem Versandstatus mit Tracking, Retouren, Chargen und Seriennummern, Lagerplätze, MHD- und Inventurfälligkeiten, Lieferantenperformance, Bestellvorschlag, Umsatzreport und offene Posten.

Nein. Jeder Zugang bekommt eine Rolle, und die Rolle bestimmt, welche Tools überhaupt sichtbar sind. Lager sieht Artikel, Bestände und Lagerplätze, aber keine Einkaufspreise und keine Kundendaten. Auskunft sieht Kunden, Belege und Bestellstatus, aber keine Einkaufspreise, Konditionen oder Kreditlimits. Auswertung sieht Kennzahlen und die Einkaufsseite, aber keine Kundenakten. Was eine Rolle nicht darf, taucht gar nicht erst als Werkzeug auf.

Ja, über die Verwaltungsoberfläche. Sperre und Rollenwechsel wirken sofort: Status und Rolle werden bei jedem Aufruf neu nachgeschlagen, und beim Sperren werden erteilte Zugriffe zusätzlich widerrufen. Ein gesperrter Zugang arbeitet also nicht mit einem alten Token weiter.

Ein Schema-Check prüft, ob alle genutzten Datenbank-Views und Spalten noch vorhanden sind, und benennt punktgenau, was sich verschoben hat. Der Check läuft ohne Echtdaten und ohne Kommandozeile. So zeigt sich eine Änderung als Prüfmeldung, statt als falsche Antwort im Arbeitsalltag.

Alle MCP-fähigen Clients, unter anderem Claude, ChatGPT, Cursor und eigene Agenten. Anders als app-gebundene Desktop-Tools ist der MCP-Server nicht an ein einzelnes Programm gebunden.

Nein. Sie fragen in natürlicher Sprache, zum Beispiel „Wo bleibt die Retoure von Kunde Müller?". Die Einrichtung läuft über eine geführte Oberfläche im Browser, ganz ohne Kommandozeile.

Ja. Der Server liest direkt aus der MSSQL-Datenbank der Wawi und ist damit unabhängig von der API-Edition. Ein API-Upgrade ist nicht nötig.

Der Server liefert klar definierte, gegen die Wawi-Oberfläche verifizierte Tools statt frei generiertem SQL. Das minimiert Fehler: Die Antwort entspricht dem, was in der Wawi steht.

Wenige Minuten: Datenbank verbinden, Server starten, Zugang erstellen, URL im KI-Client eintragen, alles über eine geführte Oberfläche im Browser.

Der MCP-Server wird nicht als Software einzeln verkauft - er ist das Werkzeug, mit dem wir arbeiten. Der Einstieg ist ein Datencheck zum Festpreis: Wir durchleuchten Ihre JTL-Daten und Sie erhalten ein schriftliches Ergebnis. Läuft der Server danach dauerhaft bei Ihnen, gehören Einrichtung und Betreuung zur laufenden Zusammenarbeit. Das Erstgespräch mit Beispiel-Funden am Demo-Mandanten ist kostenlos und braucht keinen Zugriff auf Ihre Daten.

Bedenken?

Drei Dinge, die Händler vor der Anfrage wissen wollen

„Was kostet mich das am Ende?"

Vor dem Start gibt es ein schriftliches Angebot mit klarem Umfang und Preis. Keine offene Stundenuhr, keine Überraschungen - das Erstgespräch selbst ist kostenlos.

„Machen wir uns damit abhängig?"

Nein. Alles läuft über offizielle JTL-Schnittstellen, bleibt in Ihrem System und wird dokumentiert übergeben. Sie können jederzeit ohne uns weiterarbeiten.

„Was passiert mit unseren Daten?"

Ihre Daten bleiben in Ihrer Wawi. Welche Zugriffe wofür nötig sind, legen wir vorab gemeinsam fest - nachvollziehbar und auf das Nötige beschränkt.

Übrigens: upbox ist offizieller JTL-Servicepartner - auch für klassische JTL-Wawi-Beratung, Wartung und Auswertungen und die Betreuung von JTL-Shop.

Vom Werkzeug zum Ergebnis

Der MCP-Server ist unser Werkzeug. Das Ergebnis ist Ihr Datencheck.

Mit genau diesem Server durchleuchten wir JTL-Systeme auf das, was Zeit und Geld kostet: tote Artikel, Bestandsfehler, Margenfresser. Im kostenlosen Erstgespräch zeigen wir Beispiel-Funde an unserem Demo-Mandanten - ganz ohne Zugriff auf Ihre Daten. Ihre eigenen Funde liefert danach der Datencheck zum Festpreis, mit schriftlichem Ergebnis.

Im Termin gern auch live: der MCP-Server an Ihren Fragen. Oder schreiben Sie uns kurz.

Stand: August 2026 · zuletzt aktualisiert