トラブルシューティング

Chimrで問題が発生した場合、このガイドが一般的な問題の解決に役立ちます。

前提条件

具体的な問題のトラブルシューティングを行う前に、次の基本要件を確認してください。

システム要件
- macOS 14.0 (Sonoma) 以降
必要な権限
- カレンダーアクセス - システム設定 → プライバシーとセキュリティ → カレンダー → Chimr ✓
- 通知 - システム設定 → 通知 → Chimr → 通知を許可 ✓
カレンダーアプリの設定
- カレンダー.appを開く → 表示メニュー
- 「終日イベントを表示」を有効化 ✓
- 「参加を辞退したイベントを表示」を有効化 ✓

Chimrにカレンダーが表示されない場合は、次を確認してください。

イベントが更新されない場合は、次を確認してください。

カレンダーの同期を確認
- カレンダー.appを開く
- プルして更新またはCmd+R
- まずそこにイベントが表示されることを確認
アカウント設定
- カレンダー.app → 設定 → アカウント
- アカウントが正しく設定されていることを確認
- 「このアカウントを有効にする」がオンになっていることを確認
再起動が必要
- Chimrは現在、新しいカレンダーを追加した後に再起動が必要です
- アプリを終了して再起動してください

通知を受け取れない場合は、次を確認してください。

通知が予期しない時間に表示される場合は、次を確認してください。

タイムゾーンの問題
- システムのタイムゾーンが正しいことを確認
- カレンダー.appのイベントタイムゾーンを確認
- イベントに適切なタイムゾーン情報があることを確認
終日イベント
- 設定 → 通知
- 「終日イベントを通知」設定を確認
- 通知タイミングを確認（終日イベントはその日の開始時刻を基準に適用）

MCP統合で問題がある場合は、次を確認してください。

Background Serviceを有効化 - Chimr → 設定 → Advanced（詳細）を開き、**「Enable Background Service」**をオンにします。--mcpコマンドは軽量なフォワーダーにすぎず、実際にカレンダーを読み取るのはBackground Serviceデーモンです。オフの場合、リクエストは「Chimr’s Background Service isn’t running」で失敗します。デーモンが承認待ちの場合は、システム設定 → 一般 → ログイン項目と機能拡張でChimrを許可してください。
設定を確認 - Claude DesktopまたはClaude Codeの設定でパス/Applications/Chimr.app/Contents/MacOS/Chimrが正しいか確認
argsを確認 - args配列に["--mcp"]が設定されているか確認
Claudeを再起動 - 設定変更後にClaude DesktopまたはClaude Codeを再起動
カレンダー権限 - システム設定 → プライバシーとセキュリティ → カレンダーでChimrにカレンダー権限があるか確認
ログを確認 - Claude Desktopのログで具体的なエラーメッセージを確認

詳細なMCPセットアップ手順については、MCP統合ガイドを参照してください。

Chimrがリソースを多く消費している場合は、次をお試しください。

これは、Chimrがカレンダーにアクセスする権限を持っていないことを意味します。上記の前提条件セクションを参照してカレンダーアクセスを許可してください。

これは通常、同期の問題を示しています。

Chimrは通知を表示する権限が必要です。上記の前提条件セクションを参照して通知アクセスを許可してください。

高度なトラブルシューティングでは、Chimrのシステムログを確認できます。

問題が続く場合は、次を実行してください。