本文へスキップ

トラブルシューティング

実際によく起きる問題を、おおむね発生順に解決します。どれでも解決しない場合は AI に診断の実行を依頼してください。問題の報告まで行えます。

AI クライアントにツールが表示されない

  • インストール後にAI アプリを一度再起動します。MCP クライアントは起動時に設定を読み込みます。
  • Cursor／VS Code：ツールは Agent モードでのみ表示されます。Chat と Edit モードでは MCP ツールを公開しません。
  • Mac のメニューバーまたは Windows のシステムトレイに LMCP アイコンがあり、状態表示が緑であることを確認します。

メニューバーまたはシステムトレイのアイコンがない

Mac は「アプリケーション」、Windows は「スタート」メニューから LMCP を開きます。Mac ではトレイが動作しない場合のガイドで LaunchAgent をリセットできます。Windows ではタスクマネージャーから LMCP を終了し、「スタート」から開き直します。

「権限が拒否されました」または結果が空

OS またはアプリの権限が不足しています。権限ガイドを確認してください。Mac の Mail、iMessage、ローカルメッセージキャッシュにはフルディスクアクセス、アプリ操作にはオートメーションが必要な場合があります。Windows では設定 → プライバシーとセキュリティを確認し、対象アプリへのサインインとローカルデータの有無を確認します。

ツールがサービスがオフだと表示する

LMCP が連携する各アプリ（メール、カレンダー、Teams など）は、オフにできるサービスです。サービスがオフなのはユーザーの設定でありエラーではありません。そのツールはデータを読まずに、オフであることを返します。オフにする、または再びオンにするには、Mac ではメニューバーの LMCP アイコン、Windows では設定 → サービスを使います。AI に再びオンにするよう頼むこともできます。Mac では、カレンダー、リマインダー、連絡先に macOS の権限も必要で、LMCP が動いているコンピュータ上で許可します。

ChatGPT／Claude.ai がコンピュータに接続できない

  • メニューバーアプリでWeb アクセス（Your web AI · Cloud Relay）がオンになっているか確認します。インストール後はオンですが、オフにした場合は有効にしてください。
  • Mac または Windows PC が起動しオンラインであることを確認します。リレーは自動的に再接続します。
  • コネクタに認証エラーが表示される、または有効なコンピュータを指していないと表示される場合は、AI のコネクタ設定で接続を解除してから再接続します。AI を接続するを参照してください。

この Mac で Web AI の承認が失敗する、または何度も求められる

Mac で接続を承認しようとすると承認できないと表示される、または AI が何度も接続を求めてきます。再インストール後や、古い LMCP のコピーを削除した後によく起こります。 原因：以前のインストールで残ったキーが Mac のキーチェーンに残り、新しいキーをブロックしています。

  1. メニューバーのアイコンから LMCP を終了します。
  2. ターミナルで security delete-generic-password -s com.local-mcp.tunnel-device-key.v1 を実行するか、キーチェーンアクセスを開いて com.local-mcp.tunnel-device-key.v1 を検索し、その項目を削除します。
  3. アプリケーションから LMCP をもう一度開きます。
  4. お使いの AI（Grok、ChatGPT、Claude.ai、Perplexity）で LMCP コネクタを削除し、もう一度追加して、Mac で承認します。

クラウドアクセス はオンのままにしてください。それでも失敗する場合は、LMCP メニュー → 問題を報告 を使ってください。

ツールが失敗した、または異常な結果を返した

AI に「この問題を報告して」と依頼します。LMCP の組み込み報告ツールが、バージョン、権限状態、最近のエラーを含む診断スナップショットを取得し、一度でチームへ送信します。ケース ID が返されます。

Mac では AI に lmcp_doctor の実行も依頼できます。AI クライアント設定、権限、統合、更新のチェックを先に提示し、明示的に確認した安全な項目だけを修復します。同等の Windows 向けガイド付き修復は開発中です。

ログの場所

Mac：

~/Library/Application Support/Local MCP/server.log

Windows：システムトレイの LMCP → Diagnostics → Open logs を使用します。

解決しない場合

ヘルプセンターを検索するか（質問は改善に役立ちます）、お問い合わせください。