Cursor- en VS Code-integratie

Urenregistratie loopt spaak zodra je ervoor van venster moet wisselen. Voeg je de Timesheet MCP-server toe aan je editor, dan kan de assistent die je toch al gebruikt de timer starten, vastleggen wat je hebt afgerond en een rapport ophalen, allemaal binnen je editor.

Wat je kunt vragen

• "Start de timer voor het project van deze repository"
• "Stop de timer en noteer dat ik de migratie heb afgerond"
• "Hoeveel tijd heb ik deze week aan dit project besteed?"
• "Registreer 90 minuten op de refactor voor gisterenmiddag"

Voordat je begint

• Een Timesheet Pro-abonnement of hoger. Bekijk de abonnementen en prijzen.
• Een Timesheet API-sleutel uit de webapp, onder Integraties > API-sleutels.
• Node.js 18 of hoger, zodat de server via npx kan draaien.

Cursor

Open Cursor Settings > Features > MCP Servers en voeg toe:

{
  "timesheet": {
    "command": "npx",
    "args": ["@timesheet/mcp"],
    "env": {
      "TIMESHEET_API_TOKEN": "your-api-token-here"
    }
  }
}

VS Code met Continue

Installeer de Continue-extensie en voeg de server toe aan de configuratie:

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

Andere editors

Elke editor of client die het Model Context Protocol ondersteunt, kan dezelfde server draaien. Het commando is npx @timesheet/mcp met TIMESHEET_API_TOKEN in de omgeving. Wil je hem globaal installeren, voer dan npm install -g @timesheet/mcp uit en gebruik timesheet-mcp als commando.

Als er iets misgaat

• Er komt geen reactie, of het inloggen mislukt. Controleer of er geen extra spaties of aanhalingstekens in TIMESHEET_API_TOKEN staan en of de sleutel nog bestaat onder Integraties > API-sleutels.
• Commando niet gevonden. Controleer met node --version of je Node.js 18 of hoger draait. Kan npx het pakket niet vinden, installeer het dan globaal.
• De timer start niet. Kijk of de projectnaam overeenkomt met een bestaand project waar je toegang toe hebt. Vraag "Wat is mijn timerstatus?" om de verbinding los te testen.

Goed om te weten

Je API-sleutel geeft volledige toegang tot je account, dus houd hem buiten alles wat je commit. Wil je de toegang intrekken, verwijder dan de sleutel onder Integraties > API-sleutels en haal de server uit je editorconfiguratie.