# 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