@taxorio/mcp-server

v1.4.4

Published

2 days ago

MCP Server for Taxorio - Control your invoicing from AI assistants

Downloads

1,003

0High
0Medium
0Low

jiri.frank.88

mcp taxorio invoicing ai-assistant model-context-protocol ai automation accounting claude cline

Taxorio MCP Server

Ovládejte svoji fakturaci a daně přímo z AI asistenta. Oficiální Model Context Protocol server pro Taxorio — českou aplikaci pro fakturaci a daně OSVČ.

Připojte Taxorio k Claude, Cursoru, Clinovi nebo libovolnému MCP klientovi a vyřizujte účetní agendu přirozeným jazykem: „Vystav fakturu klientovi ACME na 25 000 Kč", „Kolik mám zaplatit na dani z příjmů letos?", „Spáruj platby z banky s fakturami."

Vy:  Vystav fakturu firmě Ukázka s.r.o. za konzultace 40 hodin po 1 500 Kč.
AI:  ✅ Vystavena faktura 2026012 na 60 000 Kč (+ DPH 12 600 Kč), splatnost 14 dní.
     Chcete ji rovnou odeslat e-mailem?

Co umí

S Taxorio MCP serverem zvládne váš AI asistent mimo jiné:

🧾 Faktury — vystavit, upravit, stornovat, označit jako uhrazené, odeslat e‑mailem, vytvořit dobropis
👥 Klienty — spravovat kontakty a automaticky doplnit údaje z ARES a VIES
💸 Náklady — evidovat a kategorizovat přijaté doklady
📊 Daně — přehled pro daň z příjmů, paušální daň, export DPH (přiznání + kontrolní hlášení v XML pro EPO), zálohy
🏦 Banku — párovat příchozí platby s fakturami (potvrdit, odmítnout, přeřadit)
📈 Přehledy — statistiky dashboardu, příjmy, výdaje, stav vůči limitům

AI nepracuje naslepo. Každá změna (vystavení faktury, evidence nákladu…) probíhá pod vaším účtem a podléhá pravidlům aplikace stejně jako kdybyste ji dělali ručně v Taxoriu.

Požadavky

Node.js 20 nebo novější
Účet v Taxoriu s aktivním plánem PRO — MCP integrace je součástí plánu PRO
MCP klient (Claude Desktop, Claude Code, Cursor, Cline, …)

Instalace a nastavení

Server se spouští přes npx, není potřeba nic globálně instalovat. Stačí ho přidat do konfigurace vašeho MCP klienta.

Claude Desktop

Otevřete soubor claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

a přidejte:

{
  "mcpServers": {
    "taxorio": {
      "command": "npx",
      "args": ["-y", "@taxorio/mcp-server"]
    }
  }
}

Poté Claude Desktop restartujte.

Claude Code

claude mcp add taxorio -- npx -y @taxorio/mcp-server

Cursor / Cline / ostatní klienti

Použijte standardní konfiguraci stdio serveru:

{
  "mcpServers": {
    "taxorio": {
      "command": "npx",
      "args": ["-y", "@taxorio/mcp-server"]
    }
  }
}

První přihlášení

Server používá bezpečné přihlášení přes OAuth Device Flow — heslo nikdy nezadáváte do AI klienta.

Napište asistentovi: „Přihlas se do Taxoria" (nebo zavolejte nástroj authenticate_taxorio).
Otevře se prohlížeč s přihlašovací stránkou Taxoria a zobrazí se ověřovací kód.
Přihlášení potvrdíte a hotovo — token se bezpečně uloží lokálně do ~/.taxorio-mcp-token (s oprávněním 600, čte ho jen váš uživatel).

Při dalším spuštění už se přihlašovat nemusíte. Pokud token vyprší nebo session zrušíte v aplikaci, server si o nové přihlášení řekne automaticky.

💡 Server se při startu nikdy nepřihlašuje sám — interaktivní okno se otevře jen na vaši výslovnou akci nebo při prvním reálném použití nástroje. Restart klienta vás tedy nezahltí pop‑upy.

Přehled nástrojů

| Nástroj | Popis | | --- | --- | | authenticate_taxorio | Přihlášení do účtu (OAuth Device Flow) | | taxorio_get_user_info | Informace o přihlášeném uživateli a plánu | | taxorio_get_dashboard_stats | Statistiky dashboardu (příjmy, výdaje, DPH) | | taxorio_get_settings | Firemní nastavení (IČO, DIČ, adresa, banka) | | taxorio_update_settings | Úprava firemních nastavení |

