fortyTimer MCP 서버 (읽기 전용)

fortyTimer 설치본의 읽기 전용 API를 MCP 클라이언트(Claude Desktop, Claude Code 등)용 도구로 노출하는 경량 MCP 서버입니다. 이 서버에는 자체 비즈니스 로직이 포함되어 있지 않습니다. 인증, 가시성 범위 제한, 데이터 최소화는 전적으로 사용자가 연결하는 fortyTimer 설치본에 의해 적용됩니다.

요구 사항

1. 라이선스 모듈 api_readonly("fortyTimer API") 가 라이선스에 포함된 fortyTimer 설치본.

2. fortyTimer의 프로필 → 보안 → API 토큰에서 생성한 개인 API 토큰. 토큰은 정확히 한 번만 표시됩니다. 토큰은 소유자 계정의 가시성을 상속하며(관리자: 모든 사용자, 관리자: 자신의 승인 그룹, 직원: 본인만), 어떤 것도 수정할 수 없습니다(GET 전용, read 권한).

3. Node.js ≥ 18(Claude Desktop 확장 프로그램으로 설치하면 자동으로 번들됨).

설치(Claude Desktop 확장 프로그램)

패키지된 fortytimer-<version>.mcpb 파일을 더블 클릭하거나 Claude Desktop → 설정 → 확장 프로그램을 통해 설치합니다. 설치 중에 두 가지 값을 입력하라는 메시지가 표시됩니다:

토큰은 일반 텍스트가 아닌 운영 체제 키체인에 저장됩니다.

수동 구성(모든 MCP 클라이언트)

{
    "mcpServers": {
        "fortytimer": {
            "command": "node",
            "args": ["/path/to/fortytimer-mcp/dist/index.js"],
            "env": {
                "FORTYTIMER_URL": "https://42.fortytimer.de",
                "FORTYTIMER_TOKEN": "<token>"
            }
        }
    }
}

소스에서 빌드

npm install
npm run build

Claude Desktop 확장 프로그램으로 패키징:

npm prune --omit=dev
npx @anthropic-ai/mcpb pack . fortytimer-<version>.mcpb
npm install

도구

모든 도구는 읽기 전용(readOnlyHint)입니다. 날짜 범위는 서버 측에서 366일로 제한되며, 목록은 페이지당 50개 항목으로 페이지네이션됩니다(page 매개변수). 기간은 정확한 정수 분과 미리 형식화된 시간:분 문자열로 반환됩니다. 병가 요청의 자유 텍스트 필드는 데이터 보호를 위해 API에서 절대 반환되지 않습니다.

클라이언트 없이 테스트

npx @modelcontextprotocol/inspector node dist/index.js

(Inspector UI의 "환경 변수"에서 FORTYTIMER_URL / FORTYTIMER_TOKEN 환경 변수를 설정하세요.)

개인정보 처리방침

전체 개인정보 처리방침: https://fortytimer.de/privacy-policy.md

요약:

• 이 MCP 서버는 어떤 데이터도 저장하지 않습니다. 데이터베이스, 캐시, 로그 파일 또는 분석 도구를 보유하지 않습니다.

• 모든 데이터는 사용자 자신의 컴퓨터와 사용자가 구성한 fortyTimer 설치본 사이에서만 흐릅니다. 제3자 서비스는 관여하지 않으며 확장 프로그램 작성자에게 데이터가 전송되지 않습니다.

• API 토큰은 사용자가 제공하며, MCP 클라이언트(Claude Desktop은 운영 체제 키체인에 저장)가 보관하고 구성된 fortyTimer URL에 대한 Bearer 헤더로만 사용됩니다.

• 어떤 개인 데이터가 표시되는지는 전적으로 연결된 fortyTimer 설치본이 결정합니다. 토큰은 소유자 계정의 가시성을 상속하며, fortyTimer는 모든 API 응답에서 특수 범주 데이터(병가 요청의 자유 텍스트)를 차단합니다.

• 데이터 보존은 연결된 fortyTimer 설치본에 의해 관리됩니다(해당 운영자가 데이터 컨트롤러입니다). 확장 프로그램은 아무것도 보존하지 않습니다.

• 연락처: info@fortytwo-consulting.de / https://fortytimer.de

보안

• 토큰은 개별 사용자의 로컬 클라이언트 구성에 속합니다. 절대 커밋하거나 공유하지 마세요.

• 토큰 폐기: fortyTimer → 프로필 → 보안 → API 토큰 → 삭제(즉시 적용). 토큰 생성 및 삭제는 fortyTimer 감사 로그에 보안 이벤트로 기록됩니다.

• API 속도 제한: 분당 60회 요청.

라이선스

MIT – LICENSE 참조.