Zum Inhalt springen

JTL Wawi mit Claude Desktop via SQL2REST verbinden

Fragen Sie Ihre JTL-Wawi in normaler Sprache: Kunden, Aufträge, Artikel und Lager, direkt in Claude Desktop. Über den eingebauten MCP-Server, nur lesend und self-hosted.

Nur-Lese-API: Ihre ERP-Daten werden nie verändert

So funktioniert es

1

Installieren

SQL2REST auf Ihrem Server starten. Der Wizard erkennt Ihre Datenbank automatisch.

2

Verbinden

REST-Endpunkte sind sofort verfügbar, keine manuelle Konfiguration nötig.

3

Automatisieren

Claude liest Ihre JTL-Daten per MCP-Server (nur lesend) und antwortet in normaler Sprache.

JTL Wawi und Claude über MCP verbinden

SQL2REST stellt Ihre JTL-Wawi als read-only REST API und als MCP-Server bereit. Claude Desktop spricht über das Model Context Protocol (MCP) von Anthropic direkt mit dieser Schnittstelle und beantwortet Ihre Fragen per Datenbankabfragen, ohne dass Sie SQL schreiben. Alles läuft lokal auf Ihrem Server, es verlassen keine Daten Ihr Haus.

Wie das Protokoll im Detail funktioniert, erklärt unser Leitfaden zum JTL-Wawi MCP Server. Auf dieser Seite zeigen wir die konkrete Einrichtung für Claude Desktop.

Beispiel-Fragen, die sofort funktionieren

Top-Kunden

„Zeig mir die Top-10-Kunden nach Umsatz im März." Claude holt die Aufträge, gruppiert und liefert eine fertige Tabelle.

Artikel nach Merkmal

„Welche Artikel gibt es in Rot, Größe M?" Claude nutzt die Merkmale-Filter und listet die passenden SKUs.

Offene Aufträge

„Wie viele offene Aufträge hat Kunde 10001?" Claude fragt direkt nach und antwortet in Sekunden.

Welche JTL Wawi Daten Claude sieht

Über die Anbindung greift Claude auf die wichtigsten Bereiche Ihrer Warenwirtschaft zu. Jeder Zugriff ist read-only: Claude liest und wertet aus, kann aber nichts verändern oder löschen.

  • Kunden und Kundendaten
  • Aufträge und Auftragspositionen
  • Rechnungen und Rechnungs-PDFs
  • Artikel, Merkmale und Varianten
  • Lagerbestände je Lager
  • Lieferscheine und Sendungen
  • Einkauf: Lieferanten, Bestellungen, Wareneingänge (optional)
  • Mehrere Mandanten in einer Abfrage

Lokal statt Cloud: keine Synchronisation nötig

Anders als eine Cloud-Anbindung synchronisiert SQL2REST nichts in eine externe Cloud. Statt Daten manuell zu exportieren oder über einen Cloud-Dienst zu synchronisieren, fragt Claude sie automatisch und in Echtzeit direkt aus Ihrer JTL-Wawi ab. Das hält die Antworten aktuell, die Latenz niedrig und Ihre Daten DSGVO-konform auf dem eigenen Server. Eine SQL2REST-Installation lässt sich in wenigen Minuten einrichten und mit jeder unterstützten JTL-Wawi-Version betreiben.

In 3 Minuten verbunden

Claude Desktop verbindet MCP-Server über seine Konfigurationsdatei. URL und API-Key sehen Sie im API-Dashboard (Bereich MCP). Einmal eintragen, fertig:

claude_desktop_config.json
{
  "mcpServers": {
    "SQL2REST": {
      "type": "http",
      "url": "http://ihr-server:8000/mcp",
      "headers": {
        "X-API-Key": "ihr-api-key"
      }
    }
  }
}

Hinweis: Der „Connector hinzufügen"-Dialog in Claude Desktop kann nur OAuth, der API-Key gehört in diese Datei. Die claude.ai-Web-Version unterstützt statische API-Keys aktuell nicht, nutzen Sie dort Claude Desktop.

Für mehrere Workstations über das Internet brauchst du HTTPS vor SQL2REST. Anleitung: Reverse Proxy für SQL2REST (Cloudflare Tunnel oder Caddy).

Hinweis: Remote-Zugriff von anderen Arbeitsplätzen (alle URLs außer localhost) erfordert den Agency-Tarif. Tarif anzeigen.

Für Entwickler: die vollständige REST-Referenz liegt im interaktiven Swagger-UI unter /docs

Auch für Claude Code, Cursor und Windsurf

Der MCP-Server ist nicht auf Claude Desktop beschränkt. Claude Code, Cursor und Windsurf sprechen denselben MCP-Endpoint nativ an. Claude Desktop nutzt den HTTP-Transport mit API-Key, die übrigen Clients binden den Server analog über ihre eigene Konfiguration ein. Eine SQL2REST-Installation bedient alle gleichzeitig.

JTL-Wawi verbinden in wenigen Minuten

