도움말: AI 앱과 코딩 시간

Hourcrumb을 AI 앱에 연결하면 평소 말투로 시간을 물어보거나 기록할 수 있고, 코딩 도구에서 보낸 시간이 알아서 추천 블록이 돼요. 둘 다 Hourcrumb Plus와 Hourcrumb 계정이 필요해요.

내 컴퓨터

AI 앱에 시간 물어보기

Hourcrumb을 앱에 한 번만 추가하세요. 앱이 처음 Hourcrumb을 사용할 때 브라우저에서 Hourcrumb이 열려요. 로그인하고 허용을 선택하세요. 복사할 키는 없어요.

컴퓨터의 Claude 앱이나 claude.ai에서: 설정 → 커넥터 → 사용자 지정 커넥터 추가. 이름을 Hourcrumb으로 하고 이 주소를 붙여 넣은 뒤 연결을 선택하세요. 그러면 휴대폰의 Claude 앱에서도 작동해요.

https://api.hourcrumb.com/mcp

터미널의 Claude Code 전용이에요(claude 명령이 필요해요). 이걸 실행한 다음 Claude Code에서 /mcp를 입력하고 hourcrumb을 선택해 로그인하세요.

claude mcp add --transport http hourcrumb https://api.hourcrumb.com/mcp

터미널에서 이것들을 실행하세요. 두 번째 명령이 로그인을 위해 Hourcrumb을 열어요.

codex mcp add hourcrumb --url https://api.hourcrumb.com/mcp
codex mcp login hourcrumb

Cursor가 있는 컴퓨터에서 버튼을 사용하거나, Cursor 설정 → MCP에 이 주소를 추가하세요. Cursor가 요청하면 로그인하세요.

https://api.hourcrumb.com/mcp

Agent 패널에서 … → MCP Servers → Manage MCP Servers → View raw config를 열고 이 줄들을 추가한 뒤 저장하세요. 요청하면 로그인하세요.

{
  "mcpServers": {
    "hourcrumb": {
      "serverUrl": "https://api.hourcrumb.com/mcp"
    }
  }
}

그다음 이렇게 물어보세요: "이번 주에 프로젝트별로 얼마나 일했어?" 또는 "오늘 아침 글쓰기 2시간 기록해 줘."

AI 코딩 도구로 작업하는 동안 Hourcrumb이 지금 있는 폴더를 최대 1분에 한 번 기록하고, "Claude Code · my-app" 같은 이름의 추천 블록으로 만들어요. 다른 추천처럼 확인하면 돼요.

https://nodejs.org에서 LTS 설치 프로그램을 내려받아 여세요. Homebrew를 쓴다면 대신 이걸 실행해도 돼요:

brew install node

확인하려면 터미널에서 이걸 실행하세요. v18 이상이 표시되어야 해요.

node -v

Cmd+Space를 누르고 터미널을 입력한 뒤 Return을 누르세요.

npx hourcrumb login
npx hourcrumb setup claude
npx hourcrumb setup codex

첫 번째는 브라우저에서 Hourcrumb을 열어요. 로그인하고 허용을 선택하세요. 나머지는 Hourcrumb을 Claude Code와 Codex에 추가하고, 바꾸는 파일마다 백업을 남겨요. 쓰지 않는 도구의 줄은 건너뛰세요.

Claude Code나 Codex를 종료하고 다시 여세요. 다음 세션부터 기록이 시작돼요. Claude 데스크톱 앱에서는 새 Code 세션을 여세요.

확장 프로그램을 열고 Hourcrumb을 검색해 설치를 선택하세요. 그런 다음 명령 팔레트(Cmd+Shift+P)를 열고 "Hourcrumb: Sign in"을 실행한 뒤 브라우저에서 허용을 선택하세요. 기록하는 동안 상태 표시줄에 Hourcrumb이 보여요.

1분 정도 작업한 다음 Hourcrumb에서 오늘을 여세요. 다음 동기화 후 도구와 폴더 이름이 붙은 추천 블록이 나타나요. 터미널 도구가 로그인되고 설정되었는지 보려면 다음을 실행하세요:

npx hourcrumb status

설정 → AI 앱에서 앱 연결을 끊었거나 90일 동안 쓰지 않았다면 다시 로그인하세요: npx hourcrumb login(에디터에서는 "Hourcrumb: Sign in"). 훅은 설정 후에 연 세션에서만 실행돼요.

npx가 ENOENT나 EPERM 같은 npm 오류로 멈추면 npm 캐시가 손상된 거예요. 이걸 실행한 다음 다시 해 보세요.

npm cache verify

이걸 실행하고 설정 → AI 앱에서 앱 연결을 끊으세요. 설정 과정에서 바꾼 파일마다 바로 옆에 사본(.hourcrumb-backup으로 끝남)을 남겨 두었으니, 예전 파일이 필요하면 쓰세요.

npx hourcrumb logout

도구 이름과 폴더 이름(경로는 아님)만, 최대 1분에 한 번. 프롬프트, 코드, 파일 이름, 답변은 내 컴퓨터에 그대로 있어요. 자세한 내용은 개인정보 처리방침에서 확인하세요.