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

Server nabízí 37 nástrojů pokrývajících všechny moduly aplikace.

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)

Úkoly

Nástroj	Popis
list_tasks	Seznam úkolů — filtr podle projektu, řešitele (i „moje úkoly") a stavu
create_task	Nový úkol — rovnou s řešitelem, termínem, prioritou a odhadem
update_task	Úprava úkolu — stav, priorita, termín, řešitel, příznak „Čeká na"
add_task_comment	Komentář k úkolu (účastníci vlákna dostanou notifikaci)

Úkoly jsou dostupné všem rolím — číst a zakládat je může kdokoliv v organizaci. Úpravu konkrétního úkolu server povolí jeho autorovi, řešiteli nebo manažerovi. Zápisy (create_task, update_task, add_task_comment) vyžadují klíč s plným přístupem. Více v modulu Úkoly.

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

Karta klienta

Nástroj	Popis
list_client_contacts	Kontaktní osoby klienta (jméno, role, e-mail, telefon)
list_client_activities	Historie klienta — poznámky, hovory, schůzky, připomenutí
add_client_activity	Nový záznam do historie klienta (u připomenutí s termínem)

Nástroje karty klienta vyžadují roli vlastník, admin, manažer nebo účetní (člen a HR k nim přístup nemají); manažer vidí jen své přiřazené klienty. Zápis (add_client_activity) navíc vyžaduje klíč s plným přístupem. Více v Kartě klienta.

Retainery (klientské paušály)

Nástroj	Popis
list_retainers	Seznam aktivních paušálů s čerpáním aktuálního období
retainer_status	Paušály klienta — čerpání, přebytek, historie období, projekty mimo paušály

Retainery vyžadují plán Business a roli vlastník, admin, manažer nebo účetní. Oba nástroje jen čtou — stačí i klíč jen pro čtení. Více v modulu Retainery.

Klient může mít víc paušálů

Od srpna 2026 vrací retainer_status všechny paušály klienta (dřív jeden) — u každého i to, které projekty čerpá — a navíc seznam projektů, které nečerpají žádný paušál. Používáte-li nainstalovaný balíček mujvykaz-mcp, potřebujete verzi 1.5.0 nebo novější; starší z klienta s víc paušály ukáže jen jeden, bez náznaku, že existují další. Remote varianta (/api/mcp) se aktualizuje sama s aplikací.

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)

Plánování kapacit

Nástroj	Popis
capacity_overview	Kdo má v období volno a kdo je přeplánovaný (kapacita týmu)
my_plan	Co mám naplánováno a kolik z toho ještě zbývá zapsat
plan_work	Naplánovat práci členovi týmu (blok na projektu; umí i opakování)
update_planned_work	Upravit naplánovanou práci (délku, stav, přesun; u série rozsah)
delete_planned_work	Smazat naplánovanou práci (u série rozsah — tento / tento a další / celá série)

Plánovací nástroje vyžadují plán Business a zapnutý modul Absencí. Zápis (plan_work, update_planned_work, delete_planned_work) navíc roli manager nebo vyšší a klíč s plným přístupem. Čtení (capacity_overview, my_plan) zvládne i klíč jen pro čtení.

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í."
• „Vytvoř úkol ‚Připravit podklady' na projektu Redesign a přiřaď ho Janě."
• „Kolik hodin zbývá z paušálu klienta Firma s.r.o.?"
• „Kdo má příští týden volnou kapacitu?"
• „Naplánuj Janě 4 hodiny denně na projekt Redesign od pondělí do pátku."

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.