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 (19)

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ů
reject_time_entries	Vrácení záznamů k přepracování (→ Draft)

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í."
• „Vrať výkazy Jana Nováka za minulý týden k přepracování."

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.