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. Nutzen Sie ein KI-Programm auf Ihrem Rechner, erreichen Ihre Datenbankinhalte unsere Server nicht; wir sehen nur Lizenz- und Aktualisierungsdaten: den Lizenzschlüssel, eine Gerätekennung, den Namen des Rechners, die Programmversion, die Anzahl der Aufrufe, einen Firmen-Fingerabdruck (ein nicht umkehrbarer Prüfwert aus Firmenname und USt-IdNr. Ihrer JTL-Firma, der den Schlüssel an Ihre Firma bindet) sowie die Angaben der automatischen Update-Abfrage (darunter Fassung, Installations-Kennung, Kanal; siehe Datenschutzerklärung Ziffer 3.9). Beim Zugriff aus dem Browser ist das anders, siehe Zugriff aus dem Browser. Jede Lizenz ist kostenlos bis 3.000 KI-Abfragen an die Datenbank im Monat (je Kalendermonat und Schlüssel); je Firma gibt es einen kostenlosen Schlüssel. Wer mehr braucht, nutzt für 15 € im Monat zzgl. MwSt. unbegrenzt.
Ab Werk liest die KI nur. Schreiben schalten Sie mit einem Klick frei: beim Zugriff aus dem Browser im Kundencenter unter Anbindungen → BIS AI Bridge (Abschnitt „Änderungen durch die KI“), beim lokalen Weg im Fenster der Brücke mit dem Schalter Änderungen erlauben. Läuft der Zugang aus dem Browser über die Brücke statt über BISConnect, ist Änderungen erlauben im Fenster der Brücke zusätzlich nötig.
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 (zum Windows Server bzw. Terminalserver siehe Auf einem RDP- bzw. Terminalserver). Starten Sie den Installer per Rechtsklick über Als Administrator ausführen — das ist der empfohlene Weg und vermeidet Rückfragen. Administratorrechte sind dafür nicht zwingend: Ohne sie, etwa auf einem verwalteten Firmenrechner, starten Sie die Datei per Doppelklick in Ihrem eigenen Konto, siehe Ohne Administratorrechte installieren. Auf einem Terminalserver startet jeder Benutzer die Installation selbst, siehe Auf einem RDP- bzw. Terminalserver.
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 — kostenlos, ohne Zahlungsdaten, aus dem Kundencenter unter my.bispicy.com; wie das geht, steht im nächsten Abschnitt. Ohne Schlüssel startet die Brücke nicht. Ein BISpicy-Mandant ist für den lokalen Weg nicht erforderlich.
Mac, iPad oder Tablet?
Die Brücke selbst gibt es nur für Windows. Vom Mac, iPad oder Android-Tablet aus nutzen Sie den Zugriff aus dem Browser (claude.ai oder ChatGPT). Dann muss irgendwo in Ihrem Netz ein Windows-Rechner die Verbindung zur Datenbank halten: entweder BISConnect (mit BISpicy (bisher BIS ERP)) oder die Brücke mit eingeschaltetem Zugriff aus dem Browser erlauben.
Kostenlosen Schlüssel holen
Die BIS AI Bridge ist kostenlos bis 3.000 KI-Abfragen im Monat je Schlüssel (ein kostenloser Schlüssel je Firma), darüber unbegrenzt für 15 € im Monat zzgl. MwSt., monatlich kündbar. Den Schlüssel aktivieren Sie einmal selbst im Kundencenter, bevor Sie die Brücke installieren. Zahlungsdaten brauchen Sie dafür nicht.
1
Im Kundencenter anmelden
Öffnen Sie my.bispicy.com und melden Sie sich an. Haben Sie noch kein Konto, klicken Sie unter der Anmeldung auf Kostenlos registrieren und bestätigen Sie anschließend Ihre E-Mail-Adresse über den Link in der Mail. Danach melden Sie sich mit derselben E-Mail-Adresse und demselben Passwort im Kundencenter an.
2
„Kostenlos aktivieren“
Links auf Anbindungen, oben auf den Reiter BIS AI Bridge. Im Kasten Kostenlos starten setzen Sie das Häkchen bei der Erklärung „Ich bestätige, dass ich nicht als Verbraucher (§ 13 BGB) handle, sondern als Unternehmer (§ 14 BGB) … und akzeptiere die AGB. Die Datenschutzerklärung habe ich zur Kenntnis genommen.“ Erst dann lässt sich Kostenlos aktivieren anklicken. Dieselbe Erklärung steht im Shop und beim Buchen der unbegrenzten Abfragen. Das Kundencenter meldet „Der kostenlose Schlüssel wurde angelegt.“
Kundencenter → Anbindungen → BIS AI Bridge, noch ohne Schlüssel (Demo-Betrieb, Stand November 2026). Mit Häkchen wird „Kostenlos aktivieren“ anklickbar.
3
Schlüssel kopieren
Nach dem Aktivieren steht oben „Lizenz aktiv“ und darunter der Abschnitt Lizenzschlüssel. Mit Kopieren übernehmen Sie den Schlüssel (er beginnt mit BISAI-); Sie tragen ihn gleich im Fenster der Brücke ein. Darunter sehen Sie den Stand des Monats, zum Beispiel „Diesen Monat 0 von 3.000 kostenlosen Abfragen“.
Der Schlüssel (hier geschwärzt) mit „Kopieren“, darunter der Monatsstand und „Unbegrenzt buchen“. Ab Werk darf die KI nur lesen.
Ein Schlüssel je Firma, beliebig viele Arbeitsplätze
Ein Schlüssel gilt für eine Firma, erkannt an Firmenname und USt-IdNr. in Ihrer JTL-Wawi; die Zuordnung geschieht beim ersten Start der Brücke von selbst. Denselben Schlüssel dürfen Sie auf beliebig vielen Arbeitsplätzen dieser Firma eintragen, die Abfragen zählen zusammen. Betreiben Sie mehrere JTL-Mandanten, braucht jeder einen eigenen Schlüssel: Häkchen bei der Erklärung setzen (dieselbe wie bei Kostenlos starten) und Weiteren Mandanten kostenlos hinzufügen klicken. Je Konto gibt es höchstens 10 Schlüssel.
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.
Als Administrator oder per Doppelklick? Ohne Administratorrechte installieren
Die Brücke wird immer in Ihr eigenes Windows-Benutzerkonto installiert (Ordner %LOCALAPPDATA%\BIS AI Bridge) und braucht dafür technisch keine Administratorrechte. Sind Sie auf dem Rechner selbst Administrator, ist Als Administrator ausführen der zuverlässigste Weg: Windows fragt nur nach einer Bestätigung, und die Brücke landet trotzdem in Ihrem Konto.
Ohne Administratorrechte, etwa auf einem verwalteten Firmenrechner: Verlangt Windows beim Weg über Als Administrator ausführen das Kennwort eines anderen Kontos, brechen Sie ab und starten Sie die Datei per normalem Doppelklick. Lassen Sie die Installation auch nicht von Ihrer IT mit deren eigenem Konto durchführen: Sonst landet die Brücke im Profil des Administrators, fehlt in Ihrem Startmenü, und Ihr KI-Programm findet sie nicht. Lässt Ihre IT das Ausführen heruntergeladener Programme gar nicht zu, bitten Sie sie, die Datei freizugeben, und starten Sie die Installation danach selbst in Ihrem Konto.
Auf einem Terminalserver gilt dasselbe: Dort startet jeder Benutzer die Installation selbst, per normalem Doppelklick. Siehe Abschnitt Auf einem RDP- bzw. Terminalserver.
Datenbank und Lizenz eintragen
Nach der Installation öffnet sich das Fenster der Brücke:
Feld
Woher
SQL Server, Benutzer, Passwort
Zugang zur JTL-Datenbank. Läuft BISConnect bereits auf dem Rechner, sind die Felder schon ausgefüllt.
Änderungen erlauben — steuert, ob die KI Daten schreiben darf. Bei neuen Installationen ist er ab Werk aus. 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. Ohne bestätigten Auftragsverarbeitungsvertrag nehmen wir aus dem Browser keine Anfrage an. Ohne BISConnect läuft dieser Weg außerdem nur, solange der Schalter in der Brücke an ist.
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.
Der Pfad zur bisai-mcp.exe in diesem Abschnitt gehört zu Ihrem Windows-Benutzer, er liegt im Ordner C:\Users\<Benutzer>\AppData\Local\BIS AI Bridge (Datei bisai-mcp.exe). In der Konfigurationsdatei von Claude Desktop steht jeder Backslash doppelt. Am einfachsten kopieren Sie deshalb den fertigen Abschnitt aus dem Fenster der BIS AI Bridge — dort stimmt der Pfad.
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
Werkzeug
Zweck
jtl_list_tables
Tabellen mit Zeilenzahl auflisten
jtl_describe_table
Spalten, Datentypen und Primärschlüssel einer Tabelle
Anlegen, Ä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.
Kostenlose Abfragen und was zählt
Jeder Schlüssel hat im Monat 3.000 kostenlose KI-Abfragen. Darüber gibt es unbegrenzte Abfragen für 15 € im Monat zzgl. MwSt., monatlich kündbar.
Was zählt: jeder Zugriff Ihrer KI auf die Datenbank, also Tabellen auflisten, den Aufbau einer Tabelle nachschlagen, Daten lesen und Daten ändern. Eine Frage an die KI löst oft mehrere solcher Zugriffe aus. Zugriffe, die das Regelwerk abweist, zählen nicht.
Zusammen gezählt: alle Arbeitsplätze mit demselben Schlüssel sowie der lokale Weg und der Zugriff aus dem Browser.
Zeitraum: der Kalendermonat nach deutscher Zeit. Am Monatsersten beginnt der Zähler neu.
Stand ansehen: im Kundencenter unter Anbindungen → BIS AI Bridge, zum Beispiel „Diesen Monat 1.250 von 3.000 kostenlosen Abfragen“.
Vorwarnung: Ab 80 % schicken wir Ihnen einmal im Monat eine E-Mail mit dem Stand. Beim Zugriff aus dem Browser erscheint zusätzlich ein Hinweis im Ergebnis der KI.
Wenn die kostenlosen Abfragen aufgebraucht sind
Es gehen keine Daten verloren und nichts wird automatisch abgebucht. Die KI meldet: „Die kostenlosen KI-Abfragen dieses Monats (3.000) sind aufgebraucht. Es gehen keine Daten verloren. …“, im Browser-Chat sofort, bei der lokalen Brücke beim nächsten Start. Danach haben Sie zwei Möglichkeiten:
Warten: Ab dem 1. des nächsten Monats geht es kostenlos weiter. Die Brücke auf Ihrem Rechner läuft nach einem Neustart wieder (Claude Desktop vollständig beenden und neu öffnen).
Unbegrenzt buchen: im Kundencenter beim Schlüssel, siehe Unbegrenzt buchen gleich hier unten.
Unbegrenzt buchen
1
„Unbegrenzt buchen (15 €/Monat)“ klicken
Im Kundencenter unter Anbindungen → BIS AI Bridge, im Abschnitt Lizenzschlüssel unter dem Monatsstand. Es öffnet sich der Dialog Unbegrenzt buchen; er nennt den Schlüssel, den Preis (15 € pro Monat zzgl. MwSt.) und die Laufzeit. Gebucht ist damit noch nichts.
2
Häkchen setzen und „Kostenpflichtig buchen“
Mit dem Häkchen bestätigen Sie, dass Sie nicht als Verbraucher, sondern als Unternehmer (§ 14 BGB) bzw. für eine juristische Person handeln, und akzeptieren die AGB. Erst dann wird Kostenpflichtig buchen anklickbar und öffnet die Bezahlseite. Abbrechen schließt den Dialog, ohne etwas zu buchen.
Der Dialog vor der Buchung (Demo-Betrieb, Stand November 2026). Erst mit dem Häkchen lässt sich „Kostenpflichtig buchen“ anklicken.
Das Abo gilt für diesen einen Schlüssel, hat keine Mindestlaufzeit und ist monatlich kündbar; nach einer Kündigung läuft der Schlüssel kostenlos weiter.
„Kostenpflichtig buchen“ bleibt grau: Das Häkchen fehlt. Ist es gesetzt und der Knopf trotzdem grau, fehlt Ihrem Zugang im Kundencenter das Recht zum Buchen; wenden Sie sich an den Administrator Ihres Kontos.
„Die Bezahlseite konnte nicht geöffnet werden.“ Es wurde nichts gebucht. Seite neu laden und noch einmal versuchen; bleibt die Meldung, über Kontakt melden.
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 und von dort an Ihre Datenbank, entweder über das BISConnect in Ihrem Netz (BISpicy) oder, ohne BISConnect, über die BIS AI Bridge mit eingeschaltetem Zugriff aus dem Browser erlauben. 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. Abfrage und Ergebnis liegen nur wenige Minuten in einer Warteschlange und werden danach gelöscht; ein Protokoll Ihrer Abfragen führen wir nicht. Nachzulesen in der Datenschutzerklärung, Abschnitt 4.1. Dieser Weg ist ab Werk ausgeschaltet und muss ausdrücklich freigegeben werden.
Antwortzeit: ein bis zwei Sekunden statt unter einer Sekunde.
Vorher zu erledigen
ChatGPT und claude.ai melden bei fehlenden Voraussetzungen lediglich einen allgemeinen Verbindungsfehler und nennen den Grund nicht. Erledigen Sie deshalb zuerst:
Läuft BISConnect in Ihrem Netz (BISpicy), ist nichts weiter zu installieren. Andernfalls im Fenster der Brücke Zugriff aus dem Browser erlauben einschalten und die Anwendung neu starten.
Im Kundencenter unter Anbindungen → BIS AI Bridge einmalig den Auftragsverarbeitungsvertrag bestätigen. Der Vertrag ist nötig, weil bei diesem Weg Ihre Abfragen über unsere Server laufen. Solange er fehlt, nehmen wir aus dem Browser bewusst keine Anfrage an.
Im selben Abschnitt Zugang aus dem Browser muss Zugang aus dem Browser erlauben eingeschaltet sein. Ist er aus, weisen wir Anmeldungen und Anfragen aus claude.ai und ChatGPT für diesen Schlüssel ab.
So sieht es fertig aus: Vertrag bestätigt, „Zugang aus dem Browser erlauben“ eingeschaltet (Demo-Betrieb).
Dieser Weg ist auch der richtige für Mac, iPad und Tablets: Dort läuft die Brücke nicht, der Browser-Chat schon.
Create bzw. Connector hinzufügen, Adresse: https://bispicy.com/api/mcp
Als Authentifizierung OAuth wählen und den Anmeldeschritt bestätigen
Im Chat den Connector über das Werkzeug-Menü aktivieren
Bei ChatGPT ist der Entwicklermodus nötig, weil dort ohne ihn nur Connectors mit Suchfunktion angeboten werden. Er setzt ein kostenpflichtiges Konto voraus (Plus, Pro, Business oder Enterprise) und ist je nach Region und Kontotyp unterschiedlich verfügbar.
Lesen und Schreiben
Aus dem Browser kann die KI ab Werk nur lesen. Ändernde Befehle (Anlegen, Ändern, Löschen) sind gesperrt und lassen sich mit einem Klick freischalten: im Kundencenter unter Anbindungen → BIS AI Bridge, Abschnitt Änderungen durch die KI. Versucht die KI trotzdem zu schreiben, bekommt sie eine Antwort mit genau diesem Weg. Massenänderungen, Strukturänderungen und Prozeduraufrufe brauchen zusätzlich eine eigene Freigabe, und jede Änderung ohne WHERE-Bedingung bleibt ohne die Freigabe für Massenänderungen gesperrt. Läuft der Zugang aus dem Browser über die Brücke statt über BISConnect, schalten Sie zusätzlich im Fenster der Brücke Änderungen erlauben ein.
Schlüssel neu ausstellen und Browser-Zugang abschalten
Im Kundencenter können Sie einen Lizenzschlüssel neu ausstellen, etwa wenn er in falsche Hände geraten sein könnte. Der alte Schlüssel ist sofort ungültig und bestehende Verbindungen werden getrennt; den neuen Schlüssel tragen Sie in der Brücke bzw. im Konnektor von claude.ai oder ChatGPT neu ein. Außerdem lässt sich der Zugang aus dem Browser je Schlüssel abschalten, ohne dass der lokale Weg betroffen ist. Der Inhaber des Betriebs sieht und verwaltet alle Schlüssel seines Betriebs.
Auf einem RDP- bzw. Terminalserver
Arbeiten Sie per Remotedesktop auf einem Server? Dann gilt ein Grundsatz: Ihr KI-Programm (zum Beispiel Claude Desktop) muss auf demselben Rechner und in derselben Windows-Sitzung laufen wie die BIS AI Bridge. Die Brücke spricht direkt mit dem KI-Programm, nicht über das Netzwerk. Dafür gibt es drei Wege. Am besten nutzen alle Benutzer eines Betriebs denselben Weg.
Weg A — alles auf dem Server
Jeder Benutzer installiert die Brücke selbst in seiner eigenen Remotedesktop-Sitzung, denn sie wird je Benutzer installiert. Jeder trägt in der Konfiguration seines KI-Programms seinen eigenen Pfad ein — den zeigt das Fenster der Brücke. Konfiguration und Protokoll liegen je Benutzer unter %APPDATA%\BIS AI Bridge\.
Auf dem Terminalserver: ohne Administrator
Jeder Benutzer startet die Installationsdatei in seiner eigenen Sitzung per normalem Doppelklick — nicht über Als Administrator ausführen. Administratorrechte brauchen Sie dafür nicht. Lassen Sie die Installation bitte nicht von Ihrer IT für den Benutzer durchführen: Sonst landet die Brücke im Profil des Administrators und nicht im Profil des Benutzers.
Server, Benutzer und Passwort der JTL-Datenbank trägt jeder Benutzer im Fenster der Brücke selbst ein. Vorausgefüllt sind die Felder nur für das Konto, unter dem BISConnect läuft.
Ehrlicher Hinweis
Anthropic sagt nicht ausdrücklich, dass Claude Desktop auf Windows Server läuft. Klappt es bei Ihnen nicht, nehmen Sie Weg B oder C.
Weg B — im Browser (empfohlen, wenn BISConnect läuft)
Sie nutzen claude.ai oder ChatGPT im Browser. Auf dem Server muss dafür kein KI-Programm laufen. Die Anleitung für den Konnektor steht im Abschnitt Zugriff aus dem Browser. Wie es auf dem Server aussieht, hängt davon ab, ob BISConnect läuft:
Mit BISConnect (BISpicy): Auf dem Server muss nichts installiert werden. Es braucht nur die Bestätigung des Auftragsverarbeitungsvertrags im Kundencenter und den Konnektor in claude.ai bzw. ChatGPT.
Ohne BISConnect: Die Brücke holt die Anfragen aus dem Browser selbst ab. Schalten Sie im Fenster der Brücke Zugriff aus dem Browser erlauben ein. Das klappt nur, solange die Brücke läuft: in einer Sitzung, die angemeldet bleibt (Remotedesktop trennen, nicht abmelden), oder auf einem Rechner, der durchläuft.
Weg C — die Brücke auf Ihrem eigenen PC
Sie installieren die Brücke auf Ihrem Arbeitsplatz-PC statt auf dem Server. Der PC braucht dafür Netzzugriff (im Firmennetz oder per VPN) auf den SQL Server Ihrer JTL-Instanz. Dessen Adresse tragen Sie im Fenster der Brücke im Feld SQL Server ein (Server\Instanz,Port).
Entscheidungshilfe: Welcher Weg passt?
Wo läuft Ihr KI-Programm?
Weg
Im Browser (claude.ai, ChatGPT)
Weg B
Auf dem Server, in Ihrer Remotedesktop-Sitzung
Weg A
Auf Ihrem eigenen PC
Weg C
JTL-Wawi beim Hoster oder auf einem gemieteten Server
„Cloud“ meint bei der BIS AI Bridge zweierlei. Der Zugriff aus dem Browser läuft über unsere Server. Hier geht es um den anderen Fall: Ihre JTL-Wawi läuft bei einem Hosting-Anbieter oder auf einem gemieteten Server, Sie arbeiten dort per Remotedesktop, der SQL-Port ist von außen nicht erreichbar, und oft dürfen Sie nichts installieren. Welcher Weg passt, hängt an zwei Fragen:
Entscheidungshilfe für eine gehostete JTL-Wawi
Ihre Lage beim Hoster
Weg
Sie dürfen in Ihrer Remotedesktop-Sitzung ein Programm starten (die Brücke installiert sich in Ihr Benutzerprofil, ohne Administratorrechte)
Weg A: Brücke und KI-Programm in Ihrer Sitzung beim Hoster. Ohne KI-Programm dort: Brücke mit Zugriff aus dem Browser erlauben und claude.ai oder ChatGPT (Weg B ohne BISConnect); die Sitzung muss dafür angemeldet bleiben.
BISConnect läuft bereits beim Hoster (Sie nutzen BISpicy)
Weg B: Beim Hoster ist nichts zu installieren. Sie brauchen nur den bestätigten Auftragsverarbeitungsvertrag und den Konnektor in claude.ai oder ChatGPT.
Der Hoster stellt ein VPN oder einen freigegebenen SQL-Zugang bereit
Weg C: Brücke auf Ihrem eigenen PC. Im Feld SQL Server tragen Sie die Adresse ein, die Ihnen der Hoster nennt, auch in der Form Server\Instanz,Port.
Nichts davon
Fragen Sie Ihren Hoster, siehe unten.
Was Sie Ihren Hoster fragen
Darf ich in meiner Remotedesktop-Sitzung ein eigenes Programm installieren und starten (Installation ins Benutzerprofil, ohne Administratorrechte)?
Gibt es ein VPN oder einen freigegebenen Zugang zum SQL Server der JTL-Wawi, und wie lautet die Adresse (Server, Instanz, Port)?
Welcher SQL-Benutzer mit Leserechten auf die JTL-Datenbank steht mir zur Verfügung?
Wenn es nicht läuft
Selbsttest ausführen
In der Eingabeaufforderung — der Pfad steht im Fenster der Brücke:
"%LOCALAPPDATA%\BIS AI Bridge\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.
Meldung
Ursache 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.
Meldungen zu Schlüssel und Kontingent
Diese Meldungen kommen von unserem Lizenzserver. Ihr KI-Programm bzw. das Fenster der Brücke zeigt sie im Wortlaut an.
Meldung (Anfang)
Ursache und Abhilfe
„Dieser Lizenzschlüssel ist unbekannt. Bitte im Kundencenter unter my.bispicy.com nachsehen …“
Der Schlüssel ist falsch eingetragen (Tippfehler, Leerzeichen) oder wurde im Kundencenter neu ausgestellt. Den aktuellen Schlüssel im Kundencenter kopieren und im Fenster der Brücke bzw. im Konnektor neu eintragen.
„Für diesen Betrieb gibt es bereits einen kostenlosen Schlüssel …“
Für dieselbe Firma (Firmenname und USt-IdNr. in JTL) ist in Ihrem Konto schon ein kostenloser Schlüssel im Einsatz. Tragen Sie diesen vorhandenen Schlüssel ein, er gilt für beliebig viele Arbeitsplätze. Mehr Abfragen gibt es über „Unbegrenzt buchen“.
„Dieser Lizenzschlüssel ist bereits einem anderen Betrieb zugeordnet …“
Meist ist bei mehreren JTL-Mandanten der Schlüssel des Nachbarmandanten eingetragen: Prüfen Sie, welcher Schlüssel zu welcher Firma gehört, und legen Sie für den zweiten Mandanten über „Weiteren Mandanten kostenlos hinzufügen“ einen eigenen an. Sind Sie umgezogen oder haben Sie umfirmiert, lösen Sie die Zuordnung, siehe Zuordnung lösen.
„Die kostenlosen KI-Abfragen dieses Monats (3.000) sind aufgebraucht …“
„Die Lizenz ist abgelaufen.“, „… wurde gekündigt.“ oder „… ist vorübergehend gesperrt.“
Der Schlüssel ist im Kundencenter nicht mehr aktiv. Im Kundencenter nachsehen und bei Bedarf einen neuen kostenlosen Schlüssel aktivieren.
„Der Zugang des Schlüssel-Inhabers wurde beendet. …“
Ein kostenloser Schlüssel gehört der Person, die ihn aktiviert hat. Wurde ihr Zugang beendet (zum Beispiel, weil sie den Betrieb verlassen hat), gilt der Schlüssel nicht mehr. Der Inhaber des Betriebs aktiviert im Kundencenter einen eigenen Schlüssel.
„Es laufen gerade zu viele Abfragen gleichzeitig …“ (nur aus dem Browser)
Je Schlüssel laufen höchstens drei Abfragen zugleich. Es wurde nichts ausgeführt und nichts gezählt; einen Moment warten und die Frage erneut stellen.
Umgezogen oder umfirmiert: Zuordnung lösen
Ein Schlüssel ist an die Firma gebunden, die beim ersten Start der Brücke in Ihrer JTL-Wawi stand (Firmenname und USt-IdNr.). Haben sich diese Angaben geändert, lösen Sie die Zuordnung im Kundencenter:
Im Kundencenter unter Anbindungen → BIS AI Bridge zum Abschnitt Firmenzuordnung gehen. Dort steht „Ihre Lizenz ist einem Betrieb zugeordnet.“ und daneben, wie viele Wechsel in den nächsten zwölf Monaten noch frei sind.
Zuordnung lösen klicken. Das Kundencenter fragt nach: „Zuordnung wirklich lösen? Das verbraucht einen der verbleibenden Wechsel (noch … in den nächsten zwölf Monaten). Beim nächsten Start der Brücke wird die Lizenz einem Betrieb neu zugeordnet.“
Mit Bestätigen lösen Sie die Zuordnung, das Kundencenter meldet „Die Zuordnung wurde gelöst.“ Mit Abbrechen bleibt alles, wie es war, und es wird kein Wechsel verbraucht.
Die Brücke neu starten (bzw. Claude Desktop vollständig beenden und neu öffnen). Dabei ordnet sie den Schlüssel der Firma zu, die jetzt in Ihrer JTL-Wawi steht.
Je Schlüssel sind drei Wechsel in zwölf Monaten möglich. Sind sie aufgebraucht, ist Zuordnung lösen grau; bei einem berechtigten Grund setzen wir die Zuordnung über den Support zurück. Wer einen zweiten JTL-Mandanten anbinden will, löst nicht die Zuordnung, sondern legt über „Weiteren Mandanten kostenlos hinzufügen“ einen eigenen Schlüssel an.
Browser-Chat meldet nur einen Verbindungsfehler
claude.ai und ChatGPT nennen den Grund nicht. Prüfen Sie der Reihe nach:
Im Kundencenter unter Anbindungen → BIS AI Bridge ist der Auftragsverarbeitungsvertrag bestätigt und Zugang aus dem Browser erlauben eingeschaltet.
Ohne BISConnect: Die Brücke läuft auf einem Rechner in Ihrem Netz, im Fenster ist Zugriff aus dem Browser erlauben eingeschaltet, und der Rechner bzw. die Remotedesktop-Sitzung bleibt angemeldet.
Mit BISConnect: BISConnect läuft und ist mit BISpicy verbunden.
Der Schlüssel im Konnektor ist der aktuelle. Nach „Schlüssel neu ausstellen“ den Konnektor neu verbinden.
Claude Desktop meldet „Server disconnected"
Pfad in der Konfiguration prüfen — mit doppelten Backslashes, genau wie im Fenster angezeigt.
Claude Desktop vollständig beenden, nicht nur das Fenster schließen.
Selbsttest ausführen (siehe oben) — läuft der durch, liegt es an der Konfigurationsdatei.
Hat jemand anderes installiert, etwa die IT mit ihrem eigenen Konto, liegt die Brücke in dessen Profil. Dann siehe den nächsten Abschnitt.
Die IT hat installiert, aber bei mir fehlt die Brücke
Symptom: Die BIS AI Bridge fehlt in Ihrem Startmenü, oder Claude Desktop meldet „Server disconnected“, obwohl die Installation durchgelaufen ist.
Ursache: Die Brücke wird in das Benutzerkonto installiert, das die Installation startet. Hat die IT sie mit ihrem eigenen Administratorkonto installiert, liegt sie in deren Profil und nicht in Ihrem.
Lösung: Melden Sie sich mit Ihrem eigenen Konto an und starten Sie die Installationsdatei per normalem Doppelklick (siehe Ohne Administratorrechte installieren). Tragen Sie Datenbank und Lizenzschlüssel ein und übernehmen Sie den Konfigurationsabschnitt erneut aus dem Fenster der Brücke, denn der Pfad gehört zu Ihrem Benutzer.
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
Nein — es genügen eine JTL-Wawi und ein Lizenzschlüssel. Für den Zugriff aus dem Browser stellt entweder BISConnect (mit BISpicy) oder die Brücke selbst die Verbindung her, siehe Zugriff aus dem Browser.
Ja. Ein Schlüssel gilt für einen Betrieb (einen JTL-Mandanten) und darf auf beliebig vielen Arbeitsplätzen dieses Betriebs laufen; die Abfragen aller Plätze zählen zusammen auf das Monatskontingent des Schlüssels. Für einen weiteren JTL-Mandanten legen Sie im Kundencenter einen eigenen Schlüssel an.
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.
Öffnen Sie das Fenster der BIS AI Bridge, zeigt es eine neue Fassung an: „Update auf Version … verfügbar.“ Mit „Jetzt installieren“ lädt die Brücke die neue Fassung, prüft ihre Signatur und spielt sie ein. „Installer herunterladen“ öffnet die Download-Seite, „Später“ blendet den Hinweis für diese Fassung aus.
Die BIS AI Bridge trägt kein Windows-Code-Signing-Zertifikat, deshalb kennt Windows den Herausgeber 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. Über Eigenschaften → Zulassen und im SmartScreen-Fenster über Weitere Informationen → Trotzdem ausführen lässt sich die Installation fortsetzen.
Ja. Die Brücke wird immer in Ihr eigenes Windows-Benutzerkonto installiert und braucht dafür keine Administratorrechte: Starten Sie die Datei per normalem Doppelklick. Lassen Sie sie nicht von der IT mit deren eigenem Konto installieren, sonst landet sie im Profil des Administrators, und Ihr KI-Programm findet sie nicht. Sind Sie auf dem Rechner selbst Administrator, ist Rechtsklick und Als Administrator ausführen der empfohlene Weg.
Der Schlüssel ist an Firmenname und USt-IdNr. aus Ihrer JTL-Wawi gebunden. Lösen Sie im Kundencenter unter Anbindungen → BIS AI Bridge im Abschnitt Firmenzuordnung die Zuordnung und bestätigen Sie die Rückfrage; beim nächsten Start ordnet die Brücke den Schlüssel der neuen Firma zu. Das verbraucht einen von drei Wechseln in zwölf Monaten. Schritt für Schritt: Zuordnung lösen.
Erstens den Pfad in der Konfiguration prüfen — er muss doppelte Backslashes enthalten, genau wie im Fenster der Brücke angezeigt. Zweitens Claude Desktop vollständig beenden, auch das Symbol in der Taskleiste. Drittens den Selbsttest bisai-mcp.exe --check ausführen: Läuft der durch, liegt es an der Konfigurationsdatei.
Die häufigste Ursache ist, dass der SQL Server keine TCP/IP-Verbindungen annimmt. Im SQL Server-Konfigurations-Manager unter Netzwerkkonfiguration TCP/IP aktivieren und den Dienst neu starten.
Jeder Zugriff wird in der Datei zugriffe.log im Ordner BIS AI Bridge unter %APPDATA% protokolliert. Diese Datei bleibt auf Ihrem Rechner und wird nicht übertragen.
Ab Werk liest die KI nur. Schreiben schalten Sie mit einem Klick frei: beim Zugriff aus dem Browser im Kundencenter unter Anbindungen → BIS AI Bridge im Abschnitt „Änderungen durch die KI“, beim lokalen Weg im Fenster der Brücke mit dem Schalter „Änderungen erlauben“. Läuft der Zugang aus dem Browser über die Brücke statt über BISConnect, ist „Änderungen erlauben“ im Fenster der Brücke zusätzlich nötig. Im Kundencenter können Sie außerdem einen Schlüssel neu ausstellen (der alte ist sofort ungültig) und den Zugang aus dem Browser je Schlüssel abschalten.
Ja, dafür gibt es drei Wege. Grundsatz: Brücke und KI-Programm müssen auf demselben Rechner und in derselben Windows-Sitzung laufen. Weg A: alles auf dem Server; jeder Benutzer startet die Installationsdatei in seiner eigenen Sitzung per normalem Doppelklick, nicht als Administrator (Anthropic nennt Windows Server für Claude Desktop nicht ausdrücklich). Weg B: im Browser. Mit BISConnect muss auf dem Server nichts installiert werden, es braucht nur die Bestätigung des Auftragsverarbeitungsvertrags im Kundencenter und den Konnektor in claude.ai oder ChatGPT. Ohne BISConnect läuft die Brücke mit dem Schalter „Zugriff aus dem Browser erlauben“ in einer Sitzung, die angemeldet bleibt (trennen, nicht abmelden), oder auf einem Rechner, der durchläuft. Weg C: Brücke auf dem eigenen PC, der den SQL Server im Netz oder per VPN erreicht. Am besten nutzen alle Benutzer eines Betriebs denselben Weg. Details im Abschnitt „Auf einem RDP- bzw. Terminalserver“.
Sie ist kostenlos bis 3.000 KI-Abfragen im Monat je Schlüssel (ein kostenloser Schlüssel je Firma), darüber unbegrenzt für 15 € im Monat zzgl. MwSt., monatlich kündbar. Den kostenlosen Schlüssel aktivieren Sie im Kundencenter unter Anbindungen → BIS AI Bridge ohne Zahlungsdaten.
Jeder Zugriff Ihrer KI auf die Datenbank: Tabellen auflisten, den Aufbau einer Tabelle nachschlagen, Daten lesen oder ändern. Eine Frage an die KI löst oft mehrere Zugriffe aus. Abgewiesene Zugriffe zählen nicht. Alle Arbeitsplätze mit demselben Schlüssel und der Zugriff aus dem Browser zählen zusammen, den Stand sehen Sie im Kundencenter.
Es gehen keine Daten verloren und nichts wird automatisch abgebucht. Die Brücke meldet im KI-Programm, dass die kostenlosen Abfragen des Monats aufgebraucht sind – im Browser-Chat sofort, bei der lokalen Brücke beim nächsten Start. Zum Monatsersten geht es kostenlos weiter (die lokale Brücke nach einem Neustart), oder Sie schalten sofort unbegrenzte Abfragen für 15 € pro Monat zzgl. MwSt. frei. Das Abo ist monatlich kündbar; danach läuft der Schlüssel wieder kostenlos weiter.
Die Brücke selbst läuft nur unter Windows. Vom Mac, iPad oder Tablet aus nutzen Sie den Zugriff aus dem Browser über claude.ai oder ChatGPT. Dafür hält in Ihrem Netz ein Windows-Rechner die Verbindung zur Datenbank: BISConnect (mit BISpicy) oder die Brücke mit eingeschaltetem „Zugriff aus dem Browser erlauben“.
Ja, wenn eine dieser Bedingungen erfüllt ist: Sie dürfen in Ihrer Remotedesktop-Sitzung ein Programm installieren (die Brücke braucht dafür keine Administratorrechte), beim Hoster läuft bereits BISConnect, oder der Hoster stellt ein VPN bzw. einen freigegebenen SQL-Zugang bereit. Sonst fragen Sie Ihren Hoster; die drei Fragen dazu stehen im Abschnitt „JTL-Wawi beim Hoster“.
