Co budete potřebovat?
Tři věci: účet v evidenci času, která podporuje MCP server, AI asistenta, který MCP umí, a adresu serveru. Pro Half5 je to https://app.half5.com/mcp.
Není třeba nic instalovat ani kopírovat API klíč. Při připojení se otevře přihlašovací stránka ve vašem prohlížeči. Přihlásíte se běžným účtem a udělíte souhlas. Co přesně je MCP, vysvětlujeme v Co je MCP?.
- Kódovací asistenti: Claude Code, Codex a Cursor. Pracují přímo ve vašem projektu a mohou předat název repozitáře.
- Chat asistenti: Claude.ai (včetně Desktop a mobilní aplikace) a ChatGPT. Neznají váš repozitář, proto se častěji ptají, pro kterého klienta je záznam určen.
- Ostatní: VS Code a další programy, které podporují vzdálený MCP server s OAuth.
Jak připojit asistenta?
Každý asistent má nastavení jinde. Tabulka vychází z návodu přímo v Half5. Názvy menu se v těchto aplikacích občas mění; pokud něco nenajdete, hledejte „MCP“, „konektor“ nebo „vlastní konektor“.
| Asistent | Kde | Co udělat |
|---|---|---|
| Claude Code | Terminál | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, poté /mcp v Claude Code, vyberte half5 a přihlaste se |
| Codex | Terminál | codex mcp add half5 --url https://app.half5.com/mcp, poté codex mcp login half5; Codex otevře váš prohlížeč |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, poté Připojit v Nastavení → MCP |
| Claude.ai, Desktop, app | Nastavení → Konektory | Přidat vlastní konektor, vložit URL a přihlásit se |
| ChatGPT | Nastavení → Aplikace & Konektory → Pokročilé | Zapnout režim vývojáře, zvolit Vytvořit, vložit URL a vybrat OAuth |
| VS Code a další | Nastavení MCP | Přidat vzdálený (HTTP) MCP server s touto URL |
Režim vývojáře v ChatGPT není dostupný ve všech tarifech. Pokud možnost nevidíte, ověřte si, co váš tarif umožňuje.
Co říct asistentovi?
Stačí běžná čeština. Nemusíte znát ID, čísla klientů ani kódy projektů. Pokud víte, uveďte klienta nebo projekt a čas.
- „Zapiš hodinu a půl na tuto práci.“
- „Pracoval(a) jsem na integraci platební brány od 9:00 do 11:30. Zapiš to pro Jansen Bakery.“
- „Zapiš tuto relaci na projekt Webshop.“ (bez délky: evidence času navrhne čas, který potvrdíte)
- „Co jsem zapsal(a) včera?“
- „Přesuň dnešní ranní záznam na projekt Údržba.“
- „Smaž dnešní duplicitní záznam.“
Co se děje po zápisu?
Záznam od asistenta není poznámka bokem. Jde o běžnou evidenci, která prochází stejnými kontrolami jako ostatní hodiny.
- Asistent pošle krátký popis, datum, délku (pokud ji zná) a u kódovacích asistentů i název repozitáře a větev.
- Evidence času vybere klienta, projekt a činnost. Pokud si není jistá, asistent se vás doptá s několika možnostmi.
- Pokud není uvedena délka, evidence času navrhne – pro dnešek – čas od posledního záznamu. Pro jiný den se vás asistent zeptá na délku. Nic se neuloží, dokud nepotvrdíte.
- Záznam přijde jako neschválený. Pokud vaše organizace používá schvalování, schvaluje jej pověřená osoba stejně jako ostatní hodiny.
- Záznam se ihned počítá do přehledů. Pokud je zapnuto schvalování, na fakturu se dostane až po schválení.
Jaké návyky předcházejí chybám?
Asistent je rychlý, ale neví, jak dlouho jste skutečně pracovali. Tyto návyky udrží vaše záznamy spolehlivé i při pozdějším vysvětlování, kam čas šel.
- Jeden záznam na jednu souvislou činnost. Tři hodinové záznamy pro tři úkoly jsou lepší než jeden tříhodinový s popisem všeho.
- Nevymýšlejte délku. Pokud si nejste jisti, délku neuvádějte a potvrďte nebo opravte návrh.
- Zkontrolujte, co už je zapsáno. Než zapíšete celý den, nechte si od asistenta vypsat záznamy za daný den, abyste nic nezapsali dvakrát.
- Pište pro klienta. Popis se může objevit na faktuře. Jedna srozumitelná věta, bez názvů souborů nebo kódu.
- Při nejistotě uveďte klienta. Jasně uvedený klient nebo projekt má přednost před tím, co asistent odvodí.
Co asistent neumí?
Asistent zapisuje to, co vy nebo on můžete doložit; neměří váš čas. Pokud chcete automaticky zaznamenat celý pracovní den, potřebujete časovou osu, jak je popsáno v Automatické sledování času.
Připojený agent vidí pouze vaše vlastní hodiny. Nevidí hodiny kolegů, nemůže je schvalovat ani vytvářet faktury. Může upravovat nebo mazat jen vaše záznamy, dokud nejsou schválené.
Jak to Half5 řeší
V Half5 najdete návod v Nastavení → „Propojení agenti“, v části „Propojit agenta“. Na obrazovce se souhlasem vidíte, ke které organizaci se připojujete a co agent smí: zobrazit a zapisovat hodiny. Neznámý klient je označen jako „Neověřená aplikace“.
Záznamy od agenta přicházejí jako „Zatím neschváleno“ a pokračují stejnou cestou jako ostatní hodiny. Half5 vybírá klienta a projekt podle toho, co agent pošle, podle vašich předchozích záznamů a podle toho, ke kterému klientovi jste dříve zapisovali z daného repozitáře. Podrobnosti najdete v Jak funguje log_work; co se děje s vašimi daty, najdete v Ochrana soukromí u AI agentů.
Často kladené dotazy
Musím něco instalovat, abych mohl(a) zapisovat hodiny přes Claude nebo ChatGPT?
Ne. Stačí zadat adresu serveru do asistenta a přihlásit se přes prohlížeč. Pouze u Claude Code a Codex vložíte jeden příkaz do terminálu.
Může asistent určit, jak dlouho jsem pracoval(a)?
Neměl by. Pokud délku neudáte, Half5 navrhne – pro dnešek – čas od posledního záznamu, a vy jej potvrdíte nebo upravíte. Pro jiný den se vás zeptá na délku.
Proč se ChatGPT častěji ptá na klienta než Claude Code?
Chatovací asistent nezná váš repozitář, takže má méně možností, jak klienta rozpoznat. Half5 pak vychází z vašeho popisu a z vašich záznamů za posledních 90 dní. Pokud klienta uvedete, ptát se nemusí.
Může agent vidět nebo schvalovat hodiny kolegů?
Ne. Připojený agent vidí jen vaše vlastní hodiny a klienty, projekty a činnosti, ke kterým máte přístup. Schvalování probíhá přímo v Half5.
Co když agent zapíše něco špatně?
Požádejte asistenta o změnu nebo smazání záznamu, nebo to udělejte sami v Half5. Dokud záznam není schválen, může jej agent upravit; poté už jen vy v aplikaci.
