Jak připojit Claude AI k Taxoriu: Nastavení MCP serveru

Taxorio je prvním českým fakturačním systémem s nativní podporou AI asistenta Claude přes protokol MCP (Model Context Protocol). Díky tomuto propojení můžete vytvářet faktury, spravovat klienty, evidovat náklady nebo generovat daňové exporty pomocí přirozené konverzace. V tomto návodu vás provedeme kompletním nastavením krok za krokem.

Co je MCP a proč ho chcete používat

Model Context Protocol (MCP) je otevřený standard vyvinutý společností Anthropic, která stojí za AI asistentem Claude. MCP umožňuje Claude komunikovat s externími aplikacemi -- v tomto případě s Taxoriem. Místo klikání v rozhraní můžete jednoduše popsat, co potřebujete, a Claude to provede za vás.

Praktický přínos je obrovský. Místo navigace v menu, vyplňování formulářů a klikání na tlačítka jednoduše napíšete: "Vytvoř fakturu pro ABC s.r.o. na 50 000 Kč za webdesign." Claude rozumí kontextu, umí se doptat na chybějící informace a provede celou akci za vás.

Krok 1: Instalace MCP serveru

Taxorio MCP server je dostupný jako npm balíček. Otevřete terminál (příkazový řádek) a spusťte:

npm install -g @taxorio/mcp-server

Tento příkaz nainstaluje MCP server globálně, takže bude dostupný z jakéhokoliv adresáře. Pokud nemáte nainstalovaný Node.js, stáhněte ho z oficiálních stránek nodejs.org (doporučujeme verzi LTS).

Po úspěšné instalaci ověřte, že příkaz taxorio-mcp je dostupný:

taxorio-mcp --version

Krok 2: Konfigurace Claude Desktop

Nyní je potřeba říct Claude Desktop, aby používal Taxorio MCP server. Otevřete konfigurační soubor Claude Desktop:

• Windows: %APPDATA%Claudeclaude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Pokud soubor ještě neexistuje, vytvořte ho. Do souboru přidejte (nebo rozšiřte existující) konfiguraci MCP serverů:

{"mcpServers":{"taxorio":{"command":"taxorio-mcp"}}}

Pokud už máte nakonfigurované jiné MCP servery, přidejte Taxorio jako další položku do objektu mcpServers. Ujistěte se, že JSON je validní -- chybějící čárka nebo závorka způsobí, že Claude Desktop nenačte žádný MCP server.

Krok 3: Restart Claude Desktop

Po uložení konfiguračního souboru restartujte aplikaci Claude Desktop. Úplně ji zavřete (ne jen minimalizujte) a znovu otevřete. Claude Desktop při spuštění načte konfiguraci MCP serverů a spustí Taxorio MCP server na pozadí.

Že je server úspěšně načtený poznáte podle ikony nástrojů v dolní části okna Claude Desktop. Kliknutím na ni uvidíte seznam dostupných MCP nástrojů včetně těch od Taxoria.

Krok 4: Autorizace -- přihlášení k Taxoriu

Při prvním použití je potřeba propojit Claude s vaším Taxorio účtem. V Claude Desktop napište:

"Přihlaš se do Taxorio"

Claude zavolá autorizační nástroj a v prohlížeči se otevře autorizační stránka Taxoria. Na stránce uvidíte:

1. Autorizační kód ve formátu XXXX-XXXX -- tento kód slouží k ověření, že požadavek skutečně přišel z vašeho Claude Desktop
2. Seznam oprávnění, která Claude získá:
   • Správa faktur (vytváření, úprava, mazání, výpis)
   • Správa klientů (vytváření, výpis, vyhledávání v ARES)
   • Evidence nákladů (vytváření, výpis)
   • DPH exporty (generování kontrolního hlášení a přiznání k DPH)
   • Dashboard statistiky
3. Tlačítko "Povolit přístup"

Zkontrolujte oprávnění a klikněte na "Povolit přístup". Autorizace je dokončena.

Krok 5: Uložení tokenu

Po úspěšné autorizaci se přístupový token uloží lokálně do souboru ~/.taxorio-mcp-token. Token má platnost 30 dní, po kterých bude potřeba autorizaci zopakovat.

Token se automaticky obnovuje -- pokud Claude narazí na chybu 401 (neautorizovaný přístup), automaticky spustí nový autorizační flow. Nemusíte se starat o manuální obnovu.

Krok 6: Začínáme používat

Nyní je vše připravené. Můžete začít ovládat Taxorio přirozenou konverzací. Vyzkoušejte třeba:

"Jaké jsou moje statistiky za tento měsíc?"

Claude zavolá nástroj get_dashboard_stats a vrátí vám přehled příjmů, výdajů a dalších klíčových ukazatelů.

Kompletní seznam 16 MCP nástrojů

Taxorio MCP server nabízí 16 nástrojů rozdělených do čtyř kategorií:

Autentizace a přehled

1. authenticate_taxorio -- spustí autorizační flow pro propojení s vaším Taxorio účtem
2. taxorio_get_user_info -- zobrazí informace o přihlášeném uživateli (jméno, firma, IČO, status DPH)
3. taxorio_get_dashboard_stats -- vrátí souhrnné statistiky z dashboardu: příjmy, výdaje, DPH, počet faktur

Správa faktur

