MCP-Server

Mit dem MCP-Server von Timesheet steuern Sie Ihre Zeiterfassung per natürlicher Sprache aus KI-Assistenten und Editoren. Starten und stoppen Sie Timer, verwalten Sie Projekte, fügen Sie Notizen hinzu und erfassen Sie Auslagen, indem Sie in Claude Desktop, Claude Code, Cursor, VS Code und anderen Tools chatten, die das Model Context Protocol unterstützen.

Pro-Plan

Der MCP-Server erfordert einen Pro-Plan oder höher, der API-Zugang enthält. Den vollständigen Vergleich finden Sie auf der Seite Pläne.

Was ist MCP

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem sich KI-Assistenten mit externen Tools verbinden können. Der MCP-Server von Timesheet stellt dem Assistenten Ihr Konto bereit. Wenn Sie also sagen „Starte den Timer für mein Website-Projekt", ruft der Assistent Timesheet auf, startet ihn und bestätigt das Ergebnis.

Bevor Sie beginnen

Ein Timesheet Pro-Plan.
Ein Timesheet API-Schlüssel (siehe unten).
Ein Client, der MCP unterstützt, etwa Claude Desktop, Claude Code, Cursor oder VS Code.
Node.js 18 oder höher, damit der Server über npx laufen kann.

API-Schlüssel erstellen

Öffnen Sie die Web-App und gehen Sie zu Integrationen > API-Schlüssel (siehe API-Schlüssel).
Wählen Sie Neuer API-Schlüssel, vergeben Sie einen Namen und legen Sie fest, wann er abläuft.
Kopieren Sie den Schlüssel und bewahren Sie ihn an einem sicheren Ort auf.

Bewahren Sie Ihren Schlüssel sicher auf

Ihr API-Schlüssel gewährt vollen Zugriff auf Ihr Konto. Geben Sie ihn niemals weiter und checken Sie ihn nicht in die Versionsverwaltung ein. Falls er jemals offengelegt wird, löschen Sie ihn und erstellen Sie einen neuen.

Installation

Fügen Sie den Timesheet-Server zur MCP-Konfiguration Ihres Clients hinzu und verwenden Sie dabei den soeben erstellten API-Schlüssel. Starten Sie den Client neu, nachdem Sie die Datei gespeichert haben.

Claude Desktop

Bearbeiten Sie die Konfigurationsdatei:

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": "your-api-token-here"
      }
    }
  }
}

Starten Sie Claude Desktop neu und fragen Sie dann „Wie ist mein Timer-Status?", um die Verbindung zu bestätigen.

Claude Code

Fügen Sie den Server zu ~/.claude/settings.json hinzu:

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

Die Timesheet-Tools stehen dann in Ihren Claude-Code-Sitzungen zur Verfügung.

Cursor

Gehen Sie zu Cursor Settings > Features > MCP Servers und fügen Sie hinzu:

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

VS Code mit Continue

Installieren Sie die Continue-Erweiterung und fügen Sie dann den Server zu ihrer Konfiguration hinzu:

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

Globale Installation (optional)

Für einen schnelleren Start installieren Sie das Paket einmalig und verweisen Sie den Befehl darauf:

npm install -g @timesheet/mcp

{
  "mcpServers": {
    "timesheet": {
      "command": "timesheet-mcp",
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Beispiel-Prompts

Sobald die Verbindung besteht, sprechen Sie mit Ihrem Assistenten in natürlicher Sprache. Der genaue Wortlaut spielt keine Rolle, der Assistent interpretiert Ihre Absicht.

Timer: „Starte den Timer für das Website-Projekt", „Pausiere meinen Timer, ich mache Mittagspause", „Stoppe den Timer", „Wie ist mein Timer-Status?"
Aufgaben: „Füge eine Notiz hinzu: Login-Fehler behoben", „Füge eine Auslage von 45 $ für das Mittagessen mit dem Kunden hinzu", „Markiere die aktuelle Aufgabe als verrechenbar".
Projekte: „Zeige meine aktiven Projekte", „Erstelle ein Projekt namens Website-Redesign", „Archiviere das alte Website-Projekt".
Verlauf: „Woran habe ich gestern gearbeitet?", „Zeige die Zeiteinträge dieser Woche", „Erfasse 2 Stunden auf dem API-Projekt für Montag".

Verfügbare Tools

Der Server stellt dem Assistenten diese Tools bereit:

Timer

Tool	Beschreibung
`timer_start`	Startet einen Timer für ein Projekt, mit optionaler rückdatierter Startzeit
`timer_stop`	Stoppt den laufenden Timer und schließt die Aufgabe ab
`timer_pause`	Pausiert den Timer für eine Pause
`timer_resume`	Setzt den Timer nach einer Pause fort
`timer_status`	Prüft den aktuellen Timer-Status
`timer_update`	Aktualisiert den laufenden Timer (Beschreibung, Standort, Verrechenbarkeitsstatus, Tags)

Aufgabenerweiterungen

Tool	Beschreibung
`task_add_note`	Fügt der laufenden Aufgabe eine Notiz hinzu
`task_add_expense`	Erfasst eine Auslage für die laufende Aufgabe
`task_add_pause`	Fügt der laufenden Aufgabe eine manuelle Pause hinzu

Projekte

Tool	Beschreibung
`project_list`	Listet Projekte auf, mit optionalen Filtern (Status, Team, Suche)
`project_create`	Erstellt ein Projekt
`project_update`	Aktualisiert ein Projekt oder archiviert es
`project_delete`	Löscht ein Projekt dauerhaft
`project_get`	Ruft die Details eines Projekts ab

Aufgaben

Tool	Beschreibung
`task_list`	Listet Zeiteinträge auf, mit Datums- und Projektfiltern
`task_create`	Erstellt einen manuellen Zeiteintrag für vergangene Arbeit
`task_update`	Ändert die Details, Zeiten oder den Abrechnungsstatus einer Aufgabe
`task_delete`	Löscht einen Zeiteintrag
`task_get`	Ruft die Details einer Aufgabe ab

Teams und Authentifizierung

Tool	Beschreibung
`team_list`	Listet Teams auf, zum Filtern von Projekten
`auth_configure`	Konfiguriert die API-Authentifizierung anstelle der Umgebungsvariable

Fehlerbehebung

Nichts reagiert oder Sie erhalten einen Authentifizierungsfehler. Prüfen Sie, ob TIMESHEET_API_TOKEN korrekt gesetzt ist, ohne zusätzliche Leerzeichen oder Anführungszeichen, und ob der Schlüssel noch unter Integrationen > API-Schlüssel vorhanden ist. Erstellen Sie bei Bedarf einen neuen Schlüssel und starten Sie den Client anschließend neu.

Der Befehl wird nicht gefunden. Vergewissern Sie sich, dass Node.js 18 oder höher installiert ist (node --version). Wenn npx das Paket nicht findet, installieren Sie es global mit npm install -g @timesheet/mcp und verwenden Sie timesheet-mcp als Befehl.

Ein Timer startet nicht. Stellen Sie sicher, dass der Projektname zu einem vorhandenen Projekt passt und dass Sie Zugriff darauf haben. Fragen Sie „Wie ist mein Timer-Status?", um die Verbindung isoliert zu testen.

Sicherheit

Der Server läuft lokal mit Ihrem persönlichen API-Schlüssel und kommuniziert direkt mit der Timesheet-API, sodass die App nicht geöffnet sein muss. Er kann Zeiteinträge lesen und erstellen, Ihre Projekte verwalten und Notizen, Auslagen und Pausen hinzufügen. Er kann nicht auf die privaten Daten anderer Benutzer zugreifen oder Ihre Abrechnung ändern.

Um den Zugriff zu widerrufen, löschen Sie den API-Schlüssel unter Integrationen > API-Schlüssel und entfernen Sie den Server aus der Konfiguration Ihres Clients.

Siehe auch

Integrationen: API-Schlüssel, Webhooks und der Integrations-Marktplatz.
npm: @timesheet/mcp und Issues auf GitHub.
Model Context Protocol: der offene Standard hinter dieser Integration.

Was ist MCP​

Bevor Sie beginnen​

API-Schlüssel erstellen​

Installation​

Claude Desktop​

Claude Code​

Cursor​

VS Code mit Continue​

Globale Installation (optional)​

Beispiel-Prompts​

Verfügbare Tools​

Timer​

Aufgabenerweiterungen​

Projekte​

Aufgaben​

Teams und Authentifizierung​

Fehlerbehebung​

Sicherheit​

Siehe auch​