Wat heb je nodig?
Drie dingen: een account bij een urenregistratie met een MCP-server, een AI-assistent die MCP ondersteunt en het adres van die server. Voor Half5 is dat adres https://app.half5.com/mcp.
Je hoeft niets te installeren en geen API-sleutel te kopiëren. Bij het koppelen opent de assistent een inlogscherm in je browser. Daar log je in met je gewone account en geef je toestemming. Wat MCP precies is, lees je in Wat is MCP?.
- Code-assistenten: Claude Code, Codex en Cursor. Ze werken in je project en kunnen de naam van de repository meesturen.
- Chat-assistenten: Claude.ai (ook Claude Desktop en de mobiele app) en ChatGPT. Ze kennen je repository niet, dus ze vragen vaker welke klant het is.
- Overig: VS Code en andere programma’s die een MCP-server op afstand met OAuth ondersteunen.
Hoe koppel je je assistent?
Per assistent zit de instelling op een andere plek. De tabel hieronder volgt de koppelinstructies die in Half5 zelf staan. Menunamen in deze apps veranderen soms; zoek dan naar ‘MCP’, ‘connector’ of ‘custom connector’.
| Assistent | Waar | Wat je doet |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, dan in Claude Code /mcp, kies half5 en log in |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp en daarna codex mcp login half5; Codex opent je browser |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, dan Connect onder Settings → MCP |
| Claude.ai, Desktop, app | Settings → Connectors | Add custom connector, plak de URL en log in |
| ChatGPT | Settings → Apps & Connectors → Advanced | Zet Developer mode aan, kies Create, plak de URL en kies OAuth |
| VS Code en andere | MCP-instellingen | Voeg een MCP-server op afstand (HTTP) toe met de URL |
Developer mode in ChatGPT is niet bij elk abonnement beschikbaar. Zie je de optie niet, kijk dan wat jouw abonnement toestaat.
Wat zeg je tegen de assistent?
Gewone taal is genoeg. Je hoeft geen ID’s, klantnummers of projectcodes te kennen. Noem wel de klant of het project als je dat weet, en noem de tijd als je die weet.
- ‘Boek anderhalf uur op dit werk.’
- ‘Ik heb van 9:00 tot 11:30 aan de koppeling met de betaalprovider gewerkt. Boek dat op Bakkerij Jansen.’
- ‘Boek deze sessie op het project Webshop.’ (zonder duur: dan stelt de urenregistratie een duur voor die je bevestigt)
- ‘Wat heb ik gisteren geboekt?’
- ‘Zet de boeking van vanochtend op het project Onderhoud.’
- ‘Verwijder de dubbele boeking van vandaag.’
Wat gebeurt er na het boeken?
Een boeking van een agent is geen los notitieblok, maar een gewone registratie die door dezelfde controle gaat als je andere uren.
- De assistent stuurt een korte omschrijving, de datum, de duur (als die bekend is) en bij code-assistenten de naam van de repository en de branch.
- De urenregistratie kiest de klant, het project en de activiteit. Twijfelt hij, dan stelt de assistent je een vraag met een paar opties.
- Zonder duur stelt de urenregistratie er een voor, bijvoorbeeld vanaf het einde van je vorige boeking tot nu. Er wordt pas iets opgeslagen als je bevestigt.
- De boeking komt binnen als niet goedgekeurd. Jij of een goedkeurder controleert hem, net als je andere uren.
- Na goedkeuring gaat de boeking mee in rapporten en facturatie.
Welke gewoontes voorkomen fouten?
Een assistent is snel, maar hij weet niet hoe lang je echt hebt gewerkt. Deze gewoontes houden je administratie betrouwbaar, ook als je later moet uitleggen waar de uren heen gingen.
- Eén boeking per aaneengesloten taak. Liever drie boekingen van een uur voor drie klussen dan één van drie uur met alles erin.
- Verzin nooit een duur. Weet je het niet, laat de duur dan weg en bevestig of corrigeer het voorstel.
- Kijk eerst wat er al staat. Laat de assistent bij een hele dag eerst je boekingen van die dag opvragen, zodat niets dubbel komt te staan.
- Schrijf voor de klant. De omschrijving kan op een factuur komen. Eén leesbare regel, zonder bestandsnamen of code.
- Noem de klant als je twijfelt. Een expliciete klant of project gaat altijd voor op wat de assistent afleidt.
Wat kan het niet?
Een assistent boekt wat jij of hij kan onderbouwen; hij meet je tijd niet. Wil je dat je werkdag vanzelf wordt vastgelegd, dan heb je een tijdlijn nodig, zoals beschreven in Automatisch uren registreren.
Verder ziet een gekoppelde agent alleen je eigen uren. Hij kan geen uren van collega’s inzien, geen uren goedkeuren en geen facturen maken. Hij kan alleen je eigen boekingen wijzigen of verwijderen zolang ze nog niet zijn goedgekeurd.
Zo doet Half5 het
In Half5 vind je de koppelinstructies onder Instellingen → ‘Gekoppelde agents’, bij ‘Agent koppelen’. Op het toestemmingsscherm zie je welke organisatie je koppelt en wat de agent mag: ‘Uren bekijken’ en ‘Uren registreren’. Een onbekende client staat daar als ‘Niet-geverifieerde app’.
Boekingen van een agent komen binnen als ‘Nog niet goedgekeurd’ en volgen daarna dezelfde weg als je andere uren. Half5 kiest klant en project op basis van wat de agent meestuurt, je eerdere boekingen en welke repository je eerder op welke klant boekte. Hoe dat precies werkt, lees je in Zo werkt log_work; wat er met je gegevens gebeurt in Privacy bij AI-agents.
Veelgestelde vragen
Moet ik iets installeren om uren te boeken met Claude of ChatGPT?
Nee. Je voegt het serveradres toe in je assistent en logt in via je browser. Alleen bij Claude Code en Codex plak je daarvoor één commando in je terminal.
Kan de assistent zelf bepalen hoe lang ik heb gewerkt?
Dat moet hij niet doen. Noem je geen duur, dan stelt Half5 er een voor op basis van je vorige boeking en het huidige tijdstip, en die bevestig of corrigeer je.
Waarom vraagt ChatGPT vaker welke klant het is dan Claude Code?
Een chat-assistent kent je repository niet en heeft dus minder om de klant op te herkennen. Na een paar bevestigde boekingen kent Half5 je gewoontes en hoeft hij minder te vragen.
Kan een agent uren van mijn collega’s zien of goedkeuren?
Nee. Een gekoppelde agent ziet alleen je eigen uren en de klanten, projecten en activiteiten die jij mag zien. Goedkeuren gebeurt in Half5 zelf.
Wat als de agent iets verkeerd boekt?
Vraag de assistent de boeking aan te passen of te verwijderen, of doe het zelf in Half5. Zolang een boeking nog niet is goedgekeurd, kan de agent hem wijzigen; daarna doe je dat in de app.
