JTL Wawi MCP Server: REST API und KI-Zugriff für Entwickler

Das Model Context Protocol (MCP) von Anthropic ermöglicht es KI-Agenten, strukturiert auf externe Datenquellen zuzugreifen. Mit einem JTL-Wawi MCP Server können Sie Tools wie Claude, ChatGPT oder Cursor direkt an Ihre JTL-Wawi Datenbank anbinden. Dieser Artikel erklärt die Architektur, die Einrichtung und die praktischen Einsatzmöglichkeiten für E-Commerce Unternehmen und Entwickler.

Wichtiger Hinweis: SQL2REST bietet ausschließlich read-only Zugriff auf Ihre JTL-Wawi Daten. Schreiboperationen sind nicht möglich. Sämtliche KI-Abfragen über den MCP-Server sind daher rein lesend und können Ihre Datenbank nicht verändern.

Was ist ein MCP Server und warum ist er für JTL Wawi relevant?

MCP steht für Model Context Protocol, einen offenen Standard von Anthropic. Er definiert, wie KI-Agenten auf externe Datenquellen und Tools zugreifen können, ohne dass Entwickler für jede Anbindung custom Code schreiben müssen. Der MCP-Server fungiert als Schnittstelle zwischen dem KI-Modell und der Datenquelle.

Für JTL-Wawi Benutzer bedeutet das: Statt manuell Berichte zu erstellen oder SQL-Abfragen zu formulieren, können Sie einem KI-Agenten in natürlicher Sprache Fragen stellen. Der Agent greift über den MCP Server automatisch auf Ihre JTL-Wawi Datenbank zu und liefert die Antwort. Ob Bestandsverwaltung, Retourenmanagement oder Power BI-Reporting - die Anwendungsmöglichkeiten sind vielfältig.

API-Architektur: Vom SQL Server zur JTL Wawi Datenbank

Die API-Architektur eines JTL-Wawi MCP Servers besteht aus drei Schichten:

1. JTL-Wawi Datenbank (MS SQL Server) - Ihre bestehende Warenwirtschaft mit allen Artikeln, Aufträgen und Kundendaten
2. SQL2REST - ein lokaler Windows Service mit integriertem MCP-Server, der die Datenbank als REST API und via MCP bereitstellt
3. KI-Agent (Claude Desktop, ChatGPT, Cursor) - der Benutzer interagiert hier in natürlicher Sprache

SQL2REST übernimmt die Schnittstellenentwicklung zwischen Ihrer JTL-Wawi Datenbank und dem MCP-Server. Die Implementierung läuft lokal auf Ihrem Server, sodass keine Daten an externe Dienste übertragen werden. Das macht die Lösung DSGVO-konform. Die Authentifizierung erfolgt über einen API-Schlüssel, den Sie im Admin-Bereich hinterlegen.

SQL2REST als REST API für JTL Wawi einrichten

SQL2REST installiert sich als Windows Service und erkennt Ihre JTL-Wawi Datenbank per Auto-Discovery Wizard automatisch. Nach der Registrierung und Konfiguration stellt der Service eine vollständige REST API mit OpenAPI/Swagger-Dokumentation bereit. Die Latenz liegt bei 50-200ms pro Abfrage.

Unterstützt werden alle JTL Editionen: Start, Advanced, Pro und Enterprise. Ebenso funktioniert SQL2REST mit JTL-Wawi v1.5, v1.6+ und dem neuen v2.0. Der Administrator kann mehrere Mandanten anbinden und über die URL verschiedene Datenbestände ansteuern. Die bereitgestellte API-Referenz im Swagger-Format ist Postman-ready und erleichtert Entwicklern die Integration. Die Developer-Community profitiert zusätzlich von der offenen REST-Schnittstelle, die sich mit gängigen APIs, SDKs und Resources integrieren lässt. Der integrierte MCP-Server unterstützt zwei Transporte: stdio für lokale KI-Clients auf demselben Rechner und HTTP (Streamable HTTP), damit auch mehrere Mitarbeiter im Team oder entfernte Clients denselben Server nutzen können.

Diese Funktion ist Teil des Team-Tarifs. Tarife vergleichen.

SQL2REST Preise für JTL (Early Bird)

Die aktuellen Preise sind Early-Bird-Konditionen und können sich ändern:

• Personal: 39 Euro/Monat (1 Mandant)
• Agency: 99 Euro/Monat (bis zu 5 Mandanten)
• Inklusive Remote-MCP für Teams (HTTP-Endpoint /mcp über das Netzwerk, ab Team-Tarif)
• 14 Tage kostenlos testen - keine Kreditkarte erforderlich

