De quoi avez-vous besoin ?
De trois choses : un compte dans un outil de suivi du temps doté d’un serveur MCP, un assistant IA compatible MCP et l’adresse de ce serveur. Pour Half5, c’est https://app.half5.com/mcp.
Rien à installer, aucune clé d’API à copier. Lors de la connexion, l’assistant ouvre une page de connexion dans votre navigateur. Vous vous connectez avec votre compte habituel et donnez votre accord. Pour comprendre MCP, voyez Qu’est-ce que MCP ?.
- Assistants de code : Claude Code, Codex et Cursor. Ils travaillent dans votre projet et peuvent transmettre le nom du dépôt.
- Assistants de chat : Claude.ai (ainsi que Claude Desktop et l’application mobile) et ChatGPT. Ils ne connaissent pas votre dépôt et demandent donc plus souvent de quel client il s’agit.
- Autres : VS Code et les logiciels qui prennent en charge un serveur MCP distant avec OAuth.
Comment connecter votre assistant ?
Chaque assistant place le réglage à un endroit différent. Le tableau reprend les instructions affichées dans Half5. Les noms de menus de ces applications changent parfois ; cherchez alors « MCP », « connector » ou « custom connector ».
| Assistant | Où | Ce que vous faites |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, puis /mcp dans Claude Code, choisissez half5 et connectez-vous |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, puis codex mcp login half5 ; Codex ouvre votre navigateur |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, puis Connect dans Settings → MCP |
| Claude.ai, Desktop, app | Settings → Connectors | Add custom connector, collez l’URL et connectez-vous |
| ChatGPT | Settings → Apps & Connectors → Advanced | Activez Developer mode, choisissez Create, collez l’URL et choisissez OAuth |
| VS Code et autres | Réglages MCP | Ajoutez un serveur MCP distant (HTTP) avec l’URL |
Le Developer mode de ChatGPT n’est pas disponible dans tous les abonnements. Si l’option n’apparaît pas, vérifiez ce que votre abonnement permet.
Que dire à l’assistant ?
Le langage courant suffit. Pas besoin d’identifiants, de numéros de client ou de codes projet. Nommez toutefois le client ou le projet si vous le connaissez, et la durée si vous la connaissez.
- « Saisis une heure et demie pour ce travail. »
- « J’ai travaillé de 9 h 00 à 11 h 30 sur l’intégration du prestataire de paiement. Saisis-le sur Boulangerie Jansen. »
- « Saisis cette session sur le projet Boutique en ligne. » (sans durée : l’outil en propose une, que vous confirmez)
- « Qu’ai-je saisi hier ? »
- « Déplace la saisie de ce matin vers le projet Maintenance. »
- « Supprime la saisie en double d’aujourd’hui. »
Que se passe-t-il après la saisie ?
Une saisie faite par un agent n’est pas une note à part. C’est une saisie normale, soumise aux mêmes contrôles que vos autres heures.
- L’assistant envoie une courte description, la date, la durée (si elle est connue) et, pour les assistants de code, le nom du dépôt et la branche.
- L’outil choisit le client, le projet et l’activité. En cas de doute, l’assistant vous pose une question avec quelques options.
- Sans durée, l’outil en propose une, par exemple de la fin de votre saisie précédente jusqu’à maintenant. Rien n’est enregistré avant votre confirmation.
- La saisie arrive en statut non approuvé. Vous ou un valideur la contrôlez, comme vos autres heures.
- Une fois validée, elle entre dans les rapports et la facturation.
Quelles habitudes évitent les erreurs ?
Un assistant est rapide, mais il ne sait pas combien de temps vous avez réellement travaillé. Ces habitudes gardent votre suivi fiable, y compris quand il faut expliquer plus tard où sont passées les heures.
- Une saisie par tâche continue. Mieux vaut trois saisies d’une heure pour trois tâches qu’une seule de trois heures qui mélange tout.
- N’inventez jamais une durée. Si vous ne la connaissez pas, laissez-la de côté et confirmez ou corrigez la proposition.
- Regardez d’abord ce qui existe. Avant de saisir une journée entière, demandez à l’assistant d’afficher les saisies du jour pour éviter les doublons.
- Écrivez pour le client. La description peut figurer sur une facture. Une ligne lisible, sans noms de fichiers ni code.
- Nommez le client en cas de doute. Un client ou un projet indiqué explicitement l’emporte toujours sur ce que l’assistant déduit.
Qu’est-ce que cela ne fait pas ?
Un assistant saisit ce que vous ou lui pouvez justifier ; il ne mesure pas votre temps. Pour enregistrer votre journée automatiquement, il faut une chronologie, comme décrit dans Le suivi du temps automatique.
Par ailleurs, un agent connecté ne voit que vos propres heures. Il ne peut ni consulter les heures de vos collègues, ni valider des heures, ni créer de factures. Il ne peut modifier ou supprimer que vos propres saisies tant qu’elles ne sont pas validées.
Comment Half5 s'y prend
Dans Half5, les instructions se trouvent dans Paramètres → « Agents liés », sous « Lier un agent ». L’écran d’autorisation indique quelle organisation vous connectez et ce que l’agent peut faire : consulter et saisir des heures. Un client inconnu y apparaît comme application non vérifiée.
Les saisies d’un agent arrivent avec le statut « Pas encore approuvé » et suivent ensuite le même chemin que vos autres heures. Half5 choisit le client et le projet d’après ce que l’agent transmet, vos saisies précédentes et le client sur lequel vous avez déjà saisi tel dépôt. Les détails sont dans Comment fonctionne log_work ; le traitement de vos données dans Confidentialité et agents IA.
Questions fréquentes
Faut-il installer quelque chose pour saisir ses heures avec Claude ou ChatGPT ?
Non. Vous ajoutez l’adresse du serveur dans votre assistant et vous vous connectez dans le navigateur. Seuls Claude Code et Codex demandent de coller une commande dans le terminal.
L’assistant peut-il décider combien de temps j’ai travaillé ?
Il ne devrait pas. Si vous n’indiquez pas de durée, Half5 en propose une à partir de votre saisie précédente et de l’heure actuelle, et vous la confirmez ou la corrigez.
Pourquoi ChatGPT demande-t-il plus souvent le client que Claude Code ?
Un assistant de chat ne connaît pas votre dépôt et dispose donc de moins d’indices pour reconnaître le client. Après quelques saisies confirmées, Half5 connaît vos habitudes et pose moins de questions.
Un agent peut-il voir ou valider les heures de mes collègues ?
Non. Un agent connecté ne voit que vos propres heures et les clients, projets et activités que vous avez le droit de voir. La validation se fait dans Half5.
Et si l’agent saisit quelque chose de faux ?
Demandez à l’assistant de modifier ou de supprimer la saisie, ou faites-le vous-même dans Half5. Tant qu’elle n’est pas validée, l’agent peut la modifier ; ensuite, cela se fait dans l’application.
