Harvest MCP Server

Сервер Harvest MCP

Этот сервер MCP (Model Context Protocol) обеспечивает интеграцию с API отслеживания времени и управления проектами Harvest. Он позволяет Claude и другим совместимым с MCP помощникам AI взаимодействовать с вашей учетной записью Harvest, помогая вам управлять записями времени, проектами, клиентами и многим другим.

Функции

Сервер предоставляет следующие функции:

Пользователи

• Список пользователей
• Получить данные пользователя

Время записи

• Список записей времени с возможностью фильтрации
• Создать новые записи времени
• Таймеры запуска/остановки
• Запрос времени ввода данных

Проекты

• Список проектов с возможностью фильтрации
• Получить подробную информацию о проекте

Клиенты

• Список клиентов с возможностью фильтрации
• Получить подробную информацию о клиенте

Задачи

• Список доступных задач с возможностью фильтрации

Инструкции по установке

Предпосылки

• Python 3.10 или выше
• Учетная запись Harvest с доступом по API
• Ключ API Harvest и идентификатор учетной записи

Интеграция с 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. Проверьте интеграцию, найдя значок молотка в интерфейсе Клода.

Примеры запросов

После подключения вы можете задать Клоду вопросы о ваших данных Harvest, используя такие запросы:

• «Покажи мне мои временные записи за прошлую неделю»
• «Список всех моих активных проектов»
• «Запустить таймер для проекта [project_id] и задачи [task_id]»
• «Показать мне всех активных клиентов»
• «Список всех доступных задач»

Настройка

Вы можете изменить код сервера, чтобы добавить больше функциональности или настроить существующие инструменты для лучшего соответствия вашему рабочему процессу. Сервер использует FastMCP, что позволяет легко добавлять новые инструменты, просто добавляя новые функции с помощью декоратора @mcp.tool() .

Поиск неисправностей

• Ошибки API : убедитесь, что ваш ключ API Harvest и идентификатор учетной записи верны и имеют необходимые разрешения.
• Проблемы с подключением : убедитесь, что в конфигурации Claude Desktop указан правильный путь к скрипту сервера.
• Отсутствующие зависимости : убедитесь, что вы установили все необходимые пакеты в своей среде Python.

Заметки о безопасности

Для работы этого сервера требуются ваши учетные данные API Harvest. Убедитесь, что:

• Сохраните свой ключ API в безопасности
• Не делитесь файлом claude_desktop_config.json
• Рассмотрите возможность использования выделенного ключа API с ограниченными правами для этой интеграции.