De ce ai nevoie?
Trei lucruri: un cont la o aplicație de pontaj care rulează un server MCP, un asistent AI care suportă MCP și adresa serverului. Pentru Half5, adresa este https://app.half5.com/mcp.
Nu trebuie să instalezi nimic și nu ai de copiat chei API. Când conectezi, asistentul deschide o pagină de autentificare în browser. Te loghezi cu contul tău obișnuit și dai acordul. Ce este MCP, găsești explicat în Ce este MCP?.
- Asistenți pentru cod: Claude Code, Codex și Cursor. Funcționează direct în proiect și pot transmite numele repository-ului.
- Asistenți de chat: Claude.ai (inclusiv Claude Desktop și aplicația mobilă) și ChatGPT. Nu știu repository-ul, așa că întreabă mai des care este clientul.
- Altele: VS Code și alte programe care suportă un server MCP remote cu OAuth.
Cum îți conectezi asistentul?
Fiecare asistent ține setarea în alt loc. Tabelul urmează instrucțiunile afișate în Half5. Numele meniurilor din aceste aplicații se mai schimbă; dacă nu găsești unul, caută după „MCP”, „conector” sau „custom connector”.
| Asistent | Unde | Ce faci |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, apoi /mcp în Claude Code, alegi half5 și te autentifici |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, apoi codex mcp login half5; Codex îți deschide browserul |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, apoi Conectează din Setări → MCP |
| Claude.ai, Desktop, app | Setări → Conectori | Adaugă conector personalizat, lipește URL-ul și autentifică-te |
| ChatGPT | Setări → Aplicații & Conectori → Avansat | Activează modul Developer, alege Creează, lipește URL-ul și selectează OAuth |
| VS Code și altele | Setări MCP | Adaugă un server MCP remote (HTTP) cu URL-ul |
Modul Developer din ChatGPT nu e disponibil pe orice abonament. Dacă nu vezi opțiunea, verifică ce permite planul tău.
Ce îi spui asistentului?
Limbajul natural e suficient. Nu ai nevoie de ID-uri, coduri de client sau proiect. Totuși, menționează clientul sau proiectul dacă îl știi, și durata dacă o știi.
- „Înregistrează o oră și jumătate pentru această activitate.”
- „Am lucrat la integrarea cu procesatorul de plăți de la 9:00 la 11:30. Înregistrează pentru Brutăria Jansen.”
- „Înregistrează această sesiune pe proiectul Webshop.” (fără durată: aplicația propune una pe care o confirmi)
- „Ce am înregistrat ieri?”
- „Mută pontajul de azi dimineață pe proiectul Mentenanță.”
- „Șterge pontajul duplicat de azi.”
Ce se întâmplă după înregistrare?
Un pontaj venit de la un agent nu e o notă separată. E o înregistrare normală, care trece prin aceleași verificări ca și celelalte ore.
- Asistentul trimite o descriere scurtă, data, durata (dacă e cunoscută) și, pentru asistenții de cod, numele repository-ului și branch-ul.
- Aplicația de pontaj alege clientul, proiectul și activitatea. Dacă nu e sigură, asistentul te întreabă și îți dă câteva opțiuni.
- Fără durată, aplicația propune, pentru azi, timpul de la ultima înregistrare până acum. Pentru altă zi, asistentul te întreabă cât a durat. Nimic nu se salvează până nu confirmi.
- Pontajul ajunge ca neaprobat. Dacă organizația ta folosește aprobare, cineva îl verifică la fel ca pe celelalte ore.
- Pontajul apare imediat în rapoarte. Dacă e nevoie de aprobare, poate fi facturat doar după ce e aprobat.
Ce obiceiuri previn greșelile?
Un asistent e rapid, dar nu știe cât ai lucrat de fapt. Aceste obiceiuri îți păstrează pontajul corect, inclusiv când trebuie să explici ulterior unde s-au dus orele.
- O înregistrare pentru fiecare activitate continuă. Trei pontaje de câte o oră pentru trei sarcini sunt mai clare decât unul de trei ore cu totul la grămadă.
- Nu inventa durata. Dacă nu știi, lasă necompletat și confirmă sau corectează propunerea.
- Verifică ce e deja înregistrat. Înainte să înregistrezi o zi întreagă, cere-i asistentului să-ți arate pontajele din ziua respectivă, ca să nu dublezi ceva.
- Scrie pentru client. Descrierea poate ajunge pe factură. O frază clară, fără nume de fișiere sau cod.
- Menționează clientul dacă nu e clar. Un client sau proiect explicit are prioritate față de ce deduce asistentul.
Ce nu poate face?
Un asistent înregistrează ce poți justifica tu sau el; nu îți măsoară timpul. Dacă vrei să ți se înregistreze automat ziua de lucru, ai nevoie de un timeline, explicat la Pontaj automat.
Un agent conectat vede doar orele tale. Nu poate vedea orele colegilor, nu poate aproba pontaje și nu poate crea facturi. Poate edita sau șterge doar propriile tale pontaje, cât timp nu sunt aprobate.
Cum face Half5
În Half5, instrucțiunile de configurare sunt la Setări → „Agenți conectați”, în „Conectează agent”. Ecranul de consimțământ arată ce organizație conectezi și ce poate face agentul: să vadă și să înregistreze ore. Un client necunoscut apare ca „Aplicație neverificată”.
Pontajele de la un agent ajung ca „Neaprobat încă” și urmează același traseu ca celelalte ore. Half5 alege clientul și proiectul pe baza a ce trimite agentul, a pontajelor tale anterioare și a repository-urilor pe care le-ai asociat deja cu clienți. Detaliile sunt în Cum funcționează log_work; ce se întâmplă cu datele tale găsești la Confidențialitate cu agenți AI.
Întrebări frecvente
Trebuie să instalez ceva ca să înregistrez ore cu Claude sau ChatGPT?
Nu. Adaugi adresa serverului în asistent și te autentifici prin browser. Doar la Claude Code și Codex trebuie să lipești o comandă în terminal.
Poate asistentul să decidă cât am lucrat?
Nu ar trebui. Dacă nu dai o durată, Half5 propune, pentru azi, timpul de la ultima înregistrare, iar tu confirmi sau corectezi. Pentru altă zi, te întreabă cât a durat.
De ce ChatGPT întreabă mai des care e clientul față de Claude Code?
Un asistent de chat nu știe repository-ul, deci are mai puține indicii despre client. Half5 se uită atunci la descriere și la pontajele tale din ultimele 90 de zile. Dacă spui clientul, nu mai trebuie să întrebe.
Poate un agent să vadă sau să aprobe orele colegilor?
Nu. Un agent conectat vede doar orele tale și clienții, proiectele și activitățile la care ai acces. Aprobarea se face direct în Half5.
Ce fac dacă agentul înregistrează ceva greșit?
Cere-i asistentului să modifice sau să șteargă pontajul, sau fă-o direct în Half5. Cât timp pontajul nu e aprobat, agentul îl poate schimba; după aceea, modificarea se face din aplicație.