Mire van szükséged?
Három dologra: egy időnyilvántartó fiókra, amely MCP szervert futtat, egy MCP-t támogató AI asszisztensre, és a szerver címére. Half5 esetén ez: https://app.half5.com/mcp.
Nincs telepítés, API kulcsot sem kell másolni. Összekötéskor az asszisztens megnyit egy bejelentkező oldalt a böngésződben. A szokásos fiókoddal jelentkezel be és adsz engedélyt. Hogy pontosan mi az MCP, azt itt találod: Mi az MCP?.
- Kódoló asszisztensek: Claude Code, Codex és Cursor. Ezek a projekteden belül működnek, és továbbítják a repository nevét is.
- Chat asszisztensek: Claude.ai (asztali és mobil app is) és ChatGPT. Ők nem ismerik a repository-t, ezért gyakrabban rákérdeznek, melyik ügyfélről van szó.
- Egyéb: VS Code és más programok, amelyek támogatják a távoli MCP szervert OAuth-tal.
Hogyan kötöd össze az asszisztenst?
Minden asszisztens máshol tárolja ezt a beállítást. Az alábbi táblázat a Half5-ben látható lépéseket követi. Az appok menünevei időnként változnak; ha nem találod, keresd az ‘MCP’, ‘connector’ vagy ‘custom connector’ kifejezéseket.
| Asszisztens | Hol | Teendő |
|---|---|---|
| Claude Code | Terminál | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, majd /mcp Claude Code-ban, válaszd a half5-öt és jelentkezz be |
| Codex | Terminál | codex mcp add half5 --url https://app.half5.com/mcp, majd codex mcp login half5; Codex megnyitja a böngészőt |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, majd Csatlakozás a Beállítások → MCP alatt |
| Claude.ai, asztali, app | Beállítások → Csatlakozók | Egyéni csatlakozó hozzáadása, URL beillesztése és bejelentkezés |
| ChatGPT | Beállítások → Alkalmazások & Csatlakozók → Haladó | Fejlesztői mód bekapcsolása, Új létrehozása, URL beillesztése és OAuth kiválasztása |
| VS Code és mások | MCP beállítások | Távoli (HTTP) MCP szerver hozzáadása az URL-lel |
A ChatGPT fejlesztői módja nem minden csomagban érhető el. Ha nem látod az opciót, nézd meg, mit tartalmaz az előfizetésed.
Mit mondj az asszisztensnek?
Egyszerű, hétköznapi nyelv elég. Nem kell ID, ügyfélszám vagy projektkód. Ha tudod, nevezd meg az ügyfelet vagy projektet, és az időtartamot is.
- ‘Rögzíts másfél órát erre a munkára.’
- ‘A fizetési szolgáltató integrációján dolgoztam 9:00-tól 11:30-ig. Ezt rögzítsd a Jansen Pékséghez.’
- ‘Ezt az ülést rögzítsd a Webshop projekthez.’ (ha nincs időtartam: az időnyilvántartó javasol egyet, amit jóváhagysz)
- ‘Mit rögzítettem tegnap?’
- ‘Tedd át a mai reggeli bejegyzést a Karbantartás projekthez.’
- ‘Töröld a mai duplikált bejegyzést.’
Mi történik rögzítés után?
Egy ügynöktől érkező bejegyzés nem megjegyzés: teljes értékű rögzítés, ugyanazokon az ellenőrzéseken megy át, mint a többi órád.
- Az asszisztens elküldi a rövid leírást, a dátumot, az időtartamot (ha ismert), és kódoló asszisztensnél a repository nevét, branch-et.
- Az időnyilvántartó kiválasztja az ügyfelet, projektet és tevékenységet. Ha nem biztos benne, az asszisztens kérdez, néhány opcióval.
- Ha nincs időtartam, az időnyilvántartó ma a legutóbbi bejegyzésed vége óta eltelt időt javasolja. Más napra az asszisztens rákérdez az időtartamra. Semmi sem kerül mentésre, amíg nem hagyod jóvá.
- A bejegyzés ‘Nincs jóváhagyva’ státusszal érkezik. Ha a szervezetnél van jóváhagyás, egy jóváhagyó ugyanúgy ellenőrzi, mint a többi órádat.
- A bejegyzés azonnal megjelenik a kimutatásokban. Ha van jóváhagyás, csak jóváhagyás után kerülhet számlára.
Milyen szokásokkal kerülheted el a hibákat?
Az asszisztens gyors, de nem tudja, ténylegesen mennyit dolgoztál. Ezekkel a szokásokkal megbízható marad a nyilvántartásod, később is könnyen el tudod magyarázni, mire ment el az idő.
- Egy bejegyzés egy összefüggő feladathoz. Három egyórás bejegyzés három munkára többet ér, mint egy háromórás mindennel.
- Ne találj ki időtartamot. Ha nem tudod, hagyd üresen, és hagyd jóvá vagy javítsd a javaslatot.
- Nézd meg, mi van már rögzítve. Mielőtt egy egész napot rögzítenél, kérd meg az asszisztenst, hogy sorolja fel az aznapi bejegyzéseket, így nem lesz duplikáció.
- Az ügyfélnek írj. A leírás akár a számlára is rákerülhet. Egy olvasható mondat, fájlnevek és kód nélkül.
- Nevezd meg az ügyfelet, ha bizonytalan vagy. Egyértelmű ügyfél vagy projekt mindig előnyt élvez az asszisztens tippjeivel szemben.
Mit nem tud az asszisztens?
Az asszisztens csak azt rögzíti, amit te vagy ő igazolni tudtok; nem méri az idődet. Ha azt szeretnéd, hogy a munkanapod automatikusan rögzüljön, idővonalra van szükséged, erről itt olvashatsz: Automatikus időnyilvántartás.
Egy összekötött ügynök csak a saját óráidat látja. Nem fér hozzá a kollégák óráihoz, nem hagyhat jóvá órákat, nem készíthet számlát. Csak a saját, még nem jóváhagyott bejegyzéseidet szerkesztheti vagy törölheti.
Így csinálja a Half5
Half5-ben a beállításokat a Beállítások → ‘Összekapcsolt ügynökök’ menüpontban, a ‘Ügynök összekapcsolása’ alatt találod. Az engedélykérő képernyő mutatja, melyik szervezethez kapcsolod, és mit tehet az ügynök: órák megtekintése és rögzítése. Ismeretlen ügyfél esetén ‘Nem ellenőrzött app’ feliratot látsz.
Ügynöktől érkező bejegyzések ‘Még nincs jóváhagyva’ státusszal érkeznek, és ugyanazon az útvonalon mennek végig, mint a többi órád. Half5 az ügynök által küldött adatok, a korábbi bejegyzéseid és a repository-ügyfél párosítások alapján választ ügyfelet és projektet. Részletek: Így működik a log_work; az adataid sorsáról itt olvashatsz: Adatvédelem AI ügynökökkel.
Gyakori kérdések
Kell bármit telepítenem, ha Claude-dal vagy ChatGPT-vel rögzítenék órát?
Nem. Az asszisztensben adod meg a szerver címet, majd böngészőben jelentkezel be. Csak Claude Code és Codex esetén kell egy parancsot bemásolni a terminálba.
Az asszisztens eldöntheti, mennyit dolgoztam?
Nem kellene. Ha nem adsz meg időtartamot, Half5 ma a legutóbbi bejegyzésed vége óta eltelt időt javasolja, ezt jóváhagyod vagy javítod. Más napra rákérdez az időtartamra.
Miért kérdez rá ChatGPT gyakrabban az ügyfélre, mint Claude Code?
A chat asszisztens nem ismeri a repository-t, így kevesebb támpontja van az ügyfél felismeréséhez. Half5 ilyenkor a leírásból és az elmúlt 90 nap bejegyzéseiből próbál következtetni. Ha megnevezed az ügyfelet, nem kell kérdeznie.
Láthatja vagy jóváhagyhatja egy ügynök a kollégáim óráit?
Nem. Egy összekötött ügynök csak a saját óráidat, illetve azokat az ügyfeleket, projekteket és tevékenységeket látja, amelyekhez jogosultságod van. Jóváhagyás Half5-ben történik.
Mi van, ha az ügynök rosszul rögzít valamit?
Kérd meg az asszisztenst, hogy módosítsa vagy törölje a bejegyzést, vagy tedd meg te magad Half5-ben. Amíg nincs jóváhagyva a bejegyzés, az ügynök is módosíthatja; utána már csak az appban tudod javítani.