Suivre son temps depuis Claude Code et Cursor avec le serveur MCP Sandtime.io

Le meilleur moment pour enregistrer son temps est celui où l’on arrête de taper, et pour un développeur ce moment se produit dans un éditeur ou un terminal, pas dans un outil de suivi du temps. Sandtime.io fournit un serveur MCP : Claude Code, Cursor, Claude Desktop, Codex et tout autre client Model Context Protocol peuvent créer, lire et corriger vos saisies de temps en langage naturel. Voici ce qu’il fait, comment le connecter en une commande, et à quoi ressemble une vraie demande de bout en bout.

Pourquoi le suivi du temps a sa place dans la session de code

Les développeurs n’oublient pas de suivre leur temps par négligence. Ils l’oublient parce que l’outil vit dans un onglet de navigateur, à trois changements de contexte du terminal, et qu’au moment où l’onglet est ouvert le travail s’est déjà fondu dans la tâche suivante. Les feuilles de temps de fin de mois sont alors reconstruites à partir de l’historique git et du calendrier, ce qui est lent et jamais tout à fait juste.

Un assistant déjà présent dans la session change la donne. Le contexte est là : quel dépôt, quel ticket, à peu près combien de temps. Dire « enregistre ça comme deux heures sur la migration de l’API » ne coûte rien, et la saisie arrive avec le bon projet, le bon jour, et des heures de début et de fin qui n’entrent en collision avec rien d’autre.

Le Model Context Protocol est la tuyauterie qui rend cela possible. Un serveur MCP expose des outils qu’un client comme Claude Code ou Cursor peut appeler en votre nom. Le serveur de Sandtime.io expose son suivi du temps sous forme de ces outils, en Streamable HTTP, avec les mêmes droits que votre compte dans l’application.

Ce que le serveur sait faire

La liste complète, avec les paramètres de chaque outil, se trouve sur la page du serveur MCP. Ceux qui comptent pendant une session de code :

• Saisies de temps : create_activity, update_activity, delete_activity, stop_activity et list_activities sur une plage de dates, plus fill_activities pour remplir une semaine entière selon un schéma.
• Projets et personnes : list_projects, get_project, list_project_members, get_current_user.
• État de la feuille de temps : get_timesheet_status, lock_timesheet, unlock_timesheet, request_timesheet_unlock, et les outils d’approbation ou de rejet des demandes de déverrouillage.
• Rapports : get_time_summary pour des totaux rapides, create_report et list_reports pour les mêmes rapports que l’application web.
• Calendrier : get_calendar renvoie les jours ouvrés et les jours fériés de votre organisation, donc « remplis la semaine dernière, saute le jour férié » fonctionne sans que vous nommiez le jour férié.

Chaque écriture passe par la même détection des chevauchements que l’application. Si la saisie demandée entre en collision avec une saisie existante, le serveur renvoie les conflits et l’assistant vous prévient au lieu de compter l’heure deux fois en silence.

Connecter Claude Code

La commande ci-dessous est celle qu’affiche la page MCP. Elle enregistre le serveur pour votre utilisateur, donc il est disponible dans tous les projets de la machine, et la seconde commande ouvre le navigateur pour approuver l’accès :

claude mcp add --transport http --scope user sandtime https://mcp.sandtime.io/mcp
claude mcp login sandtime

Vous préférez une clé API, par exemple sur une machine de CI ou sans navigateur ? Créez-en une dans Sandtime.io sous Paramètres, puis Intégrations, puis API, et passez-la dans un en-tête :

claude mcp add --transport http --scope user sandtime https://mcp.sandtime.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

Utilisez --scope project au lieu de --scope user pour inscrire le serveur dans le .mcp.json d’un dépôt, afin que chaque contributeur l’obtienne. Vérifiez avec claude mcp list : sandtime doit apparaître comme connecté. Claude Desktop lit un autre fichier de configuration ; la page MCP en donne le JSON.

Connecter Cursor

Cursor lit ses serveurs MCP dans mcp.json, globalement sous ~/.cursor/ ou par projet sous .cursor/. Le serveur distant a besoin d’une URL et, tant que Cursor ne termine pas la connexion par navigateur, d’un en-tête avec la clé API :

{
  "mcpServers": {
    "sandtime": {
      "url": "https://mcp.sandtime.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

La page MCP propose un bouton Add to Cursor qui remplit cela pour vous. Une fois le serveur au vert dans les réglages MCP de Cursor, les outils sont disponibles en mode agent.

Codex CLI, Gemini CLI et GitHub Copilot dans VS Code suivent le même schéma : ajouter l’URL du serveur, envoyer la clé en en-tête Bearer, et les outils apparaissent. La page MCP consacre une section à chaque client.

Exemple concret : « enregistre 2 heures sur le projet X pour hier »

Voici ce qu’un bon assistant fait de cette phrase, outil par outil. L’intérêt de dérouler les étapes est de montrer que rien n’est deviné : chaque étape lit avant d’écrire.

Si l’étape 3 avait montré un après-midi déjà plein, l’étape 4 n’aurait pas lieu. L’assistant signalerait la collision et demanderait où placer les deux heures, exactement comme le ferait un collègue avant de modifier votre feuille de temps.

Des variantes qui fonctionnent de la même façon :

• « Remplis la semaine dernière avec 8 heures par jour sur le projet plateforme, saute vendredi, c’était férié » appelle get_calendar, puis fill_activities.
• « Qu’ai-je saisi cette semaine, par projet ? » appelle get_time_summary.
• « Arrête mon minuteur » appelle stop_activity sur la saisie sans heure de fin.
• « La semaine 35 est-elle verrouillée ? » appelle get_timesheet_status, et « demande un déverrouillage, je dois corriger mardi » appelle request_timesheet_unlock, que votre administrateur voit dans l’application.

Ce que le serveur ne fera pas

Il ne vous surveille pas. Aucune capture des commits, des fenêtres, du clavier ou de l’écran, sur aucun plan, et rien de tel n’est prévu. L’assistant ne sait que ce que vous lui dites dans la session et n’écrit que ce que vous avez demandé. C’est un choix délibéré : une heure que vous avez déclarée est une heure que vous assumerez quand la feuille de temps sera approuvée, et une équipe qui fait confiance à ses relevés n’a pas besoin d’une couche de surveillance pour les produire.

Il reste aussi dans vos droits. Un Utilisateur saisit et lit son propre temps ; un Administrateur peut verrouiller des semaines et traiter les demandes de déverrouillage. Le serveur MCP n’ajoute aucune porte dérobée autour des rôles de l’application.

En résumé

Le suivi du temps échoue quand il demande aux gens de quitter leur travail pour enregistrer leur travail. Mettre l’outil dans l’assistant déjà présent dans la session supprime le détour, et le faire sur un protocole ouvert signifie que le même serveur fonctionnera dans l’éditeur que l’équipe choisira l’an prochain.

Ouvrez la page du serveur MCP pour la configuration client par client, ou créez un compte gratuit, ajoutez le serveur avec la commande ci-dessus et enregistrez votre première saisie depuis votre prochaine session de code. La page dédiée aux développeurs couvre le reste de la journée : tickets, saisies rétroactives et rapports que votre lead vous demandera.