Skip to main content
Glama
deenesjakoruzh
ficus33

TrackingTime MCP Server

by ficus33
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

TrackingTime MCP 서버

Claude와 같은 AI 어시스턴트를 TrackingTime API v4에 연결하는 MCP (Model Context Protocol) 서버입니다. 자연어를 통해 프로젝트, 작업, 시간 추적, 직원 할당 및 고객을 관리하세요.

빠른 시작

1. TrackingTime 자격 증명 가져오기

  • 앱 비밀번호(App Password): TrackingTime → 관리(Manage) → 사용자 설정(User Settings) → 앱 및 통합(Apps & Integrations) → 새 앱 비밀번호 생성

  • 계정 ID(Account ID): 로그인 시 TrackingTime URL에서 확인하거나 계정 설정에서 확인 가능

2. AI 어시스턴트에 추가

Claude Code:

claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "trackingtime": {
      "command": "npx",
      "args": ["trackingtime-mcp"],
      "env": {
        "TT_APP_PASSWORD": "your-app-password",
        "TT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

추가 후 어시스턴트를 다시 시작하세요.

대안: 소스에서 설치

로컬에서 복제하고 빌드하려는 경우:

git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env   # then edit .env with your credentials

그런 다음 어시스턴트가 로컬 빌드를 가리키도록 설정하세요:

claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.js

Related MCP server: Clockify MCP Server

도구

프로젝트

도구

설명

tt_list_projects

프로젝트 목록 (필터: ACTIVE/ARCHIVED/ALL/FOLLOWING)

tt_list_project_ids

프로젝트 ID만 나열 (가벼움, 배치 작업용)

tt_search_projects

키워드로 프로젝트 및 작업 검색

tt_create_project

새 프로젝트 생성

tt_update_project

프로젝트 이름, 고객 또는 서비스 편집

tt_update_project_preferences

즐겨찾기, 기본 보기, 닫힌 작업 표시 설정

tt_get_project

세부 정보 플래그와 함께 단일 프로젝트 가져오기

tt_get_project_times

여러 프로젝트의 누적 시간 가져오기

tt_get_project_users

프로젝트에 할당된 직원 확인

tt_archive_project

프로젝트 보관 (되돌리기 가능)

tt_reopen_project

보관된 프로젝트 다시 열기

tt_delete_project

프로젝트 영구 삭제

tt_merge_projects

한 프로젝트를 다른 프로젝트로 병합

작업

도구

설명

tt_list_tasks

작업 목록 (필터: ACTIVE/ARCHIVED/ALL/TRACKING)

tt_create_task

담당자, 마감일, 예상 시간을 포함한 작업 생성

tt_update_task

작업 편집 또는 직원 재할당

tt_get_task

단일 작업 세부 정보 가져오기

tt_get_task_times

여러 작업의 누적 시간 가져오기

tt_search_tasks

프로젝트 내에서 이름으로 작업 검색

tt_sort_tasks

정렬 인덱스별로 작업 재정렬

tt_import_tasks

미리보기 모드로 작업 대량 가져오기

tt_close_task

작업을 완료로 표시

tt_reopen_task

완료된 작업 다시 열기

tt_delete_task

작업 삭제

시간 추적

도구

설명

tt_start_timer

작업에 타이머 시작

tt_stop_timer

실행 중인 타이머 중지

시간 기록

도구

설명

tt_list_time_entries

사용자/프로젝트/고객/작업 + 날짜 범위별 기록 나열

tt_list_time_entries_min

더 가벼운 최소 목록 (청구 필터, 휴가)

tt_count_time_entries

필터에 대한 기록의 빠른 개수 확인

tt_add_time_entry

수동 시간 기록 추가 (초 단위 지속 시간)

tt_get_time_entry

단일 시간 기록 가져오기

tt_update_time_entry

시간 기록 편집

tt_delete_time_entry

시간 기록 삭제

tt_get_events_summary

사용자별 일일 시간 요약

tt_export_time_entries

CSV로 내보내기

tt_mark_billed

기록을 청구됨으로 표시

tt_mark_not_billed

청구됨 표시 해제

이벤트 태그

도구

설명

tt_list_tags

모든 태그 정의 나열

tt_get_tag

단일 태그 가져오기

tt_list_tag_values

태그 이름에 사용된 값 나열

tt_create_tag

태그 정의 생성

tt_update_tag

태그 업데이트

tt_delete_tag

태그 정의 삭제

tt_save_event_tag

시간 기록에 태그 부착/업데이트

tt_delete_event_tag

시간 기록에서 태그 제거

사용자 및 직원

도구

설명

tt_list_users

모든 직원 나열 (사용자 ID 찾기)

tt_get_user

단일 사용자 세부 정보 가져오기

tt_create_user

사용자 생성 (제거된 tt_invite_users 대체)

tt_update_user

사용자 프로필 업데이트

tt_update_user_permissions

세부 편집/보기 권한 설정

tt_update_employee

HR 필드 업데이트 (직함, 부서, 날짜 등)

tt_resend_invite

보류 중인 사용자에게 활성화 이메일 재전송

tt_reset_icalendar_token

사용자의 iCal 내보내기 토큰 순환

tt_get_user_tasks

프로젝트별로 그룹화된 사용자 작업 나열

tt_get_user_tracking

사용자가 현재 추적 중인 항목 확인

tt_get_user_trackables

사용자에게 할당된 모든 프로젝트 및 작업

tt_get_user_projects

사용자에게 할당된 프로젝트 나열

tt_assign_user_projects

프로젝트에 직원 할당

tt_remove_user_projects

프로젝트에서 직원 제거

tt_archive_user

사용자 비활성화 (관리자 전용)

tt_reactivate_user

보관된 사용자 다시 활성화

사용자 그룹

도구

설명

tt_list_user_groups

그룹 나열 (필터: ACTIVE/ARCHIVED/ALL)

tt_get_user_group

단일 그룹 가져오기

tt_create_user_group

그룹 생성 (관리자 + 멤버 필수)

tt_update_user_group

그룹 업데이트 (status: "ARCHIVED"를 통해 보관)

tt_delete_user_group

그룹 영구 삭제

고객

도구

설명

tt_list_customers

고객 나열 (필터: ACTIVE/ARCHIVED/ALL)

tt_get_customer

단일 고객 세부 정보 가져오기

tt_create_customer

새 고객 생성

tt_update_customer

고객 세부 정보 편집

tt_delete_customer

고객 영구 삭제

tt_archive_customer

고객 보관 (되돌리기 가능)

tt_reactivate_customer

보관된 고객 다시 활성화

서비스

도구

설명

tt_list_services

서비스 나열 (작업 카테고리)

tt_get_service

서비스 가져오기

tt_create_service

새 서비스 생성

tt_update_service

서비스 업데이트

tt_archive_service

서비스 보관 (되돌리기 가능)

tt_reactivate_service

보관된 서비스 다시 활성화

tt_delete_service

서비스 영구 삭제

팀 (워크스페이스)

도구

설명

tt_list_teams

사용자가 속한 모든 워크스페이스 나열

tt_switch_team

세션의 활성 워크스페이스 전환

tt_update_team_permissions

기본 멤버 권한 업데이트

보고서

도구

설명

tt_get_user_report

차트 및 분석이 포함된 사용자별 분석 보고서

알림

도구

설명

tt_list_notifications

알림 나열 (USER 또는 PROJECT 범위)

tt_mark_notification_read

알림 하나를 읽음으로 표시

tt_mark_notifications_read

여러 알림을 읽음으로 표시

웹훅

도구

설명

tt_list_webhooks

구성된 웹훅 나열

tt_get_webhook

웹훅 가져오기

tt_enable_webhook

웹훅 활성화

tt_disable_webhook

웹훅 비활성화

tt_reset_webhook_token

웹훅의 서명 토큰 순환

tt_delete_webhook

웹훅 삭제

도구 수 줄이기

93개의 모든 도구가 기본적으로 활성화되어 있습니다. AI 어시스턴트에 너무 많은 컨텍스트를 제공한다고 판단되면, 저장소를 복제하고 src/tools.ts에서 필요 없는 도구를 /* */로 주석 처리한 다음 npm run build를 실행하여 더 가벼운 빌드를 생성할 수 있습니다.

테스트

MCP Inspector를 사용하여 도구를 대화형으로 테스트하세요:

npx @modelcontextprotocol/inspector npx trackingtime-mcp

API 참고 사항

TrackingTime API의 몇 가지 특징:

  • duration 및 accumulated_time은 초 단위입니다.

  • estimated_time 및 worked_hours는 시간 단위입니다.

  • 시간 기록은 API에서 "events"라고 부릅니다.

  • 타이머가 실행 중일 때 타이머를 시작하면 오류 502가 반환됩니다. stop_running_task=true를 사용하여 현재 타이머를 자동으로 중지하세요.

  • 날짜는 YYYY-MM-DD, 날짜-시간은 yyyy-MM-dd HH:mm:ss 형식을 사용합니다.

인증

이 서버는 TrackingTime의 앱 비밀번호 인증을 사용합니다. 실제 비밀번호는 절대 저장되지 않습니다. 앱 비밀번호는 SSL을 통해 HTTP Basic 인증(API_TOKEN:<app_password>)으로 전송됩니다.

앱 비밀번호가 유출된 경우, TrackingTime에서 취소하고 새 비밀번호를 생성하세요. 계정 비밀번호를 변경할 필요는 없습니다.

라이선스

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers