Harvest MCP-Server

Dieser MCP-Server (Model Context Protocol) ermöglicht die Integration mit der Harvest-API für Zeiterfassung und Projektmanagement. Er ermöglicht Claude und anderen MCP-kompatiblen KI-Assistenten die Interaktion mit Ihrem Harvest-Konto und unterstützt Sie bei der Verwaltung von Zeiteinträgen, Projekten, Kunden und mehr.

Merkmale

Der Server bietet die folgenden Funktionen:

Benutzer

• Benutzer auflisten

• Abrufen von Benutzerdetails

Zeiteinträge

• Zeiteinträge mit Filteroptionen auflisten

• Neue Zeiteinträge erstellen

• Timer starten/stoppen

• Zeiteintragsdetails abfragen

Projekte

• Projekte mit Filteroptionen auflisten

• Detaillierte Projektinformationen abrufen

Kunden

• Clients mit Filteroptionen auflisten

• Abrufen detaillierter Kundeninformationen

Aufgaben

• Verfügbare Aufgaben mit Filteroptionen auflisten

Installationsanweisungen

Voraussetzungen

• Python 3.10 oder höher

• Harvest-Konto mit API-Zugriff

• Harvest-API-Schlüssel und Konto-ID

Integration mit Claude Desktop

1. Erstellen oder bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie die Harvest MCP-Serverkonfiguration hinzu:

   { "mcpServers": { "harvest": { "command": "uv", "args": [ "run", "--directory", "change_directory", "harvest-mcp-server.py" ], "env": { "HARVEST_ACCOUNT_ID": "account_id", "HARVEST_API_KEY": "api_key" } } } }

3. Starten Sie Claude Desktop neu.

4. Überprüfen Sie die Integration, indem Sie in Claudes Benutzeroberfläche nach dem Hammersymbol suchen.

Beispielabfragen

Sobald die Verbindung hergestellt ist, können Sie Claude mit Abfragen wie diesen zu Ihren Harvest-Daten befragen:

• „Zeig mir meine Zeiteinträge der letzten Woche“

• „Alle meine aktiven Projekte auflisten“

• „Starte einen Timer für Projekt [project_id] und Aufgabe [task_id]“

• „Zeige mir alle aktiven Kunden“

• "Alle verfügbaren Aufgaben auflisten"

Anpassung

Sie können den Servercode ändern, um weitere Funktionen hinzuzufügen oder die vorhandenen Tools an Ihren Workflow anzupassen. Der Server verwendet FastMCP, wodurch das Hinzufügen neuer Tools durch einfaches Hinzufügen neuer Funktionen mit dem Dekorator @mcp.tool() vereinfacht wird.

Fehlerbehebung

• API-Fehler : Stellen Sie sicher, dass Ihr Harvest-API-Schlüssel und Ihre Konto-ID korrekt sind und über die erforderlichen Berechtigungen verfügen.

• Verbindungsprobleme : Überprüfen Sie, ob Ihre Claude Desktop-Konfiguration den richtigen Pfad zum Serverskript hat.

• Fehlende Abhängigkeiten : Stellen Sie sicher, dass Sie alle erforderlichen Pakete in Ihrer Python-Umgebung installiert haben.

Sicherheitshinweise

Dieser Server benötigt Ihre Harvest-API-Anmeldeinformationen, um zu funktionieren. Stellen Sie Folgendes sicher:

• Bewahren Sie Ihren API-Schlüssel sicher auf

• Geben Sie Ihre Datei claude_desktop_config.json nicht weiter

• Erwägen Sie die Verwendung eines dedizierten API-Schlüssels mit eingeschränkten Berechtigungen für diese Integration