ComposioHQ/FreshBooks-자동화

FreshBooks 자동화

중소기업 회계를 위해 FreshBooks 작업(비즈니스 목록 조회, 프로젝트 관리, 시간 추적, 예산 모니터링)을 자동화합니다.

툴킷 문서: composio.dev/toolkits/freshbooks

---

설정

이 스킬은 https://rube.app/mcp에 연결된 Rube MCP 서버가 필요합니다.

툴을 실행하기 전에 freshbooks 툴킷에 대한 활성 연결이 있는지 확인하세요. 활성 연결이 없으면 RUBE_MANAGE_CONNECTIONS를 통해 새 연결을 시작하세요.

---

핵심 워크플로우

1. 비즈니스 목록 조회

인증된 사용자와 연결된 모든 비즈니스를 검색합니다. 이 응답의 business_id는 대부분의 다른 FreshBooks API 호출에 필요합니다.

툴: FRESHBOOKS_LIST_BUSINESSES

파라미터: 없음.

예시:

Tool: FRESHBOOKS_LIST_BUSINESSES
Arguments: {}

출력: 사용자가 액세스할 수 있는 모든 비즈니스와 각 비즈니스에서의 역할을 포함한 비즈니스 멤버십 정보를 반환합니다.

중요: 프로젝트별 작업을 수행하기 전에 항상 이 툴을 먼저 호출하여 유효한 business_id를 얻으세요.

---

2. 프로젝트 목록 조회 및 필터링

포괄적인 필터링 및 정렬 옵션을 사용하여 비즈니스의 모든 프로젝트를 검색합니다.

툴: FRESHBOOKS_LIST_PROJECTS

주요 파라미터:

• business_id (필수) -- FRESHBOOKS_LIST_BUSINESSES에서 얻은 비즈니스 ID
• active -- 활성 상태로 필터링: true(활성만), false(비활성만), 생략 시 전체
• complete -- 완료 상태로 필터링: true(완료), false(미완료), 생략 시 전체
• sort_by -- 정렬 순서: "created_at", "due_date", 또는 "title"
• updated_since -- RFC3339 형식의 UTC 날짜시간 (예: "2026-01-01T00:00:00Z")
• include_logged_duration -- true로 설정하면 프로젝트당 총 기록 시간(초) 포함
• skip_group -- true로 설정하면 팀 멤버/초대 데이터 생략 (응답 크기 감소)

예시:

Tool: FRESHBOOKS_LIST_PROJECTS
Arguments:
  business_id: 123456
  active: true
  complete: false
  sort_by: "due_date"
  include_logged_duration: true

사용 사례:

• 시간 추적 또는 청구를 위한 모든 프로젝트 가져오기
• 클라이언트, 상태, 날짜 범위별로 프로젝트 찾기
• 프로젝트 완료 및 예산 추적 모니터링
• 팀 할당 및 프로젝트 그룹 검색

---

3. 활성 프로젝트 모니터링

활성 상태이고 미완료된 프로젝트로 필터링하여 프로젝트 진행 상황과 예산을 추적합니다.

단계:

1. FRESHBOOKS_LIST_BUSINESSES를 호출하여 business_id를 얻습니다.
2. FRESHBOOKS_LIST_PROJECTS를 active: true, complete: false, include_logged_duration: true로 호출합니다.
3. 각 프로젝트의 기록 시간과 예산을 분석합니다.

---

4. 최근 업데이트된 프로젝트 검토

updated_since 필터를 사용하여 최근 프로젝트 활동을 확인합니다.

단계:

1. FRESHBOOKS_LIST_BUSINESSES를 호출하여 business_id를 얻습니다.
2. FRESHBOOKS_LIST_PROJECTS를 updated_since에 기준 날짜시간을 설정하여 호출합니다.
3. 반환된 프로젝트에서 최근 변경 사항을 검토합니다.

예시:

Tool: FRESHBOOKS_LIST_PROJECTS
Arguments:
  business_id: 123456
  updated_since: "2026-02-01T00:00:00Z"
  sort_by: "created_at"

---

권장 실행 계획

1. FRESHBOOKS_LIST_BUSINESSES를 호출하여 비즈니스 ID를 얻습니다.
2. 얻은 business_id를 사용하여 FRESHBOOKS_LIST_PROJECTS로 프로젝트를 나열합니다.
3. active, complete, updated_since, sort_by 파라미터를 사용하여 필요에 따라 필터링합니다.

---

알려진 문제점

문제점	세부 사항
business_id 필수	대부분의 FreshBooks 작업에는 business_id가 필요합니다. 항상 먼저 FRESHBOOKS_LIST_BUSINESSES를 호출하여 얻으세요.
날짜 형식	updated_since 파라미터는 RFC3339 형식("2026-01-01T00:00:00Z")이어야 합니다. 다른 형식은 실패합니다.
페이지네이션된 결과	프로젝트 목록 응답은 페이지네이션됩니다. 응답에서 추가 페이지가 있는지 확인하세요.
빈 결과	프로젝트가 없거나 적용된 필터와 일치하는 프로젝트가 없으면 빈 목록을 반환합니다. 오류가 아닙니다.
기록 시간 단위	include_logged_duration이 true인 경우 시간은 초 단위로 반환됩니다. 표시 시 시간으로 변환하려면 3600으로 나누세요.

---

빠른 참조

툴 슬러그	설명
FRESHBOOKS_LIST_BUSINESSES	인증된 사용자의 모든 비즈니스 나열
FRESHBOOKS_LIST_PROJECTS	비즈니스의 프로젝트를 필터링 및 정렬하여 나열

---

Composio 제공