Häufige Fragen

FAQ — Versino KI SAP B1 MCP

Installation, Lizenzarten und Betrieb — kurz und konkret. Noch offen? Kontakt oder support@versino.de.

Installation & Inbetriebnahme

Wie installiere ich den MCP-Server?
  1. Aktuelles Binary aus dem Bezugs-Repository laden — Windows (.exe) oder Linux (64-bit).
  2. Ihre Lizenzdatei versino.key in denselben Ordner legen (wird automatisch neben dem Binary gefunden — kein Pfad nötig).
  3. Eine .env mit SAP_BASE_URL, SAP_DATABASES und SAP_AUTH_MODE anlegen und den Server starten.

Schritt-für-Schritt-Anleitungen für Windows und Linux (inkl. Windows-Dienst) liegen im Bezugs-Repository unter docs/.

Welche Systemvoraussetzungen gibt es?
  • 64-bit Windows 10/11 / Server 2019+ oder 64-bit Linux (glibc, x86-64).
  • Netzwerkzugriff auf Ihren SAP-B1-Service Layer (https://<host>:50000/b1s/v2/).
  • Eine gültige versino.key (Edition BASIC/PRO/ENTERPRISE).
  • Für Nur-stdio-Clients: Node.js (für die mcp-remote-Brücke).
Wie binde ich den Server an Claude Desktop oder andere LLM-Clients an?

Der Server spricht Streamable HTTP unter http://<host>:8000/mcp.

  • Streamable-HTTP-fähige Clients (Claude Desktop „Custom Connector", Cline, Continue, Cursor …): direkt auf die /mcp-URL zeigen.
  • Nur-stdio-Clients oder reines http://: Brücke npx mcp-remote http://<host>:8000/mcp.

Für Netzwerkbetrieb wird ein vorgelagerter Reverse-Proxy mit TLS empfohlen.

Lizenzarten im Detail

FunktionBASICPROENTERPRISE
Preis (€/Nutzer·Monat) 52050
Daten lesen nur Stammdaten¹alle Datenalle Daten
Schreiben (anlegen / ändern)
Löschen & Belegaktionen
Verknüpfungen ($expand) & AI_*-Reports
Abfragen / Stunde 60600unbegrenzt
Zeilen / Abfrage 501.000unbegrenzt

¹ Stammdaten = Geschäftspartner, Artikel, Preislisten, Lager, … — Transaktionsdaten (Rechnungen, Aufträge, Buchungen) sind ab PRO lesbar.

Was kann die BASIC-Edition genau — und was nicht?

Kann: Stammdaten lesen (Geschäftspartner, Artikel, Preislisten, Lager, Mitarbeiter, Währungen …) inkl. unscharfer Suche.

Kann nicht: Transaktionsdaten lesen (Rechnungen, Aufträge, Lieferungen, Buchungen), Verknüpfungen über $expand, die geprüften AI_*-SQL-Reports — und kein Schreiben. Gedeckelt auf 60 Abfragen/Stunde und 50 Zeilen je Abfrage.

Wer „viel lesen, aber nichts schreiben" braucht, ist meist mit PRO richtig (voller Lese-Umfang) — sprechen Sie uns sonst an.

Welche Edition brauche ich?
  • BASIC — Nachschlagen von Stammdaten in kleinem Umfang.
  • PRO — die übliche Wahl: Auswertungen über alle Daten und Anlegen/Ändern von Belegen.
  • ENTERPRISE — zusätzlich Löschen und Belegaktionen (z. B. Auftrag schließen) sowie unbegrenzte Volumina.
Gelten zusätzlich die SAP-Berechtigungen?

Ja. Die Edition gibt nur den Rahmen vor — am Ende setzt SAP Business One die Rechte des angemeldeten Nutzers 1:1 durch. Zusätzlich lässt sich die ganze Instanz per SAP_OPERATION_MODE=READ_ONLY komplett schreibsperren.

Lizenz & Schlüssel

Was ist die versino.key und wie wende ich sie an?

Eine signierte Offline-Lizenzdatei. Nach dem Kauf erhalten Sie sie per E-Mail und über Ihr Kundenportal. Legen Sie sie neben das Binary — sie wird automatisch erkannt. Ohne gültige Lizenz startet der Server nicht.

Was ist ein „Seat" und wie wird gezählt?

Ein Seat = ein distinkter SAP-Anwender, der sich verbindet. Reconnect desselben Nutzers verbraucht keinen zusätzlichen Seat; Trennen gibt ihn wieder frei. Mehrere Instanzen einer Firma teilen sich die Seat-Zahl der Lizenz.

Was passiert bei Ablauf — wie funktioniert die Verlängerung?

Bei laufendem Abo verlängert sich die Lizenz automatisch. Ist das optionale „Phone-Home" aktiviert, übernimmt die Installation den erneuerten Schlüssel selbst — kein manueller Schlüsseltausch pro Abrechnungszeitraum. Andernfalls erhalten Sie rechtzeitig eine neue versino.key.

Funktioniert der Server offline / air-gapped?

Ja. Die Lizenzprüfung ist offline (signierter Schlüssel). Das Phone-Home ist optional und blockiert nie bei Netzwerkproblemen — der ausgelieferte Schlüssel gilt bis zum Ablaufdatum.

Betrieb & Sicherheit

Verlassen meine Daten das Haus?

Nein. Der Server läuft self-hosted in Ihrer Infrastruktur; SAP-Daten fließen nur zwischen Ihrem SAP B1 und dem LLM-Client. Optional übermittelt das Phone-Home ausschließlich Metadaten (Kundennummer, Edition, Version, Seat-Zahl) — keine Geschäftsdaten.

Wie melden sich Nutzer an — landen Passwörter im Chat?

Nein. Jeder Anwender meldet sich mit den eigenen SAP-Zugangsdaten an; die Eingabe läuft über einen Dialog bzw. ein Web-Login — die Zugangsdaten gelangen nie in den Chat- bzw. LLM-Kontext.

Ist das DSGVO-konform?

Der Betrieb ist self-hosted und datenminimierend ausgelegt (kein Geschäftsdaten-Abfluss, nur optionale Metadaten beim Phone-Home). Die datenschutzrechtliche Bewertung Ihres konkreten Einsatzes treffen Sie als Betreiber — wir unterstützen gern.

Abrechnung & Vertrag

Wie wird abgerechnet?

Pro Seat und Monat über Stripe. Monatlich kündbar. Im Jahresvertrag sparen Sie und der Schlüssel gilt 12 Monate. Alle Preise zzgl. USt. (B2B; USt-IdNr. und Rechnungsadresse werden im Checkout erfasst).

Wie ändere ich Seats / die Edition, wie kündige ich?

Über Abo verwalten gelangen Sie ins Stripe-Kundenportal. Up-/Downgrades und Seat-Änderungen wirken sich automatisch auf Ihre Lizenz aus (sie wird neu signiert). Kündigungen ebenfalls dort.