Cursor- und VS-Code-Integration

Zeiterfassung scheitert, wenn sie einen Fensterwechsel bedeutet. Mit dem Timesheet MCP-Server im Editor startet der Assistent, den Sie ohnehin nutzen, den Timer, protokolliert Erledigtes und ruft Berichte ab, alles im Editor.

Was Sie fragen können

• „Starte den Timer für das Projekt dieses Repositories“
• „Stoppe den Timer und notiere, dass die Migration fertig ist“
• „Wie lange habe ich diese Woche an diesem Projekt gearbeitet?“
• „Buche 90 Minuten auf das Refactoring für gestern Nachmittag“

Voraussetzungen

• Ein Timesheet Pro-Tarif oder höher. Siehe Tarife und Preise.
• Ein Timesheet API-Schlüssel aus der Web-App unter Integrationen > API-Schlüssel.
• Node.js 18 oder höher, damit der Server über npx starten kann.

Cursor

Öffnen Sie Cursor Settings > Features > MCP Servers und ergänzen Sie:

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

VS Code mit Continue

Installieren Sie die Continue-Erweiterung und tragen Sie den Server in deren Konfiguration ein:

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

Andere Editoren

Jeder Editor und jeder Client mit Unterstützung für das Model Context Protocol kann denselben Server starten. Der Befehl lautet npx @timesheet/mcp mit TIMESHEET_API_TOKEN in der Umgebung. Für eine globale Installation führen Sie npm install -g @timesheet/mcp aus und verwenden timesheet-mcp als Befehl.

Fehlersuche

• Keine Reaktion oder Authentifizierungsfehler. Prüfen Sie, ob TIMESHEET_API_TOKEN ohne zusätzliche Leerzeichen oder Anführungszeichen gesetzt ist und ob der Schlüssel unter Integrationen > API-Schlüssel noch existiert.
• Befehl nicht gefunden. Prüfen Sie mit node --version, ob Node.js 18 oder höher installiert ist. Findet npx das Paket nicht, installieren Sie es global.
• Der Timer startet nicht. Achten Sie darauf, dass der Projektname zu einem vorhandenen Projekt passt, auf das Sie Zugriff haben. Fragen Sie „Wie ist mein Timer-Status?“, um die Verbindung separat zu testen.

Gut zu wissen

Ihr API-Schlüssel gewährt vollen Zugriff auf Ihr Konto. Halten Sie ihn daher aus allem heraus, was Sie einchecken. Zum Entziehen löschen Sie den Schlüssel unter Integrationen > API-Schlüssel und entfernen den Server aus Ihrer Editor-Konfiguration.