Intégration Claude Desktop

Claude peut contrôler votre suivi du temps via le Model Context Protocol. Une fois connecté, vous décrivez ce que vous avez fait et Claude l’enregistre : pas de formulaires, pas de changement d’application.

Ce que vous pouvez demander

• « Démarre la minuteur pour le projet site web »
• « Mets ma minuteur en pause, je prends mon déjeuner »
• « Ajoute une dépense de 45 $ pour le déjeuner avec le client »
• « Montre-moi les entrées de temps de cette semaine »
• « Combien d’heures ai-je facturées à Acme le mois dernier ? »

Avant de commencer

• Un plan Timesheet Pro ou supérieur. Voir les plans et tarifs.
• Claude Desktop installé, ou un compte sur claude.ai.

Option 1 : le connecteur hébergé

La méthode la plus rapide, sans rien à installer. Ajoutez un connecteur personnalisé dans Claude et pointez-le vers :

https://mcp.timesheet.io

Claude vous redirige vers Timesheet pour vous connecter et approuver l’accès, puis les outils apparaissent dans votre conversation. L’autorisation utilise OAuth, donc aucune clé API n’est stockée dans votre configuration client.

Option 2 : exécuter le serveur localement

Vous préférez garder tout sur votre propre machine ? Créez une clé API dans l’application web sous Intégrations > Clés API, puis modifiez le fichier de configuration de Claude Desktop :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

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

Cela nécessite Node.js 18 ou supérieur, afin que le serveur puisse s’exécuter via npx. Redémarrez Claude Desktop, puis demandez « Quel est le statut de ma minuteur ? » pour confirmer la connexion.

Ce à quoi Claude peut accéder

Le serveur expose 50 outils, regroupés ainsi :

• Minuteur : démarrer, arrêter, mettre en pause, reprendre, statut, mise à jour
• Tâches : créer, mettre à jour, supprimer, lister, plus notes, dépenses et pauses sur la tâche en cours
• Projets : créer, mettre à jour, supprimer, lister, et détails
• Rapports et exportations : documents, rapports de tâches et dépenses, sorties PDF, exportations Excel et CSV, et modèles d’export enregistrés
• Absences : demander, approuver, rejeter, annuler, et lister, ainsi que les types d’absence
• Statistiques : synthèses sur n’importe quelle période

Bon à savoir

• Le serveur peut lire et créer des entrées de temps, gérer les projets, et ajouter notes, dépenses et pauses. Il ne peut pas accéder aux données privées d’autres utilisateurs ni modifier votre facturation.
• Avec l’option locale, votre clé API donne un accès complet à votre compte. Ne la partagez jamais ni ne la commettez dans un contrôle de version.
• Pour révoquer l’accès, supprimez la clé API sous Intégrations > Clés API et retirez le serveur de votre configuration client.