KASA FIK MCP Server

Co je to MCP server?

MCP (Model Context Protocol) je otevřený protokol, který umožňuje AI nástrojům (jako je Claude Desktop, ChatGPT nebo OpenAI Codex) komunikovat přímo s vašimi daty v KASA FIK.

Díky MCP serveru nemusíte otevírat dashboard, exportovat CSV ani ručně kopírovat čísla. Stačí se zeptat přirozeným jazykem a AI odpoví na základě živých dat z vaší provozovny.

K čemu se MCP server hodí?

Tržby a vše kolem prodeje teď vyřídíte přímo v AI chatu. Místo ručního proklikávání prostě napište třeba "Ukaž mi, jaké byly mé tržby za včerejšek a které produkty se prodávaly nejvíce" – a AI vám výsledek přehledně zobrazí.

Díky MCP serveru můžete:

zjistit denní, týdenní nebo měsíční tržby
vyhledat nejlépe a nejhůře prodávané produkty
zkontrolovat aktuální stav zásob
získat přehled o průměrné hodnotě transakce
zjistit počet unikátních zákazníků za dané období

V beta verzi je k dispozici pouze čtení dat. Zápisové operace (tvorba slev, úprava zásob, refundace) zatím nejsou podporovány.

Kolik za propojení s AI zaplatíte?

Samotné napojení AI na KASA FIK je v beta verzi zdarma. MCP volání nejsou aktuálně omezena ani počítána do žádných limitů.

Po ukončení beta verze a ostrém release bude toto propojení zpoplatněno jako prémiový add-on. O přesných podmínkách vás budeme včas informovat.

Jak propojím KASA FIK s AI?

Oproti jiným integracím zde nemusíte složitě generovat API klíče ručně. Stačí si vygenerovat token v Backoffice KASA FIK, zadat adresu MCP serveru do vašeho AI nástroje a propojení je hotové.

Níže najdete konkrétní postup pro váš AI nástroj.

Krok 1: Získání přístupového tokenu

Přihlaste se do Backoffice KASA FIK
Přejděte do sekce Nastavení → MCP servery (nebo použijte přímý odkaz z vašeho uvítacího emailu)
Klikněte na Vytvořit nový token
Token si pojmenujte (např. "Claude pro provozovnu Hlavní")
Zkopírujte vygenerovaný token – po opuštění stránky už ho nebude možné znovu zobrazit

Podrobný návod krok za krokem najdete v samostatné příručce Správa MCP tokenů v Backoffice.

Krok 2: Propojení s vaším AI nástrojem

Vyberte níže váš AI nástroj.

Jak propojím KASA FIK s ChatGPT (OpenAI)

Otevřete ChatGPT a vlevo dole klikněte na své jméno, poté na Nastavení
V levém seznamu klikněte na Aplikace → Rozšířené nastavení
Aktivujte Režim vývojáře kliknutím na posuvník – nechte ho zapnutý i po dokončení nastavení
Klikněte na tlačítko Vytvořit aplikaci
Do pole Název zadejte například "KASA FIK"
Do pole URL serveru MCP vložte adresu: https://api.kasafik.cz/mcp/v1/
Klikněte na Vytvořit
Zobrazí se formulář pro autorizaci – vložte svůj token z Backoffice a potvrďte

Poznámka: Režim vývojáře musí zůstat zapnutý, jinak propojení přestane fungovat. Pokud vám to nevyhovuje, doporučujeme použít Claude Desktop.

Jak propojím KASA FIK s Claude Desktop (Anthropic)

Otevřete Claude Desktop
V levém postranním panelu klikněte na Customize
Vlevo vyberte Connectors a kliknutím na tlačítko plus přidejte Add custom connector
Do pole Name zadejte například "KASA FIK"
Do pole Remote MCP server URL vložte adresu: https://api.kasafik.cz/mcp/v1/
Potvrďte kliknutím na Add
Zobrazí se formulář pro autorizaci – vložte svůj token z Backoffice a potvrďte
Vrátíte se zpět do Claude, kde můžete případně upravit jednotlivá oprávnění

Jak propojím KASA FIK s OpenAI Codex

Otevřete Codex
Vlevo dole klikněte na Nastavení → Nastavení
V levém postranním panelu klikněte na MCP servery a pak na Přidat server
Do pole Název napište například "KASA FIK"
Klikněte na Streamovatelné HTTP
Do pole URL vložte adresu: https://api.kasafik.cz/mcp/v1/
Klikněte na Uložit
V seznamu připojených serverů klikněte na Ověřit se
Zobrazí se formulář pro autorizaci – vložte svůj token z Backoffice a potvrďte

Krok 3: První dotaz