| Nástroj | Popis | | --- | --- | | taxorio_list_invoices | Seznam faktur s filtry | | taxorio_get_invoice | Detail faktury | | taxorio_create_invoice | Vystavení nové faktury | | taxorio_update_invoice | Úprava faktury | | taxorio_delete_invoice | Smazání faktury | | taxorio_cancel_invoice | Storno faktury | | taxorio_mark_invoice_paid | Označení faktury jako uhrazené | | taxorio_send_invoice_email | Odeslání faktury e‑mailem | | taxorio_create_credit_note | Vystavení dobropisu | | taxorio_list_item_templates | Šablony fakturačních položek |

| Nástroj | Popis | | --- | --- | | taxorio_list_clients | Seznam klientů | | taxorio_get_client | Detail klienta | | taxorio_create_client | Nový klient | | taxorio_update_client | Úprava klienta | | taxorio_delete_client | Smazání klienta | | taxorio_ares_lookup | Vyhledání firmy v rejstříku ARES podle IČO | | taxorio_vies_lookup | Ověření DIČ v systému VIES (EU) |

| Nástroj | Popis | | --- | --- | | taxorio_list_expenses | Seznam nákladů | | taxorio_get_expense | Detail nákladu | | taxorio_create_expense | Evidence nového nákladu | | taxorio_update_expense | Úprava nákladu | | taxorio_delete_expense | Smazání nákladu |

| Nástroj | Popis | | --- | --- | | taxorio_get_income_tax_summary | Přehled pro daň z příjmů (příjmy, výdaje, základ daně) | | taxorio_generate_vat_export | Export DPH — přiznání a kontrolní hlášení (XML pro EPO) | | taxorio_get_pausalni_dan_status | Stav paušální daně a kontrola limitů pásem | | taxorio_get_zaloha_info | Informace o zálohách |

| Nástroj | Popis | | --- | --- | | taxorio_list_payment_inbox | Příchozí platby čekající na spárování | | taxorio_confirm_payment_match | Potvrzení navrženého spárování platby | | taxorio_reject_payment_match | Odmítnutí navrženého spárování | | taxorio_reassign_payment_match | Přeřazení platby na jinou fakturu | | taxorio_unmatch_payment | Zrušení existujícího spárování | | taxorio_update_payment_settings | Nastavení párování a notifikací |

Příklady promptů

„Vystav fakturu klientovi Ukázka s.r.o. za webové služby 30 000 Kč, splatnost 14 dní."
„Najdi firmu v ARESu podle jejího IČO a založ ji jako nového klienta."
„Které faktury jsou po splatnosti?"
„Připrav podklady pro přiznání k DPH za minulý měsíc."
„Kolik mi vyjde daň z příjmů, když uplatním paušální výdaje 60 %?"
„Spáruj platby z banky s odpovídajícími fakturami."

Konfigurace (pokročilé)

| Proměnná prostředí | Výchozí hodnota | Popis | | --- | --- | --- | | TAXORIO_API_URL | https://api.taxorio.cz/api/v1 | Adresa Taxorio API (měnit jen ve speciálních případech) |

Přihlašovací token se ukládá do ~/.taxorio-mcp-token. Smazáním tohoto souboru se odhlásíte; přístup můžete kdykoliv zrušit i v aplikaci v sekci nastavení integrací.

Bezpečnost

Žádná hesla v AI klientovi — přihlášení probíhá v prohlížeči přes OAuth Device Flow.
Lokální token uložený s restriktivními oprávněními (600).
Odvolatelný přístup — session lze kdykoliv zrušit v Taxoriu; server na to reaguje a vyžádá si nové přihlášení.

Našli jste bezpečnostní problém? Napište nám na [email protected].

O Taxoriu

Taxorio je moderní česká aplikace pro fakturaci a daně OSVČ, která drží vaši administrativu na jednom místě:

⚡ Fakturace za pár sekund s automatickým doplněním z ARES a VIES
🧮 Daně bez stresu — daň z příjmů, paušální daň, DPH (přiznání i kontrolní hlášení s exportem pro EPO)
🏦 Napojení na banku s automatickým párováním plateb
🤖 AI asistent přímo v aplikaci i přes tento MCP server

👉 Vyzkoušejte Taxorio na taxorio.cz — MCP integrace je součástí plánu PRO.

Podpora a odkazy

🌐 Web: taxorio.cz
✉️ Podpora: [email protected]
📦 npm: @taxorio/mcp-server