MCP Server

MCP (Model Context Protocol) server umožňuje propojit MujVykaz s AI nástroji — Claude Desktop, VS Code, Claude CLI a dalšími.

Instalace

Není potřeba nic instalovat globálně. Server se spouští přes npx:

npx -y mujvykaz-mcp

Konfigurace

Nastavte proměnnou prostředí s vaším API klíčem:

export MUJVYKAZ_API_KEY="vas_api_klic"

Claude Desktop

Přidejte do konfigurace (~/.claude/config.json nebo Claude Desktop settings):

{
  "mcpServers": {
    "mujvykaz": {
      "command": "npx",
      "args": ["-y", "mujvykaz-mcp"],
      "env": {
        "MUJVYKAZ_API_KEY": "vas_api_klic"
      }
    }
  }
}

VS Code

Přidejte do .vscode/mcp.json nebo uživatelských nastavení:

{
  "servers": {
    "mujvykaz": {
      "command": "npx",
      "args": ["-y", "mujvykaz-mcp"],
      "env": {
        "MUJVYKAZ_API_KEY": "vas_api_klic"
      }
    }
  }
}

Dostupné nástroje (18)

Profil a statistiky

Nástroj	Popis
my_profile	Zobrazí profil přihlášeného uživatele
my_stats	Osobní statistiky (hodiny, projekty)
team_stats	Statistiky celého týmu

Záznamy práce

Nástroj	Popis
list_time_entries	Seznam záznamů s filtry
create_time_entry	Nový záznam práce
update_time_entry	Úprava záznamu
delete_time_entry	Smazání záznamu
submit_time_entries	Odeslání ke schválení
approve_time_entries	Schválení záznamů

Projekty a klienti

Nástroj	Popis
list_projects	Seznam projektů
create_project	Nový projekt
update_project	Úprava projektu
list_clients	Seznam klientů
create_client	Nový klient
update_client	Úprava klienta

Faktury a reporty

Nástroj	Popis
list_invoices	Seznam faktur
list_users	Seznam členů týmu
query_reports	AI dotaz na data (text → SQL → výsledek)

Příklady použití

V Claude Desktop nebo CLI můžete psát přirozeně:

• „Kolik hodin jsem odpracoval tento týden?"
• „Založ nový projekt Web redesign pro klienta Firma s.r.o."
• „Zapiš 3 hodiny na projekt API integrace za dnešek."
• „Kdo z týmu odpracoval nejvíc hodin za březen?"
• „Odešli moje výkazy za tento týden ke schválení."

Přístupová práva

MCP server respektuje roli API klíče. Worker může spravovat jen svá data, manager vidí přiřazené klienty, admin vše.

tip

MCP server je ideální pro rychlé zadávání výkazů přímo z editoru nebo terminálu — bez přepínání do prohlížeče.