Czego potrzebujesz?
Trzech rzeczy: konta w rejestratorze czasu, który obsługuje serwer MCP, asystenta AI wspierającego MCP i adresu serwera. Dla Half5 to https://app.half5.com/mcp.
Nie musisz nic instalować ani kopiować klucza API. Przy łączeniu asystent otwiera stronę logowania w Twojej przeglądarce. Logujesz się swoim zwykłym kontem i wyrażasz zgodę. Czym dokładnie jest MCP, wyjaśniamy w Czym jest MCP?.
- Asystenci programistyczni: Claude Code, Codex i Cursor. Działają w Twoim projekcie i mogą przekazać nazwę repozytorium.
- Asystenci czatu: Claude.ai (także Claude Desktop i aplikacja mobilna) oraz ChatGPT. Nie znają Twojego repozytorium, więc częściej pytają, o którego klienta chodzi.
- Inne: VS Code i inne programy obsługujące zdalny serwer MCP z OAuth.
Jak połączyć asystenta?
Każdy asystent trzyma ustawienia w innym miejscu. Poniżej znajdziesz instrukcje zgodne z tym, co pokazuje Half5. Nazwy menu w tych aplikacjach czasem się zmieniają; jeśli nie możesz czegoś znaleźć, szukaj „MCP”, „connector” lub „custom connector”.
| Asystent | Gdzie | Co robisz |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, potem /mcp w Claude Code, wybierz half5 i zaloguj się |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, potem codex mcp login half5; Codex otworzy przeglądarkę |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, potem Połącz w Ustawienia → MCP |
| Claude.ai, Desktop, aplikacja | Ustawienia → Connectors | Dodaj własny connector, wklej adres URL i zaloguj się |
| ChatGPT | Ustawienia → Apps & Connectors → Zaawansowane | Włącz tryb deweloperski, wybierz Utwórz, wklej adres URL i wybierz OAuth |
| VS Code i inne | Ustawienia MCP | Dodaj zdalny (HTTP) serwer MCP z tym adresem URL |
Tryb deweloperski w ChatGPT nie jest dostępny w każdym planie. Jeśli nie widzisz tej opcji, sprawdź, co obejmuje Twój plan.
Co powiedzieć asystentowi?
Wystarczy zwykły język. Nie potrzebujesz ID, numerów klientów ani kodów projektów. Jeśli znasz klienta lub projekt, powiedz to, podobnie z czasem.
- „Zarejestruj półtorej godziny za tę pracę.”
- „Pracowałem nad integracją płatności od 9:00 do 11:30. Zarejestruj to dla Jansen Bakery.”
- „Zarejestruj tę sesję przy projekcie Webshop.” (bez czasu: rejestrator zaproponuje czas do potwierdzenia)
- „Co rejestrowałem wczoraj?”
- „Przenieś dzisiejszy poranny wpis do projektu Maintenance.”
- „Usuń zduplikowany wpis z dzisiaj.”
Co dzieje się po rejestracji?
Wpis od agenta to nie notatka na marginesie. To zwykła rejestracja, która przechodzi te same kontrole co pozostałe godziny.
- Asystent przesyła krótki opis, datę, czas (jeśli znany) oraz – w przypadku asystentów programistycznych – nazwę repozytorium i gałąź.
- Rejestrator czasu wybiera klienta, projekt i czynność. Jeśli nie jest pewien, asystent zadaje pytanie z kilkoma opcjami.
- Jeśli nie podasz czasu, rejestrator zaproponuje – dla dziś – czas od zakończenia poprzedniego wpisu. Dla innego dnia asystent zapyta o czas. Nic nie zostaje zapisane bez Twojego potwierdzenia.
- Wpis trafia jako niezaakceptowany. Jeśli w Twojej organizacji jest akceptacja, ktoś go zatwierdza jak inne godziny.
- Wpis od razu liczy się w raportach. Jeśli jest wymagana akceptacja, na fakturę trafi dopiero po zatwierdzeniu.
Jakie nawyki zapobiegają błędom?
Asystent jest szybki, ale nie wie, ile naprawdę pracowałeś. Te nawyki sprawią, że Twoje zapisy będą rzetelne – także gdy później trzeba będzie wyjaśnić, na co poszły godziny.
- Jeden wpis na jedno zadanie. Trzy wpisy po godzinie za trzy zadania są lepsze niż jeden trzygodzinny z opisem wszystkiego.
- Nie wymyślaj czasu. Jeśli nie wiesz, zostaw puste i potwierdź lub popraw propozycję.
- Sprawdź, co już jest. Zanim zarejestrujesz cały dzień, poproś asystenta o listę wpisów z tego dnia, żeby nie dublować godzin.
- Pisz z myślą o kliencie. Opis może trafić na fakturę. Jedno czytelne zdanie, bez nazw plików czy kodu.
- Podaj klienta, jeśli masz wątpliwość. Jasno wskazany klient lub projekt zawsze jest ważniejszy niż to, co asystent wywnioskuje.
Czego asystent nie zrobi?
Asystent rejestruje to, co Ty lub on możecie uzasadnić; nie mierzy czasu pracy. Jeśli chcesz, by Twój dzień pracy był rejestrowany automatycznie, potrzebujesz osi czasu – opisanej w Automatyczna rejestracja czasu.
Połączony agent widzi tylko Twoje godziny. Nie zobaczy godzin kolegów, nie zaakceptuje ich ani nie wystawi faktury. Może edytować lub usuwać tylko Twoje wpisy, dopóki nie zostały zaakceptowane.
Jak to robi Half5
W Half5 instrukcje znajdziesz w Ustawienia → „Połączeni agenci”, w „Połącz agenta”. Ekran zgody pokazuje, z którą organizacją się łączysz i co agent może zrobić: przeglądać i rejestrować godziny. Nieznany klient to „Niezaufana aplikacja”.
Wpisy od agenta trafiają jako „Jeszcze niezaakceptowane” i dalej idą tą samą ścieżką co inne godziny. Half5 wybiera klienta i projekt na podstawie danych od agenta, wcześniejszych wpisów i tego, które repozytorium wcześniej rejestrowałeś dla którego klienta. Szczegóły znajdziesz w Jak działa log_work; co dzieje się z Twoimi danymi – w Prywatność z agentami AI.
Najczęstsze pytania
Czy muszę coś instalować, żeby rejestrować godziny z Claude lub ChatGPT?
Nie. Dodajesz adres serwera w asystencie i logujesz się przez przeglądarkę. Tylko w Claude Code i Codex wklejasz jedno polecenie do terminala.
Czy asystent może sam zdecydować, ile pracowałem?
Nie powinien. Jeśli nie podasz czasu, Half5 zaproponuje – dla dziś – czas od zakończenia poprzedniego wpisu, a Ty go potwierdzasz lub poprawiasz. Dla innego dnia asystent zapyta o czas.
Dlaczego ChatGPT częściej pyta o klienta niż Claude Code?
Asystent czatu nie zna Twojego repozytorium, więc ma mniej danych, by rozpoznać klienta. Half5 wtedy patrzy na opis i Twoje wpisy z ostatnich 90 dni. Jeśli podasz klienta, nie musi pytać.
Czy agent widzi lub akceptuje godziny moich kolegów?
Nie. Połączony agent widzi tylko Twoje godziny oraz klientów, projekty i czynności, do których masz dostęp. Akceptacja odbywa się w Half5.
Co jeśli agent zarejestruje coś błędnie?
Poproś asystenta o zmianę lub usunięcie wpisu, albo zrób to sam w Half5. Dopóki wpis nie jest zaakceptowany, agent może go zmienić; potem zrobisz to w aplikacji.