MCP-Server Authentifizierung und Konfiguration mit SQL2REST

Sobald SQL2REST läuft, können Sie den MCP Server einrichten. Für lokale KI-Clients (z.B. Cursor oder Windsurf) tragen Sie in der Konfigurationsdatei den Pfad zur sql2rest.exe mit dem Flag --mcp ein (stdio-Transport). Für Claude Desktop empfehlen wir den HTTP-Transport: Dort hinterlegen Sie in der claude_desktop_config.json die MCP-URL und Ihren API-Key als X-API-Key-Header. Das API-Dashboard zeigt URL und Key im Bereich MCP an. Der integrierte MCP-Server liest die übrige Konfiguration automatisch aus der config.ini und stellt 23 Tools bereit: Kunden suchen, Aufträge und Rechnungen filtern, Lagerbestände und Produkte abfragen, Lieferscheine und Sendungen lesen sowie - sofern freigeschaltet - Einkauf, Lieferanten und Wareneingänge.

Eine ausführliche Schritt-für-Schritt-Anleitung speziell für Claude Desktop, inklusive Config-Snippet, Beispiel-Prompts und fertigem Projekt-Template, finden Sie auf der Seite JTL-Wawi mit Claude Desktop via SQL2REST verbinden.

Da SQL2REST ausschließlich read-only arbeitet, ist die Berechtigung klar begrenzt: Der KI-Agent kann Daten auslesen, aber niemals verändern. Dieses Feature ist standardmäßig deaktiviert für Schreibzugriff und lässt sich nicht umgehen. Für Workflows, die Schreibzugriff erfordern, müssten Sie auf die offizielle JTL-Wawi API zurückgreifen. Beim HTTP-Transport authentifiziert sich jeder Client über den API-Key, sodass Sie den Zugriff jederzeit kontrollieren können. Bei der App-Registrierung für externe Zugriffe legen Sie zudem den Port nach Ihren Anforderungen fest.

Sobald der MCP-Server von mehreren Workstations über das öffentliche Internet erreichbar sein soll, kommt HTTPS dazu. SQL2REST liefert die Anwendung selbst über plain HTTP aus; HTTPS-Termination übernimmt ein vorgelagerter Reverse Proxy für SQL2REST (Cloudflare Tunnel als Default-Empfehlung, Caddy als DIY-Alternative). So bleibt der API-Key beim Multi-User-Setup auch außerhalb des LANs sicher. Multi-Workstation-MCP (HTTP-Endpoint von einem anderen Rechner) ist Teil des Team-Tarifs (Tarife vergleichen).

Automatische Workflows und Speicher Methoden für JTL Wawi

Ein JTL-Wawi MCP Server eröffnet zahlreiche Möglichkeiten, E-Commerce-Prozesse automatisieren und effizient verbessern zu können:

• Bestandsabfragen: "Welche Artikel haben weniger als 10 Stück auf Lager?" - der Agent durchsucht automatisch die Materialwirtschaft
• Auftragsanalyse: "Zeige alle offenen Aufträge der letzten 7 Tage" - ideal für tägliches Monitoring mit PRTG oder Zabbix
• Kundenrecherche: "Finde alle Bestellungen von Kunde X" - ohne manuelles Suchen in der Wawi
• Reporting: Automatische Zusammenfassungen für Umsatz, Retouren oder Lagerbestände
• Entwickler-Tools: Code-Assistenten wie Cursor können JTL-Daten direkt in Entwicklungs-Workflows einbinden

Diese Arbeitsabläufe sparen Zeit und reduzieren Fehler, weil der KI-Agent die Daten direkt aus der JTL-Wawi Datenbank bezieht, statt auf manuelle Exporte angewiesen zu sein. Für die Leitung der Entwicklungsabteilung bietet SQL2REST eine schnelle Evaluationsmöglichkeit ohne aufwendiges Onboarding.

JTL Wawi API vs. SQL2REST MCP-Server im Vergleich

Die offizielle JTL-Wawi API befindet sich derzeit in der Beta-Phase und ist kostenlos. Ob und wann sich die Preisstruktur ändert, ist noch nicht endgültig kommuniziert. Laut aktueller Preisliste sind nach der Beta folgende Kosten vorgesehen: Advanced 199 Euro/Monat API-Addon, Pro 99 Euro/Monat. Bei JTL Enterprise ist die API inklusive, bei JTL Start gibt es keinen API-Zugang.

