Cosa ti serve?
Tre cose: un account su un time tracker che supporta un server MCP, un assistente AI compatibile con MCP e l’indirizzo del server. Per Half5 l’indirizzo è https://app.half5.com/mcp.
Non c’è nulla da installare e nessuna API key da copiare. Quando colleghi l’assistente, si apre una pagina di accesso nel browser. Accedi con il tuo account e dai il consenso. Cos’è MCP lo trovi spiegato in Cos’è MCP?.
- Assistenti per il codice: Claude Code, Codex e Cursor. Lavorano dentro il tuo progetto e possono trasmettere il nome del repository.
- Assistenti chat: Claude.ai (anche Desktop e app mobile) e ChatGPT. Non conoscono il tuo repository, quindi chiedono più spesso quale cliente indicare.
- Altri: VS Code e altri programmi che supportano un server MCP remoto con OAuth.
Come colleghi il tuo assistente?
Ogni assistente tiene l’impostazione in un punto diverso. La tabella segue le istruzioni che vedi dentro Half5. I nomi dei menu possono cambiare; se non trovi una voce, cerca ‘MCP’, ‘connettore’ o ‘custom connector’.
| Assistente | Dove | Cosa fare |
|---|---|---|
| Claude Code | Terminale | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, poi /mcp in Claude Code, scegli half5 e accedi |
| Codex | Terminale | codex mcp add half5 --url https://app.half5.com/mcp, poi codex mcp login half5; Codex apre il browser |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, poi Connetti in Impostazioni → MCP |
| Claude.ai, Desktop, app | Impostazioni → Connettori | Aggiungi connettore personalizzato, incolla l’URL e accedi |
| ChatGPT | Impostazioni → App & Connettori → Avanzate | Attiva la modalità Sviluppatore, scegli Crea, incolla l’URL e seleziona OAuth |
| VS Code e altri | Impostazioni MCP | Aggiungi un server MCP remoto (HTTP) con l’URL |
La modalità Sviluppatore in ChatGPT non è disponibile su tutti i piani. Se non vedi l’opzione, controlla cosa prevede il tuo abbonamento.
Cosa dici all’assistente?
Basta il linguaggio naturale. Non servono ID, numeri cliente o codici progetto. Se li sai, indica cliente o progetto e la durata.
- ‘Registra un’ora e mezza per questo lavoro.’
- ‘Ho lavorato sull’integrazione del provider di pagamento dalle 9:00 alle 11:30. Registra per Panificio Jansen.’
- ‘Registra questa sessione sul progetto Webshop.’ (senza durata: il time tracker propone una durata da confermare)
- ‘Cosa ho registrato ieri?’
- ‘Sposta la registrazione di stamattina sul progetto Manutenzione.’
- ‘Elimina la registrazione doppia di oggi.’
Cosa succede dopo la registrazione?
Una registrazione inviata da un assistente non è una nota a margine. È una registrazione normale che segue gli stessi controlli delle altre ore.
- L’assistente invia una breve descrizione, la data, la durata (se nota) e, per gli assistenti di codice, nome e branch del repository.
- Il time tracker seleziona cliente, progetto e attività. Se non è sicuro, l’assistente ti fa una domanda con alcune opzioni.
- Se manca la durata, il time tracker propone, per oggi, il tempo trascorso dall’ultima registrazione. Per un altro giorno, l’assistente ti chiede la durata. Nulla viene salvato finché non confermi.
- La registrazione arriva come non approvata. Se la tua organizzazione usa l’approvazione, un responsabile la controlla come le altre ore.
- La registrazione viene conteggiata subito nei report. Se l’approvazione è attiva, può andare in fattura solo dopo essere stata approvata.
Quali abitudini evitano errori?
Un assistente è veloce, ma non sa davvero quanto hai lavorato. Queste abitudini rendono i tuoi dati affidabili, anche quando dovrai spiegare come hai usato il tempo.
- Una registrazione per ogni attività continua. Tre registrazioni da un’ora per tre lavori sono meglio di una da tre ore con tutto dentro.
- Non inventare mai la durata. Se non la sai, lasciala vuota e conferma o correggi la proposta.
- Controlla cosa c’è già. Prima di registrare tutta la giornata, chiedi all’assistente di elencare le registrazioni di quel giorno così eviti doppioni.
- Scrivi per il cliente. La descrizione può finire in fattura. Una riga chiara, niente nomi file o codice.
- Indica il cliente se hai dubbi. Un cliente o progetto esplicito è sempre meglio di quello che l’assistente deduce.
Cosa non può fare?
Un assistente registra solo ciò che tu (o lui) puoi giustificare; non misura il tempo. Se vuoi che la tua giornata lavorativa venga rilevata automaticamente, ti serve una timeline, come descritto in Registrazione automatica delle ore.
Un agente collegato vede solo le tue ore. Non può vedere le ore dei colleghi, approvare registrazioni o creare fatture. Può modificare o eliminare solo le tue registrazioni finché non sono approvate.
Ecco come funziona Half5
In Half5 le istruzioni di configurazione sono in Impostazioni → ‘Agenti collegati’, in ‘Collega agente’. La schermata di consenso mostra a quale organizzazione stai collegando e cosa può fare l’agente: vedere e registrare ore. Un cliente sconosciuto viene indicato come ‘App non verificata’.
Le registrazioni da un agente arrivano come ‘Non ancora approvata’ e seguono lo stesso percorso delle altre ore. Half5 sceglie cliente e progetto in base a quanto inviato dall’agente, alle tue registrazioni precedenti e a quali repository hai già associato a quali clienti. I dettagli sono in Come funziona log_work; cosa succede ai tuoi dati è spiegato in Privacy con agenti AI.
Domande frequenti
Devo installare qualcosa per registrare le ore con Claude o ChatGPT?
No. Inserisci l’indirizzo del server nell’assistente e accedi dal browser. Solo per Claude Code e Codex serve incollare un comando nel terminale.
L’assistente può decidere quanto ho lavorato?
Non dovrebbe. Se non indichi la durata, Half5 propone, per oggi, il tempo dall’ultima registrazione, e tu confermi o correggi. Per un altro giorno ti chiede la durata.
Perché ChatGPT chiede più spesso il cliente rispetto a Claude Code?
Un assistente chat non conosce il tuo repository, quindi ha meno elementi per riconoscere il cliente. Half5 allora guarda la descrizione e le tue registrazioni degli ultimi 90 giorni. Se indichi il cliente, non deve chiedere.
Un agente può vedere o approvare le ore dei colleghi?
No. Un agente collegato vede solo le tue ore e i clienti, progetti e attività a cui hai accesso. L’approvazione avviene direttamente in Half5.
Cosa succede se l’agente registra qualcosa di sbagliato?
Chiedi all’assistente di modificare o eliminare la registrazione, oppure fallo tu in Half5. Finché la registrazione non è approvata, l’agente può cambiarla; dopo, puoi farlo solo dall’app.