ヘルプ：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

ターミナルでこれらを実行します。2つ目でサインイン用に 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分に1回記録し、「Claude Code · my-app」のような名前の提案ブロックにします。ほかの提案と同じように確定してください。

https://nodejs.org から LTS インストーラーをダウンロードして開きます。Homebrew を使っているなら、代わりにこれを実行できます：

brew install node

確認するには、ターミナルでこれを実行します。v18 以降と表示されれば OK です。

node -v

Cmd+Space を押し、ターミナルと入力して Return を押します。

npx hourcrumb login
npx hourcrumb setup claude
npx hourcrumb setup codex

1つ目でブラウザに 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分に1回。プロンプト、コード、ファイル名、返答はあなたのパソコンから出ません。詳しくはプライバシーポリシーをご覧ください。