1. taxorio_list_invoices -- výpis faktur s možností filtrování podle statusu, data a klienta
2. taxorio_get_invoice -- zobrazení kompletního detailu konkrétní faktury včetně položek
3. taxorio_create_invoice -- vytvoření nové faktury se všemi náležitostmi (klient, položky, data, poznámky)
4. taxorio_update_invoice -- úprava existující faktury (změna statusu, položek, dat)
5. taxorio_delete_invoice -- smazání faktury ze systému

Správa klientů

1. taxorio_list_clients -- výpis všech klientů v databázi
2. taxorio_get_client -- zobrazení detailu konkrétního klienta
3. taxorio_create_client -- vytvoření nového klienta s údaji (název, IČO, adresa, kontakt)
4. taxorio_ares_lookup -- vyhledání firmy v registru ARES podle IČO a automatické doplnění údajů

Náklady a daně

1. taxorio_list_expenses -- výpis evidovaných nákladů s filtrováním
2. taxorio_create_expense -- zaevidování nového nákladu s kategorií, DPH a přílohami
3. taxorio_generate_vat_export -- generování DPH dokumentů (kontrolní hlášení, přiznání k DPH)

Praktické příklady konverzací

Pojďme se podívat na konkrétní příklady, jak můžete Taxorio ovládat přes Claude.

Vytvoření faktury

"Vytvoř fakturu pro ABC s.r.o. na 50 000 Kč za webdesign"

Claude nejprve vyhledá klienta "ABC s.r.o." v databázi pomocí taxorio_list_clients. Pokud klienta najde, použije jeho údaje. Pokud ne, zeptá se, zda má klienta vytvořit, a může využít taxorio_ares_lookup k doplnění údajů z ARES. Poté zavolá taxorio_create_invoice s odpovídajícími parametry.

Přehled neuhrazených faktur

"Ukaž mi všechny neuhrazené faktury"

Claude zavolá taxorio_list_invoices s filtrem na status VYSTAVENA a zobrazí přehlednou tabulku s čísly faktur, klienty, částkami a daty splatnosti. Upozorní vás na faktury po splatnosti.

Evidence nákladu

"Přidej náklad: Software od Microsoft, 2000 Kč"

Claude použije taxorio_create_expense a vytvoří nový nákladový záznam. Automaticky nastaví kategorii SOFTWARE, aktuální datum a zeptá se na sazbu DPH, pokud ji neuvedete.

Měsíční statistiky

"Jaké jsou moje statistiky za tento měsíc?"

Claude zavolá taxorio_get_dashboard_stats a přehledně shrne vaše měsíční příjmy, výdaje, bilanci a stav DPH.

DPH souhrn

"Vygeneruj DPH souhrn za únor 2026"

Claude použije taxorio_generate_vat_export s parametrem pro únor 2026 a vygeneruje kompletní podklady pro přiznání k DPH.

Správa MCP sessions

Každé propojení Claude Desktop s Taxoriem vytvoří session (relaci). Sessions můžete spravovat v nastavení Taxoria:

• V menu přejděte do Nastavení
• V sekci MCP integrace uvidíte seznam aktivních sessions
• U každé session vidíte datum vytvoření a poslední aktivity
• Tlačítkem "Odvolat přístup" můžete session zrušit -- Claude ztratí přístup a bude potřeba nová autorizace

Pokud máte podezření na neoprávněný přístup nebo jednoduše chcete začít s čistým štítem, odvolejte všechny sessions a proveďte novou autorizaci.

Řešení problémů

Claude nevidí Taxorio nástroje

Zkontrolujte, že:

• MCP server je nainstalovaný (npm list -g @taxorio/mcp-server)
• Konfigurační soubor je validní JSON
• Claude Desktop byl restartovaný po úpravě konfigurace
• Příkaz taxorio-mcp je dostupný v PATH

Chyba autorizace

Pokud Claude hlásí chybu při autorizaci:

• Smažte soubor ~/.taxorio-mcp-token a zkuste autorizaci znovu
• Zkontrolujte, že jste přihlášeni do Taxoria v prohlížeči
• Ověřte, že nemáte blokovaná vyskakovací okna v prohlížeči

Token expiroval

Token má platnost 30 dní. Po vypršení Claude automaticky spustí nový autorizační flow -- stačí v prohlížeči znovu kliknout "Povolit přístup". Pokud automatické obnovení nefunguje, smažte soubor s tokenem a proveďte autorizaci ručně.

Bezpečnostní zásady

Propojení Claude s Taxoriem je navrženo s ohledem na bezpečnost:

• Token je uložen lokálně -- nikdy se neodesílá třetím stranám
• Oprávnění jsou granulární -- Claude má přístup jen k funkcím, které jste povolili
• Session lze kdykoliv odvolat -- v nastavení Taxoria jedním kliknutím
• Komunikace je šifrovaná -- veškerá komunikace probíhá přes HTTPS
• Auto-refresh na 401 -- při vypršení tokenu se automaticky spustí nová autorizace, bez rizika neautorizovaných akcí

Důležité: Claude nikdy neprovede akci bez vašeho vědomí. Před každou operací (vytvoření faktury, smazání záznamu) vám Claude ukáže, co hodlá udělat, a počká na vaše potvrzení.

Propojení Taxoria s Claude přes MCP představuje zásadní posun v produktivitě. Úkony, které dříve vyžadovaly desítky kliknutí, zvládnete jednou větou. A díky tomu, že Claude rozumí kontextu, může vám pomoci i s analýzou dat -- například identifikovat neuhrazené faktury, porovnat měsíční příjmy nebo upozornit na blížící se daňové povinnosti.