Kriterium	JTL API (Beta)	SQL2REST + MCP
Zugriff	Read & Write	Read-Only
Kosten	Beta: kostenlos, danach 99-199 Euro/Monat	Ab 39 Euro/Monat (Early Bird)
JTL Editionen	Advanced, Pro, Enterprise	Alle (inkl. Start)
MCP-fähig	Nein (Erweiterung nötig)	Ja, integriert (stdio + HTTP)
Installation	Cloud/Plugin	Lokaler Windows Service
Datensicherung	Abhängig von JTL	Lokal, DSGVO-konform

Für E-Commerce Unternehmen, die primär Daten zugreifen und auslesen möchten, etwa für Shopware-Anbindungen, JTL-Shop-Integrationen oder Webanwendungen, ist SQL2REST die kostengünstigere Erweiterung. Wer Schreibzugriff benötigt, kommt an der offiziellen JTL-Wawi API nicht vorbei.

Häufige Fragen zum JTL Wawi MCP Server

Welche Schnittstelle verwendet JTL-Wawi?

JTL-Wawi bietet eine offizielle REST-API (aktuell Beta) für Lese- und Schreibzugriff. Zusätzlich lässt sich über SQL2REST eine Read-Only REST API direkt aus der MS SQL Server Datenbank generieren, die auch als MCP Server für KI-Agenten dient. Historisch nutzt JTL Wawi auch XML-basierte Speicher Methoden, APIs und SDKs sowie Resources für die Schnittstellenentwicklung. Für Monitoring-Zwecke können Tools wie PRTG oder Zabbix die Checks auf dem Servers übernehmen.

Ist der MCP Server kostenlos?

SQL2REST bietet eine 14-tägige kostenlose Testphase. Danach kostet der Service ab 39 Euro/Monat (Early Bird). Die JTL-Wawi API ist während der Beta-Phase kostenlos, danach fallen 99-199 Euro/Monat an. SQL2REST hat den MCP-Server direkt integriert. Er startet wahlweise lokal per stdio (--mcp) oder als HTTP-Endpoint und stellt 23 Tools bereit, darunter Kunden-, Auftrags-, Bestands- und Einkaufsabfragen.

Welche IP-Adresse muss der JTL-Wawi-Server haben?

Für den MCP Server mit SQL2REST genügt eine lokale IP-Adresse im Netzwerk, da SQL2REST als Desktop-Dienst auf demselben Server oder im selben Netzwerk wie die JTL-Wawi Datenbank läuft. Eine öffentliche IP ist nicht erforderlich.

Wie kann ich JTL-Wawi mit DHL verbinden?

Die DHL-Anbindung erfolgt über JTL-Shipping oder JTL-eazyAuction, nicht über den MCP Server. Der MCP Server eignet sich hingegen, um Versanddaten automatisch abzufragen und in KI-gestützte JTL-Workflows einzubinden.

Wie verbinde ich JTL-Wawi mit JTL-POS?

Die Verbindung zwischen JTL-Wawi und JTL-POS läuft über die integrierte JTL-WMS-Schnittstelle. Der MCP Server kann ergänzend genutzt werden, um POS-Daten aus der Wawi für Analysen auszulesen. Auch benutzerdefinierten Auswertungen sind so möglich.

Fazit: JTL Wawi MCP Server mit SQL2REST einrichten

Ein MCP Server für JTL-Wawi macht überall dort Sinn, wo Sie regelmäßig Daten aus Ihrer Warenwirtschaft automatisch abfragen und in Workflows einbinden möchten. Mit SQL2REST als Grundlage lässt sich die Anbindung in wenigen Minuten einrichten, funktioniert mit allen JTL Editionen und bleibt durch die lokale Installation DSGVO-konform.

Die Kombination aus SQL2REST und MCP ermöglicht es, KI-Agenten wie Claude oder ChatGPT als intelligente Assistenten für Ihr E-Commerce-Geschäft zu nutzen. Ob Bestandsverwaltung, Auftragsanalyse oder automatisches Reporting: Statt manueller Datenbankabfragen stellen Sie einfach eine Frage in natürlicher Sprache. Benutzer können so auf bereitgestellte Daten zugreifen, ohne SQL-Kenntnisse zu benötigen. Dank Pagination lassen sich auch umfangreiche Datenbestände über 1 Mio Einträge strukturiert abfragen.

Testen Sie SQL2REST 14 Tage kostenlos und prüfen Sie, ob ein MCP Server für Ihre JTL-Wawi den Arbeitsablauf Ihres Teams verbessert.