Intégration de Cursor et VS Code

Le suivi du temps échoue lorsqu’il nécessite de changer de fenêtre. Ajouter le serveur Timesheet MCP à votre éditeur permet à l’assistant que vous utilisez déjà de démarrer la minuteur, d’enregistrer ce que vous avez terminé et de générer un rapport, le tout directement dans l’éditeur.

Ce que vous pouvez demander

• « Démarre la minuteur pour le projet de ce dépôt »
• « Arrête la minuteur et note que j’ai terminé la migration »
• « Combien de temps ai-je passé sur ce projet cette semaine ? »
• « Enregistre 90 minutes sur la refonte d’hier après-midi »

Avant de commencer

• Un plan Timesheet Pro ou supérieur. Voir plans et tarifs.
• Une clé API Timesheet depuis l’application web sous Intégrations > Clés API.
• Node.js 18 ou supérieur, pour que le serveur puisse s’exécuter via npx.

Cursor

Ouvrez Paramètres Cursor > Fonctionnalités > Serveurs MCP et ajoutez :

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

VS Code avec Continue

Installez l’extension Continue, puis ajoutez le serveur à sa configuration :

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

Autres éditeurs

Tout éditeur ou client supportant le Model Context Protocol peut exécuter le même serveur. La commande est npx @timesheet/mcp avec TIMESHEET_API_TOKEN dans l’environnement. Pour une installation globale, lancez npm install -g @timesheet/mcp et utilisez timesheet-mcp comme commande.

Résolution des problèmes

• Aucune réponse ou échec d’authentification. Vérifiez que TIMESHEET_API_TOKEN ne contient pas d’espaces ou de guillemets superflus, et que la clé existe toujours sous Intégrations > Clés API.
• Commande introuvable. Confirmez que Node.js 18 ou supérieur est installé avec node --version. Si npx ne trouve pas le paquet, installez-le globalement.
• Une minuteur ne démarre pas. Assurez-vous que le nom du projet correspond à un projet existant auquel vous avez accès. Demandez « Quel est le statut de ma minuteur ? » pour tester la connexion seule.

Bon à savoir

Votre clé API donne un accès complet à votre compte, gardez-la donc hors de tout fichier que vous pourriez committer. Pour révoquer l’accès, supprimez la clé sous Intégrations > Clés API et retirez le serveur de la configuration de votre éditeur.