🤖 Taxorio MCP Server

První český fakturační systém ovládatelný přes AI konverzaci

MCP (Model Context Protocol) server pro Taxorio - vytvářejte faktury, spravujte klienty a evidujte náklady přímo z AI asistentů podporujících MCP protokol.

✨ Co to umí?

• 📄 Faktury - Vytváření, úpravy, mazání, PDF export
• 👥 Klienti - Správa klientů, ARES lookup
• 💰 Náklady - Evidence nákladů, kategorizace
• 📊 Statistiky - Přehledy příjmů, výdajů, zisku
• 🏛️ DPH exporty - Generování souhrnu pro kontrolní hlášení

🚀 Instalace

npm install -g @taxorio/mcp-server@beta

Package je dostupný jako beta verze. Pro stabilní verzi použijte:

npm install -g @taxorio/mcp-server

⚙️ Konfigurace AI Asistenta

Taxorio MCP server funguje s jakýmkoliv AI asistentem podporujícím MCP protokol:

Claude Desktop

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

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

Cline (VSCode Extension)

V nastavení Cline přidejte MCP server do konfigurace.

Zed Editor

Zed má nativní MCP podporu - přidejte server do nastavení editoru.

Další MCP nástroje

Jakýkoliv nástroj kompatibilní s MCP protokolem - stačí nakonfigurovat taxorio-mcp příkaz.

Development (lokální API)

Pro testování s lokálním API serverem:

{
  "mcpServers": {
    "taxorio": {
      "command": "node",
      "args": ["C:/Workspace/Private/Billo/apps/mcp-server/dist/index.js"],
      "env": {
        "TAXORIO_API_URL": "http://localhost:3001/api/v1"
      }
    }
  }
}

Poznámka: Produkční URL je výchozí, takže pro běžné použití není potřeba TAXORIO_API_URL nastavovat.

🔐 První použití

1. Restartujte AI asistenta (Claude Desktop, Cline, atd.)
2. Napište: "Přihlaš se do Taxorio"
3. Otevře se prohlížeč pro autentizaci
4. Přihlaste se a schvalte přístup
5. Token se uloží automaticky
6. Můžete začít používat!

💡 Příklady použití

"Vytvoř fakturu pro klienta ABC s.r.o. na 50 000 Kč"
"Ukaž mi seznam neuhrazených faktur"
"Přidej náklad z účtu od dodavatele XYZ"
"Vygeneruj DPH přiznání za prosinec 2025"
"Jaké jsou moje statistiky za poslední měsíc?"

🛠️ Dostupné nástroje

• Faktury (vytváření, úpravy, PDF export)
• Klienti (správa, ARES lookup)
• Náklady (evidence, AI sken dokladů)
• DPH exporty (kontrolní hlášení, přiznání)
• Dashboard statistiky

🤝 Podpora

Pro otázky a podporu kontaktujte [email protected]