Harvest 자동화은(는) 무엇을 하나요?
Claude Code에서 직접 Harvest 시간 추적 작업을 자동화하세요. 시간 항목 기록, 프로젝트 및 클라이언트 관리, 작업 생성, 보고 데이터 가져오기까지 터미널을 벗어나지 않고 모두 수행할 수 있습니다.
툴킷 문서: composio.dev/toolkits/harvest
설정
- Rube MCP 서버를 Claude Code 설정에 URL
https://rube.app/mcp로 추가합니다. - 메시지가 표시되면 제공된 연결 링크를 통해 Harvest 계정을 인증합니다.
- 자연어를 사용하여 시간 추적 워크플로를 자동화합니다.
핵심 워크플로
1. 시간 항목 기록 및 관리
정확한 청구 및 보고를 위해 시간 항목을 생성, 나열, 업데이트 및 검색합니다.
도구: HARVEST_CREATE_TIME_ENTRY, HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY, HARVEST_UPDATE_TIME_ENTRY
오늘 프로젝트 12345, 작업 67890에 개발 작업 3.5시간 기록
HARVEST_CREATE_TIME_ENTRY의 주요 매개변수:
project_id(필수) -- 기록할 프로젝트task_id(필수) -- 작업이 프로젝트에 할당되어야 함spent_date(필수) -- YYYY-MM-DD 형식의 날짜hours-- 총 시간 (기간 기반 계정의 경우)started_time/ended_time-- 타임스탬프 기반 계정의 경우notes-- 수행한 작업에 대한 설명
HARVEST_LIST_TIME_ENTRIES의 주요 매개변수:
from_date/to-- 날짜 범위 필터 (YYYY-MM-DD)project_id,client_id,task_id,user_id-- 엔티티 필터is_billed/is_running-- 상태 필터page/per_page(최대 2000) -- 페이지 매김
2. 프로젝트 관리
새 프로젝트를 생성하고 클라이언트 및 청구 구성으로 기존 프로젝트를 나열합니다.
도구: HARVEST_CREATE_PROJECT, HARVEST_LIST_PROJECTS, HARVEST_GET_PROJECT
클라이언트 456에 대해 "웹사이트 리디자인"이라는 청구 가능 프로젝트를 Tasks 청구 및 프로젝트 예산으로 생성
HARVEST_CREATE_PROJECT의 주요 매개변수:
name,client_id,is_billable,bill_by,budget_by(모두 필수)bill_by옵션:"Project","Tasks","People","none"budget_by옵션:"project","project_cost","task","task_fees","person","none"- 선택 사항:
budget,hourly_rate,starts_on,ends_on,is_fixed_fee
3. 클라이언트 관리
프로젝트가 구성되는 클라이언트를 생성하고 나열합니다.
도구: HARVEST_CREATE_CLIENT, HARVEST_LIST_CLIENTS
Harvest 계정의 모든 활성 클라이언트 나열
HARVEST_CREATE_CLIENT는name이 필수이며,address,currency,is_active를 허용합니다.HARVEST_LIST_CLIENTS는is_active필터 및 페이지 매김(per_page최대 2000)을 지원합니다.
4. 작업 관리
시간 추적을 위한 재사용 가능한 작업 유형을 생성하고 나열합니다.
도구: HARVEST_CREATE_TASK, HARVEST_LIST_TASKS
"코드 리뷰"라는 새로운 청구 가능 작업을 기본 요금 $150/시간으로 생성
HARVEST_CREATE_TASK는name이 필수이며,billable_by_default,default_hourly_rate,is_active,is_default를 허용합니다.HARVEST_LIST_TASKS는is_active,is_default필터 및 페이지 매김(per_page최대 100)을 지원합니다.- 작업 이름은 모든 작업(활성 및 보관됨)에서 고유해야 합니다.
5. 시간 항목 보고
청구 요약 및 활용 보고서를 위해 날짜 범위와 필터를 사용하여 시간 항목을 가져옵니다.
도구: HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY
2026년 1월 프로젝트 789의 모든 미청구 시간 항목 표시
- 날짜 창을 위해
from_date및to사용 - 미청구 항목 필터링을 위해
is_billed: false사용 - 다차원 보고를 위해
project_id,user_id,client_id결합 - 완전한 데이터 세트를 수집하려면
page및per_page로 페이지 매김
6. 시간 항목 업데이트 및 수정
기존 시간 항목을 수정하여 시간을 수정하거나, 프로젝트를 재할당하거나, 메모를 업데이트합니다.
도구: HARVEST_UPDATE_TIME_ENTRY
시간 항목 123456을 업데이트하여 시간을 4.0으로 변경하고 "API 통합 완료" 메모 추가
time_entry_id필요- 부분 업데이트 지원 -- 변경하려는 필드만 포함
hours,notes,project_id,task_id,spent_date,started_time,ended_time업데이트 가능
알려진 문제점
- 작업 할당 중요: 시간 항목을 생성할 때
task_id는 지정된project_id에 실제로 할당된 작업에 해당해야 합니다. 프로젝트 작업 할당 엔드포인트를 사용하여 확인하십시오.HARVEST_LIST_TASKS(전역 작업 반환)만 사용하지 마십시오. - 기간 vs. 타임스탬프 추적: Harvest 계정은 기간 기반 또는 타임스탬프 기반 추적 중 하나로 구성됩니다. 타임스탬프 계정에서는
hours가 무시되고, 기간 계정에서는started_time/ended_time이 무시됩니다. - 페이지 매김 제한 다양함:
HARVEST_LIST_TIME_ENTRIES및HARVEST_LIST_CLIENTS는 페이지당 최대 2000개를 지원하지만,HARVEST_LIST_PROJECTS및HARVEST_LIST_TASKS는 페이지당 100개로 제한됩니다. - 날짜 형식 일관성: 모든 날짜 매개변수는
YYYY-MM-DD형식을 사용해야 합니다.updated_since필터에는 시간대가 포함된 ISO 8601이 사용됩니다. - 프로젝트 필수 필드:
HARVEST_CREATE_PROJECT는name,client_id,is_billable,bill_by,budget_by의 다섯 가지 필드가 필요합니다. 누락 시 유효성 검사 오류가 발생합니다.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
HARVEST_LIST_TIME_ENTRIES | 날짜, 프로젝트, 클라이언트, 사용자 필터로 시간 항목 나열 |
HARVEST_CREATE_TIME_ENTRY | 새 시간 항목 기록 (project_id, task_id, spent_date 필요) |
HARVEST_GET_TIME_ENTRY | ID로 특정 시간 항목 검색 |
HARVEST_UPDATE_TIME_ENTRY | 기존 시간 항목 업데이트 (time_entry_id 필요) |
HARVEST_LIST_PROJECTS | 선택적 클라이언트 필터로 프로젝트 나열 |
HARVEST_CREATE_PROJECT | 청구 구성으로 새 프로젝트 생성 |
HARVEST_GET_PROJECT | ID로 특정 프로젝트 검색 |
HARVEST_LIST_CLIENTS | 활성/비활성 필터로 클라이언트 나열 |
HARVEST_CREATE_CLIENT | 새 클라이언트 생성 (name 필요) |
HARVEST_LIST_TASKS | 재사용 가능한 작업 유형 나열 |
HARVEST_CREATE_TASK | 새 작업 유형 생성 (name 필요) |
Composio 제공