Zum Hauptinhalt springen

BIS AI Bridge einrichten

Die JTL-Datenbank über das Model Context Protocol mit Claude, ChatGPT oder Cursor verbinden.

Produktseite Zurück zur Übersicht

Überblick

Die BIS AI Bridge ist ein kleines Windows-Programm, das Ihre JTL-Datenbank als MCP-Server bereitstellt. Ihr KI-Programm startet die Brücke selbst und kann darüber Ihre Daten lesen und — wenn Sie es erlauben — ändern.

Die Brücke läuft auf Ihrem Rechner und spricht direkt mit Ihrem SQL Server. Ihre Datenbankinhalte erreichen unsere Server nicht; wir sehen nur den Lizenzschlüssel, eine Gerätekennung und die Anzahl der Aufrufe. Daraus folgt auch, dass es keine Nutzungsgrenze gibt: Die tausendste Abfrage kostet uns so viel wie die erste.

Was ist MCP?

Das Model Context Protocol ist eine offene Schnittstelle, über die eine KI Werkzeuge aufrufen kann. Die Brücke bietet vier davon an — Tabellen auflisten, Aufbau nachschlagen, Daten lesen, Daten ändern. Alles, was die KI mit Ihrer Datenbank tut, geht durch diese vier Werkzeuge.

Voraussetzungen

  • JTL-Wawi mit erreichbarem SQL Server. Der Rechner, auf dem die Brücke läuft, muss die Datenbank erreichen — das kann der JTL-Server selbst sein oder ein Arbeitsplatz im selben Netz.
  • Windows 10 oder 11. Starten Sie den Installer per Rechtsklick über Als Administrator ausführen — das ist der empfohlene Weg und vermeidet Rückfragen. Auf verwalteten Firmenrechnern übernimmt das üblicherweise Ihre IT.
  • Ein KI-Programm auf demselben Rechner — etwa Claude Desktop oder Cursor. Für Browser-Chats siehe den Abschnitt Zugriff aus dem Browser.
  • Ein Lizenzschlüssel aus dem Kundencenter unter my.bispicy.com. Ein BIS-ERP-Mandant ist für den lokalen Weg nicht erforderlich.

Installation

1
Herunterladen

Die Datei BISAIBridge-Setup.exe über die Download-Seite holen. Meldet der Browser „wird selten heruntergeladen", über das Menü neben der Meldung Behalten wählen.

2
Datei freigeben — der entscheidende Schritt

Windows markiert heruntergeladene Dateien als „aus dem Internet". Diese Markierung entfernen: rechte Maustaste auf die Datei → Eigenschaften → im Reiter Allgemein ganz unten das Häkchen bei Zulassen setzen → OK. Fehlt das Häkchen ganz, ist die Datei bereits freigegeben.

3
Als Administrator ausführen

Rechte Maustaste auf die Datei → Als Administrator ausführen. Erscheint das blaue Fenster „Der Computer wurde durch Windows geschützt": auf Weitere Informationen klicken (der Link ist leicht zu übersehen), dann auf Trotzdem ausführen.

Warum Windows überhaupt warnt

Die Brücke trägt kein Windows-Code-Signing-Zertifikat. Windows kennt den Herausgeber deshalb nicht und blockiert die Datei vorsorglich. Das ist keine Fehlfunktion und kein Hinweis auf Schadsoftware — Windows verhält sich bei jeder nicht zertifizierten Anwendung so, unabhängig davon, was sie tut.

Warum als Administrator

Windows fragt dabei nach einer Bestätigung beziehungsweise nach einem Kennwort. Der Weg über Als Administrator ausführen ist der zuverlässigste — er räumt Rechte- und Schreibprobleme von vornherein aus dem Weg. Arbeiten Sie auf einem verwalteten Firmenrechner, lassen Sie die Installation von Ihrer IT durchführen; danach läuft die Brücke im normalen Benutzerbetrieb.

Datenbank und Lizenz eintragen

Nach der Installation öffnet sich das Fenster der Brücke:

FeldWoher
SQL Server, Benutzer, Passwort Zugang zur JTL-Datenbank. Läuft BISConnect bereits auf dem Rechner, sind die Felder schon ausgefüllt.
Lizenzschlüssel Kundencenter unter my.bispicy.com → BIS AI Bridge

Dann Verbindung testen, danach Speichern.

Zwei Schalter, die Sie kennen sollten
  • Änderungen erlauben — steuert, ob die KI Daten schreiben darf. Ausgeschaltet bietet die Brücke nur die lesenden Werkzeuge an.
  • Zugriff aus dem Browser erlauben — schaltet den Weg über unsere Server für Browser-Chats frei. Solange dieser Schalter aus ist, verlassen Ihre Daten Ihr Netzwerk nicht.

KI-Programm verbinden

Die Brücke zeigt einen fertigen Konfigurationsabschnitt an. Über den Knopf In die Zwischenablage kopieren und im KI-Programm einfügen:

  • Claude Desktop: Einstellungen → Entwickler → Konfiguration bearbeiten
  • Cursor: in die MCP-Konfiguration des Editors