Die Einrichtung ist schnell: SQL2REST installieren, den Server einrichten, fertig. Der ganze Einrichtungsprozess dauert nur wenige Minuten, danach lässt sich Claude an Ihre JTL-Wawi anbinden. SQL2REST kann die JTL-Wawi Daten read-only bereitstellen und hält den Server automatisch im Live-Betrieb, ohne dass Sie etwas nachstarten müssen.

Die Verbindung zwischen JTL-Wawi und Claude läuft über den lokalen MCP-Endpoint, Claude liest dabei direkt aus der SQL Server Datenbank. Der Zugriff auf die JTL-Wawi erfolgt ausschließlich lesend; die Verbindung zu JTL-Wawi baut der Client über den API-Key auf. Anpassungen wie Port oder Schlüssel nehmen Sie jederzeit vor, auch im laufenden E-Commerce-Betrieb.

Voraussetzungen und Performance

SQL2REST läuft als lokaler Dienst unter Windows, standardmäßig auf Port 8080. Für den Zugriff genügt eine stabile Internetverbindung zwischen Claude und Ihrem Server. Die Antwortzeiten liegen typischerweise bei 50 bis 200 ms pro Abfrage, da die Daten direkt aus der SQL-Server-Datenbank kommen und nicht erst über eine Cloud synchronisiert werden müssen. So bleibt die Latenz niedrig, auch bei großen Datenbeständen mit Pagination über viele Datensätze.

Authentifizierung über API-Key

Jeder Zugriff ist über einen API-Key abgesichert, den Sie im Admin-Bereich konfigurieren. SQL2REST nutzt standardmäßig den Standard-Port 8080; der Administrator kann Ports und Login je nach Setup anpassen. So binden Sie Claude sicher an Ihre JTL-Wawi an, ohne SA-Zugangsdaten weiterzugeben oder Daten an externe Web-Anwendungen zu übergeben.

Plus: fertiges Projekt-Template

Der MCP-Server gibt Claude die Werkzeuge, das mitgelieferte Projekt-Template gibt Claude das Wissen: typische Auswertungs-Flows, das Mandanten-Modell und Beispiel-Prompts. Einfach in ein Claude-Projekt einfügen, fertig. Ideal für Teams, jeder Mitarbeiter legt ein eigenes Projekt mit demselben Template an.

Projekt-Anweisungen zum Kopieren

Claude Project → Custom Instructions
# SQL2REST fuer JTL-Wawi - Projekt-Anweisungen

Du bist ein Assistent fuer ein Unternehmen, das JTL-Wawi nutzt. Ueber SQL2REST
hast du read-only Zugriff auf die JTL-Datenbank: Kunden, Auftraege, Rechnungen,
Artikel, Merkmale, Lager, Lieferscheine und (optional) Einkauf.

Regeln:
- Nutze die SQL2REST-MCP-Tools fuer jede Datenabfrage, erfinde keine Zahlen.
- Authentifizierung laeuft automatisch ueber den Connector, frage nie nach Keys.
- Antworte auf Deutsch, fasse Ergebnisse als Tabelle oder Top-Liste zusammen.
- Datumsfilter immer YYYY-MM-DD. In Multi-Mandanten-Setups erst klaeren,
  welcher Mandant gemeint ist.

Typische Workflows:
- "Top-Kunden im März" -> list_orders mit Zeitraum, nach Kunde gruppieren.
- "Artikel in Rot, Groesse M" -> erst list_attributes, dann
  filter_products_by_attribute.
- "Offene Auftraege von Kunde 10001" -> list_orders mit customer-Filter.

Das ist der einsatzbereite Kern. Die vollständige Version mit allen 23 Tools und Beispiel-Prompts (Deutsch und Englisch) liegt im Ordner claude-desktop-template Ihrer SQL2REST-Installation.

Häufige Fragen

Womit kann Claude eine Verbindung herstellen?

Claude verbindet sich über das Model Context Protocol (MCP) mit externen Datenquellen. Für JTL-Wawi stellt SQL2REST den passenden MCP-Server bereit, sodass Claude Desktop direkt auf Ihre Warenwirtschaft zugreift, ganz ohne eigene Programmierung.

Wie verbinde ich MCP mit Claude?

In Claude Desktop tragen Sie den MCP-Server in der claude_desktop_config.json ein: die URL und den API-Key Ihres SQL2REST-Servers. Nach einem Neustart steht das JTL-Tool in Claude bereit. Den genauen Block finden Sie oben im Abschnitt zur Einrichtung.

Welche Schnittstelle verwendet JTL-Wawi?

JTL-Wawi speichert seine Daten in einer Microsoft-SQL-Server-Datenbank. SQL2REST legt darüber eine read-only REST API und einen MCP-Server, über die Claude die Daten per Datenbankabfragen ausliest.

Brauche ich HTTPS, wenn mehrere Mitarbeiter zugreifen?

Für ein Team oder Zugriff über das Internet sollten Sie SQL2REST über HTTPS absichern. Wie Sie einen Reverse Proxy mit Cloudflare Tunnel oder Caddy einrichten, zeigt unser HTTPS-Leitfaden.

Bereit loszulegen?

Starten Sie in wenigen Minuten. Keine komplizierte Einrichtung, keine Cloud-Abhängigkeit.