Po úspěšném propojení můžete začít pokládat dotazy. Zkuste například:

"Jaké byly mé celkové tržby za dnešek?"
"Ukaž mi 5 nejprodávanějších produktů tento týden."
"Kolik transakcí jsem měl včera?"
"Mám nějaký produkt pod minimální zásobou?"
"Který den v minulém týdnu byl nejsilnější?"

AI odpovídá česky (pokud se zeptáte česky) a data zobrazuje přehledně jako tabulku nebo seznam.

Jak zruším propojení s AI v KASA FIK?

Propojení zrušíte ve dvou krocích:

V KASA FIK Backoffice:

Přejděte do Nastavení → MCP servery
U příslušného tokenu klikněte na Zrušit přístup nebo token smažte

Ve vašem AI nástroji:

ChatGPT: Nastavení → Aplikace → KASA FIK → tři tečky → Odstranit
Claude: Customize → Connectors → KASA FIK → Disconnect
Codex: Nastavení → MCP servery → ozubené kolečko → Odinstalovat

Jak bezpečně pracovat s AI?

Zkontrolujte výsledek. Jako každý nástroj, i AI se občas splete. Vždy si ověřte důležité údaje.

Sdílejte jen to, co je potřeba. Do chatu zadávejte pouze dotazy, které AI potřebuje k danému úkolu. Citlivá data (hesla, čísla karet, osobní údaje zákazníků) tam nepatří. Počítejte s tím, že data procházejí přes poskytovatele AI.

Používejte oficiální zdroje. Claude Desktop stahujte z webu Anthropic, ChatGPT z webu OpenAI. Připojujte jen služby, kterým důvěřujete.

Ponechte si poslední slovo. U důležitých akcí (byť je v beta verzi nemůžete provádět) si nejdřív nechte od AI navrhnout, co chce udělat – a potvrďte to, až si ověříte, že je vše v pořádku.

Co AI v účtu smí (a co ne):

V beta verzi: pouze čtení tržeb, produktů, zásob a základních statistik
Nemá přístup k úpravám, mazání, refundacím ani ke správě uživatelů
Každý dotaz je omezen na vašeho tenanta – AI nevidí data jiných provozoven

Autorizace přes token. Žádná hesla, AI dostane jen omezený přístupový token, který v Backoffice můžete kdykoliv zneplatnit.

Omezení beta verze

Není podporován hromadný export (např. "dej mi všechny transakce za rok") – maximálně 1000 řádků na dotaz
Nelze provádět srovnání s předchozími roky (pouze aktuální a předchozí měsíc)
Zákaznická data jsou anonymizovaná (místo jmen vidíte jen identifikátory)
Nefunguje offline – vyžaduje internetové připojení
Maximálně 60 dotazů za minutu na jeden token

Časté dotazy

Musím mít v ChatGPT trvale zapnutý režim vývojáře? Ano, režim vývojáře musí zůstat zapnutý, jinak propojení s KASA FIK přestane fungovat. Pokud vám to nevyhovuje, vyzkoušejte Codex (také od OpenAI a funguje se stejným předplatným) nebo Claude Desktop – tam toto omezení není.

Je propojení s AI zdarma? Ano, v beta verzi je napojení AI na KASA FIK zdarma a MCP volání nejsou omezena. Po ostrém release bude toto propojení zpoplatněno jako prémiový add-on.

Mohu použít jiné AI než Claude, ChatGPT nebo Codex? Teoreticky ano, pokud podporují MCP protokol. Oficiálně však v beta verzi podporujeme pouze výše uvedené tři nástroje.

Jak dlouho beta verze poběží? Minimálně 3 měsíce od aktivace vašeho prvního tokenu. O ukončení vás budeme informovat 14 dní předem.

Může MCP server používat více zaměstnanců? Ano, ale každý potřebuje vlastní token. Tokeny nesdílejte – v logu vidíme, kdo co dotazoval.

Co když zapomenu token? Token nelze znovu zobrazit. Pokud ho ztratíte, vytvořte v Backoffice nový a starý zrušte.

Podpora a zpětná vazba

Jste mezi prvními uživateli MCP v České republice. Vaše zkušenosti jsou pro nás klíčové.

Technické problémy: mcp-support@kasafik.cz
Nápady na nové funkce: mcp-feedback@kasafik.cz

Vždy uveďte:

název vaší provozovny
použitý AI nástroj (ChatGPT / Claude / Codex)
přesné znění dotazu, který selhal

Děkujeme, že jste součástí beta programu

Těší nás, že vám můžeme jako KASA FIK přinést budoucnost správy POS systému – přes umělou inteligenci a přirozený jazyk.

Tato příručka je důvěrná a určená výhradně účastníkům uzavřené beta verze.