Časté dotazy

FAQ — Versino AI SAP B1 MCP

Instalace, typy licencí a provoz — stručně a konkrétně. Ještě něco nejasného? Kontakt nebo support@versino.de.

Instalace a uvedení do provozu

Jak nainstaluji MCP server?
  1. Stáhněte aktuální binární soubor z repozitáře ke stažení — Windows (.exe) nebo Linux (64bitový).
  2. Umístěte licenční soubor versino.key do stejné složky (najde se automaticky vedle binárního souboru — cesta není potřeba).
  3. Vytvořte .env s SAP_BASE_URL, SAP_DATABASES a SAP_AUTH_MODE a spusťte server.

Návody krok za krokem pro Windows a Linux (vč. služby Windows) jsou v repozitáři ke stažení pod docs/.

Jaké jsou systémové požadavky?
  • 64bitový Windows 10/11 / Server 2019+ nebo 64bitový Linux (glibc, x86-64).
  • Síťový přístup k vašemu Service Layer SAP B1 (https://<host>:50000/b1s/v2/).
  • Platný versino.key (edice BASIC/PRO/ENTERPRISE).
  • Pro klienty pouze se stdio: Node.js (pro můstek mcp-remote).
Jak připojím server ke Claude Desktop nebo jiným LLM klientům?

Server komunikuje přes streamable HTTP na http://<host>:8000/mcp.

  • Klienti podporující streamable HTTP (Claude Desktop „Custom Connector“, Cline, Continue, Cursor …): nasměrujte přímo na URL /mcp.
  • Klienti pouze se stdio nebo čisté http://: můstek npx mcp-remote http://<host>:8000/mcp.

Pro síťový provoz se doporučuje předřazený reverzní proxy server s TLS.

Typy licencí podrobně

FunkceBASICPROENTERPRISE
Cena (€/uživatel·měsíc) 52050
Čtení dat pouze kmenová data¹všechna datavšechna data
Zápis (vytváření / změny) —✓✓
Mazání a akce dokladů ——✓
Vazby ($expand) a reporty AI_* —✓✓
Dotazy / hodina 60600neomezeně
Řádky / dotaz 501.000neomezeně

¹ Kmenová data = obchodní partneři, artikly, ceníky, sklady, … — pohybová data (faktury, zakázky, zápisy) lze číst od PRO.

Co přesně umí edice BASIC — a co ne?

Umí: číst kmenová data (obchodní partneři, artikly, ceníky, sklady, zaměstnanci, měny …) vč. fuzzy vyhledávání.

Neumí: číst pohybová data (faktury, zakázky, dodávky, zápisy), vazby přes $expand, ověřené SQL reporty AI_* — a žádný zápis. Omezeno na 60 dotazů/hodinu a 50 řádků na dotaz.

Kdo potřebuje „hodně číst, ale nic zapisovat“, je většinou správně u PRO (plný rozsah čtení) — jinak se nám ozvěte.

Kterou edici potřebuji?
  • BASIC — vyhledávání kmenových dat v malém rozsahu.
  • PRO — obvyklá volba: analýzy nad všemi daty a vytváření/změny dokladů.
  • ENTERPRISE — navíc mazání a akce dokladů (např. uzavření zakázky) a neomezené objemy.
Platí navíc oprávnění SAP?

Ano. Edice určuje jen rámec — nakonec SAP Business One prosazuje práva přihlášeného uživatele 1:1. Celou instanci lze navíc zcela uzamknout proti zápisu přes SAP_OPERATION_MODE=READ_ONLY.

Licence a klíč

Co je versino.key a jak jej použiji?

Podepsaný offline licenční soubor. Po nákupu jej obdržíte e-mailem a přes svůj zákaznický portál. Umístěte jej vedle binárního souboru — rozpozná se automaticky. Bez platné licence se server nespustí.

Co je „seat“ a jak se počítá?

Seat = jeden konkrétní uživatel SAP, který se připojuje. Opětovné připojení téhož uživatele nespotřebuje další seat; odpojení jej opět uvolní. Více instancí jedné firmy sdílí počet seats licence.

Co se stane při vypršení — jak funguje prodloužení?

U běžícího předplatného se licence automaticky prodlužuje. „Phone-home" je ve výchozím nastavení aktivní, instalace tedy obnovený klíč převezme sama — žádná ruční výměna klíče za zúčtovací období. Pokud je vypnutý, obdržíte včas nový versino.key.

Funguje server offline / air-gapped?

Ano. Kontrola licence je offline (podepsaný klíč). Phone-home nikdy neblokuje při problémech se sítí — dodaný klíč platí až do data vypršení.

Provoz a bezpečnost

Opouštějí moje data firmu?

Ne. Server běží self-hosted ve vaší infrastruktuře; data ze SAP putují pouze mezi vaším SAP B1 a klientem LLM. Phone-home předává výhradně metadata (zákaznické číslo, edici, verzi, počet seats) — žádná obchodní data.

Jak se uživatelé přihlašují — dostanou se hesla do chatu?

Ne. Každý uživatel se přihlašuje svými vlastními přístupovými údaji SAP; zadání probíhá přes dialog resp. webové přihlášení — přístupové údaje se nikdy nedostanou do kontextu chatu resp. LLM.

Je to v souladu s GDPR?

Provoz je self-hosted a navržený s ohledem na minimalizaci dat (žádný odtok obchodních dat, u phone-home výhradně metadata). Posouzení vašeho konkrétního nasazení z hlediska ochrany osobních údajů provádíte jako provozovatel — rádi pomůžeme.

Účtování a smlouva

Jak se účtuje?

Za seat a měsíc přes Stripe. S měsíční výpovědí. U roční smlouvy ušetříte a klíč platí 12 měsíců. Všechny ceny bez DPH (B2B; DIČ a fakturační adresa se zadávají při placení).

Jak změním seats / edici, jak vypovím?

Přes Správu předplatného se dostanete do zákaznického portálu Stripe. Přechody na vyšší/nižší edici a změny seats se automaticky projeví ve vaší licenci (znovu se podepíše). Výpovědi tamtéž.