ハーベストMCPサーバー

このMCP（モデルコンテキストプロトコル）サーバーは、Harvestのタイムトラッキングおよびプロジェクト管理APIとの統合を提供します。これにより、Claudeやその他のMCP対応AIアシスタントがHarvestアカウントと連携し、タイムエントリ、プロジェクト、クライアントなどの管理を支援できるようになります。

特徴

サーバーは次の機能を提供します。

ユーザー

• ユーザーをリストする
• ユーザーの詳細を取得する

時間入力

• フィルタリングオプションを使用して時間エントリを一覧表示する
• 新しい時間エントリを作成する
• タイマーの開始/停止
• クエリ時間エントリの詳細

プロジェクト

• フィルタリングオプションを使用してプロジェクトを一覧表示する
• 詳細なプロジェクト情報を取得する

クライアント

• フィルタリングオプションを使用してクライアントを一覧表示する
• 詳細なクライアント情報を取得する

タスク

• フィルタリングオプションを使用して利用可能なタスクを一覧表示します

セットアップ手順

前提条件

• Python 3.10以上
• APIアクセス可能なHarvestアカウント
• Harvest APIキーとアカウントID

Claude Desktopとの統合

1. Claude Desktop 構成ファイルを作成または編集します。
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Harvest MCP サーバー構成を追加します。
   { "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. Claude Desktop を再起動します。
4. Claude のインターフェースでハンマー アイコンを探して統合を確認します。

クエリの例

接続すると、次のようなクエリを使用して、Claude に Harvest データについて問い合わせることができます。

• 「先週のタイムエントリを表示してください」
• 「アクティブなプロジェクトをすべて一覧表示する」
• 「プロジェクト [project_id] とタスク [task_id] のタイマーを開始します」
• 「アクティブなクライアントをすべて表示」
• 「利用可能なすべてのタスクを一覧表示する」

カスタマイズ

サーバーコードを変更して機能を追加したり、既存のツールをカスタマイズしてワークフローに合わせることができます。サーバーはFastMCPを使用しているため、 @mcp.tool()デコレータを使用して新しい関数を追加するだけで、簡単に新しいツールを追加できます。

トラブルシューティング

• API エラー: Harvest API キーとアカウント ID が正しく、必要な権限があることを確認してください。
• 接続の問題: Claude Desktop 構成にサーバー スクリプトへの正しいパスが設定されていることを確認します。
• 依存関係が不足しています: Python 環境に必要なパッケージがすべてインストールされていることを確認してください。

セキュリティノート

このサーバーが機能するには、Harvest API の認証情報が必要です。以下の点にご注意ください。

• APIキーを安全に保管してください
• claude_desktop_config.jsonファイルを共有しないでください
• この統合には、権限が制限された専用のAPIキーの使用を検討してください