Intégration Claude Code

Claude Code est l’agent de codage d’Anthropic pour le terminal. Avec le plugin Timesheet installé, il peut démarrer et arrêter des minuteurs, enregistrer le travail que vous venez de terminer et répondre à vos questions sur la répartition de vos heures, sans que vous ayez à changer de fenêtre.

Ce que vous pouvez demander

• « Démarre le minuteur pour le projet API »
• « Arrête le minuteur et ajoute une note : correction du bug de connexion »
• « Sur quoi ai-je travaillé hier ? »
• « Enregistre 2 heures sur le projet application mobile pour lundi »
• « Exporte le mois dernier en Excel et envoie-le à mon comptable »

Avant de commencer

• Un plan Timesheet Pro ou supérieur. Voir les plans et tarifs.
• Une clé API Timesheet, créée dans l’application web sous Intégrations > Clés API.
• Node.js 18 ou version supérieure.

Installer le plugin

Exécutez ces deux commandes dans une session Claude Code :

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

Le plugin inclut une compétence qui documente chaque groupe de commandes @timesheet/cli, ainsi Claude Code connaît précisément les options et les flux de travail au lieu de deviner.

Ensuite, installez l’interface en ligne de commande pilotée par le plugin et connectez-vous une fois :

npm install -g @timesheet/cli
timesheet auth login

timesheet auth login utilise OAuth 2.1 avec PKCE et ouvre un navigateur. Pour l’automatisation et l’intégration continue, configurez plutôt une clé API :

export TIMESHEET_API_KEY=ts_votre.clefapi
timesheet auth status --json

Ou connectez-vous via MCP

Si vous préférez que Claude Code appelle des outils typés plutôt que d’exécuter des commandes shell, ajoutez le serveur MCP Timesheet dans ~/.claude/settings.json :

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "votre-token-api-ici"
      }
    }
  }
}

Les deux méthodes accèdent au même compte. Le plugin convient aux flux shell et aux sorties scriptées ; le serveur MCP est adapté aux assistants qui préfèrent des appels d’outils structurés.

Utiliser la compétence sans le plugin

L’interface en ligne de commande fournit le même fichier de compétence, donc tout agent compatible peut le charger :

timesheet skill path      # vérifier où il serait écrit
timesheet skill install   # l’écrire dans le répertoire des compétences de l’agent

Bon à savoir

• Chaque commande de lecture accepte --json, pour que la sortie reste analysable par machine. Le passage en pipe vers une autre commande active automatiquement le format TSV.
• Le code de sortie 3 signifie que la session doit se réauthentifier.
• Votre clé API donne un accès complet à votre compte. Ne la commettez jamais dans un système de contrôle de version. Pour révoquer l’accès, supprimez la clé sous Intégrations > Clés API.