하베스트 MCP 서버

이 MCP(Model Context Protocol) 서버는 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 서버 구성을 추가합니다.지엑스피1
3. Claude Desktop을 다시 시작합니다.
4. 클로드 인터페이스에서 망치 아이콘을 찾아 통합을 확인하세요.

예제 쿼리

연결되면 다음과 같은 쿼리를 사용하여 Claude에게 Harvest 데이터에 대해 질문할 수 있습니다.

• "지난주 내 시간 항목을 보여주세요"
• "내 모든 활성 프로젝트 나열"
• "프로젝트 [project_id]와 작업 [task_id]에 대한 타이머를 시작합니다."
• "모든 활성 클라이언트 표시"
• "사용 가능한 모든 작업 나열"

사용자 정의

서버 코드를 수정하여 기능을 추가하거나 기존 도구를 워크플로에 더 잘 맞도록 사용자 지정할 수 있습니다. 이 서버는 FastMCP를 사용하므로 @mcp.tool() 데코레이터를 사용하여 새 함수를 추가하는 것만으로 새 도구를 쉽게 추가할 수 있습니다.

문제 해결

• API 오류 : Harvest API 키와 계정 ID가 올바르고 필요한 권한이 있는지 확인하세요.
• 연결 문제 : Claude Desktop 구성에 서버 스크립트에 대한 올바른 경로가 있는지 확인하세요.
• 종속성 누락 : Python 환경에 필요한 모든 패키지를 설치했는지 확인하세요.

보안 참고 사항

이 서버가 작동하려면 Harvest API 자격 증명이 필요합니다. 다음 사항을 확인하세요.

• API 키를 안전하게 보관하세요
• claude_desktop_config.json 파일을 공유하지 마세요
• 이 통합에 대해 제한된 권한이 있는 전용 API 키를 사용하는 것을 고려하세요.