KASA FIK MCP Server

Co je to MCP server pro Pokladnu?

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

1. Přihlaste se do Backoffice KASA FIK
2. Přejděte do sekce Nastavení → MCP servery (nebo použijte přímý odkaz z vašeho uvítacího emailu)
3. Klikněte na Vytvořit nový token
4. Token si pojmenujte (např. "Claude pro provozovnu Hlavní")
5. 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)

1. Otevřete ChatGPT a vlevo dole klikněte na své jméno, poté na Nastavení
2. V levém seznamu klikněte na Aplikace → Rozšířené nastavení
3. Aktivujte Režim vývojáře kliknutím na posuvník – nechte ho zapnutý i po dokončení nastavení
4. Klikněte na tlačítko Vytvořit aplikaci
5. Do pole Název zadejte například "KASA FIK"
6. Do pole URL serveru MCP vložte adresu: https://api.kasafik.cz/mcp/v1/
7. Klikněte na Vytvořit
8. 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)

1. Otevřete Claude Desktop
2. V levém postranním panelu klikněte na Customize
3. Vlevo vyberte Connectors a kliknutím na tlačítko plus přidejte Add custom connector
4. Do pole Name zadejte například "KASA FIK"
5. Do pole Remote MCP server URL vložte adresu: https://api.kasafik.cz/mcp/v1/
6. Potvrďte kliknutím na Add
7. Zobrazí se formulář pro autorizaci – vložte svůj token z Backoffice a potvrďte
8. 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

1. Otevřete Codex
2. Vlevo dole klikněte na Nastavení → Nastavení
3. V levém postranním panelu klikněte na MCP servery a pak na Přidat server
4. Do pole Název napište například "KASA FIK"
5. Klikněte na Streamovatelné HTTP
6. Do pole URL vložte adresu: https://api.kasafik.cz/mcp/v1/
7. Klikněte na Uložit
8. V seznamu připojených serverů klikněte na Ověřit se
9. 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:

1. Přejděte do Nastavení → MCP servery
2. 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í.

Mohu použít jiné AI než Claude, OpenCode, ChatGPT nebo Codex? Teoreticky ano, pokud podporují MCP protokol.

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: podpora@kasafik.cz