トラブルシューティング
実際によく起きる問題を、おおむね発生順に解決します。どれでも解決しない場合は AI に診断の実行を依頼してください。問題の報告まで行えます。
AI クライアントにツールが表示されない
- インストール後にAI アプリを一度再起動します。MCP クライアントは起動時に設定を読み込みます。
- Cursor/VS Code:ツールは Agent モードでのみ表示されます。Chat と Edit モードでは MCP ツールを公開しません。
- Mac のメニューバーまたは Windows のシステムトレイに LMCP アイコンがあり、状態表示が緑であることを確認します。
メニューバーまたはシステムトレイのアイコンがない
Mac は「アプリケーション」、Windows は「スタート」メニューから Local MCP を開きます。Mac ではトレイが動作しない場合のガイドで LaunchAgent をリセットできます。Windows ではタスクマネージャーから LMCP を終了し、「スタート」から開き直します。
「権限が拒否されました」または結果が空
OS またはアプリの権限が不足しています。権限ガイドを確認してください。Mac の Mail、iMessage、ローカルメッセージキャッシュにはフルディスクアクセス、アプリ操作にはオートメーションが必要な場合があります。Windows では設定 → プライバシーとセキュリティを確認し、対象アプリへのサインインとローカルデータの有無を確認します。
ChatGPT/Claude.ai がコンピュータに接続できない
- メニューバーアプリでWeb アクセス(Your web AI · Cloud Relay)を有効にします。初期状態では無効です。
- Mac または Windows PC が起動しオンラインであることを確認します。リレーは自動的に再接続します。
- 認証エラーの場合はメニューバーから接続 URL/トークンを再コピーします。AI を接続するを参照してください。
ツールが失敗した、または異常な結果を返した
AI に「この問題を報告して」と依頼します。LMCP の組み込み報告ツールが、バージョン、権限状態、最近のエラーを含む診断スナップショットを取得し、一度でチームへ送信します。ケース ID が返されます。
Mac では AI に lmcp_doctor の実行も依頼できます。AI クライアント設定、権限、統合、更新のチェックを先に提示し、明示的に確認した安全な項目だけを修復します。同等の Windows 向けガイド付き修復は開発中です。
ログの場所
Mac:
~/Library/Application Support/Local MCP/server.logWindows:システムトレイの LMCP → Diagnostics → Open logs を使用します。
解決しない場合
ヘルプセンターを検索するか(質問は改善に役立ちます)、お問い合わせください。