Vollständig beenden, nicht nur schließen

Claude Desktop danach vollständig beenden — auch das Symbol in der Taskleiste — und neu starten. Ein bloßes Schließen des Fensters reicht nicht; das ist die häufigste Ursache dafür, dass die Werkzeuge nicht auftauchen.

Danach fragen Sie einfach los: „Welche Artikel liegen seit über 90 Tagen ohne Verkauf im Lager?" Die KI sucht sich die passenden Tabellen selbst zusammen.

Werkzeuge und Grenzen

WerkzeugZweck
jtl_list_tablesTabellen mit Zeilenzahl auflisten
jtl_describe_tableSpalten, Datentypen und Primärschlüssel einer Tabelle
jtl_queryLesende Abfragen, standardmäßig 200 Zeilen, maximal 1.000
jtl_writeAnlegen, Ändern, Löschen — nur wenn Änderungen erlauben aktiv ist
Änderungen sind sofort wirksam

Was die KI schreibt, steht sofort in Ihrer produktiven Datenbank und lässt sich nicht per Knopfdruck zurücknehmen. Ein Regelwerk weist gefährliche Anweisungen zwar ab — etwa das Leeren oder Verwerfen ganzer Tabellen —, es ersetzt aber kein Backup. Wer nur auswerten will, schaltet Änderungen erlauben aus.

Zugriffsprotokoll

Jeder Zugriff wird protokolliert, in %APPDATA%\BIS AI Bridge\zugriffe.log. Diese Datei bleibt auf Ihrem Rechner und wird nicht an uns übertragen.

Zugriff aus dem Browser

Ein Chat im Browser — etwa claude.ai oder ChatGPT — kann kein Programm auf Ihrem Rechner starten und die lokale Brücke deshalb nicht nutzen. Für diesen Fall betreiben wir den MCP-Server selbst: Die Abfrage geht an unsere Server, wird an das BISConnect in Ihrem Netz weitergereicht und von dort an Ihre Datenbank gestellt. Die Antwort läuft denselben Weg zurück.

Hier ist der Datenweg ein anderer

Anders als beim lokalen Weg laufen Ihre Abfragen und deren Ergebnisse über unsere Server. Wir verarbeiten sie als Auftragsverarbeiter nach Art. 28 DSGVO und löschen das Ergebnis unmittelbar nach der Auslieferung. Nachzulesen in der Datenschutzerklärung, Abschnitt 4.1. Dieser Weg ist ab Werk ausgeschaltet und muss ausdrücklich freigegeben werden.

Voraussetzung ist eine BIS-ERP-Anbindung mit installiertem BISConnect. Antwortzeit: ein bis zwei Sekunden statt unter einer Sekunde.

Wenn es nicht läuft

Selbsttest ausführen

In der Eingabeaufforderung — der Pfad steht im Fenster der Brücke:

bisai-mcp.exe --check

Der Selbsttest zeigt, woher die Zugangsdaten stammen, welcher Server und welche Datenbank verwendet werden, ob Schreibrechte aktiv sind, und testet die Verbindung.

MeldungUrsache und Abhilfe
„Es fehlen Zugangsdaten" Server oder Benutzer sind nicht eingetragen — im Fenster nachtragen und speichern.
„Die Datenbank ist nicht erreichbar" Häufigste Ursache: Der SQL Server nimmt keine TCP/IP-Verbindungen an. Im SQL Server-Konfigurations-Manager unter Netzwerkkonfiguration TCP/IP aktivieren und den Dienst neu starten.
„Kein Lizenzschlüssel hinterlegt" Schlüssel aus dem Kundencenter im Fenster eintragen und speichern.

Claude Desktop meldet „Server disconnected"

  1. Pfad in der Konfiguration prüfen — mit doppelten Backslashes, genau wie im Fenster angezeigt.
  2. Claude Desktop vollständig beenden, nicht nur das Fenster schließen.
  3. Selbsttest ausführen (siehe oben) — läuft der durch, liegt es an der Konfigurationsdatei.

Windows blockt trotz aller Schritte

Manche Virenscanner greifen unabhängig von Windows. In diesem Fall die Datei im Virenscanner als Ausnahme eintragen oder den Scanner kurz pausieren.

Häufige Fragen

Für den lokalen Weg nicht — es genügen eine JTL-Wawi und ein Lizenzschlüssel. Nur der Zugriff aus dem Browser setzt eine BIS-ERP-Anbindung mit installiertem BISConnect voraus.

Die Lizenz ist an ein Gerät gebunden. Sollen mehrere Arbeitsplätze die Brücke nutzen, buchen Sie im Kundencenter entsprechend viele Lizenzen.

Zum Auswerten genügt ein Benutzer mit Leserechten auf der JTL-Datenbank — das ist zugleich der sicherste Einstieg. Sollen Daten geändert werden, braucht der Benutzer zusätzlich Schreibrechte auf den betroffenen Tabellen.

Automatisch. Neue Fassungen werden signiert ausgeliefert und beim Start eingespielt; Sie müssen nichts nachinstallieren.
BIS AI Bridge herunterladen Zur Produktseite Frage stellen