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

Erstellen oder bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
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" } } } }
Starten Sie Claude Desktop neu.
Ü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

Harvest MCP Server