Claude DesktopでMCPサーバーが表示・接続されないときの確認

Claude DesktopでローカルのMCPサーバーが表示されないときは、設定ファイルを読み込めていない段階と、読み込んだサーバーの起動・接続に失敗した段階を分けます。ツールがまだないことだけで、サーバー本体を再インストールしたり、既存コネクターをまとめて消したりしないようにします。

この記事はClaude Desktopの設定JSONで起動するローカルのMCPサーバーを扱います。リモートのコネクターのOAuthや、ブラウザー版Claudeの設定へそのまま当てはめません。アプリ操作、パッケージ導入、サーバー起動、認証・ファイル権限変更は実施していません。下記は手順の設計で、接続成功の実測ではありません。

どの設定方式とサーバーを見ているか確定する

OS、Claude Desktopのバージョン、サーバー名、ローカル接続かリモート接続か、設定を保存した場所、発生したエラーを控えます。別のアプリのMCP設定や、拡張方式の設定を編集していないか確認します。画面のアイコン名だけを目印にせず、そのバージョンの「Developer」設定とコネクター管理を確認します。

MCPのローカル接続ガイド（新しいタブで開く）は、Claude DesktopのSettingsからDeveloperのEdit Configを開く方法を案内しています。そこで実際に開かれた設定ファイルを優先し、同名のコピーを編集していないかを見ます。macOSとWindowsでは保存パスが違うため、他OSの例をそのまま作りません。

JSONを既存サーバーを残したまま確認する

変更前の設定を安全な場所へ保存し、対象サーバーだけの差分を確認します。mcpServersの中にサーバー定義があるか、command、args、envなど利用サーバーの公式入力と対応しているかを読みます。ネット上の設定例のJSONでファイル全体を置換すると、ほかの接続や設定を失う場合があります。

表は横にスクロールできます

確認	見るもの	よくある取り違え
JSONの構文	引用符・カンマ・括弧	コメントや末尾カンマ
実行ファイル	commandと絶対パス	シェルでだけ使えるエイリアス
引数	argsの一要素ずつ	commandと引数を一文字列化
対象パス	実在とアクセス範囲	他OS・別ユーザーの例
環境条件	必要な変数名と設定元	対話シェルの環境変数の自動継承を期待

JSONを解析できることと、サーバー固有の設定が正しいことは別です。秘密値を検証サイトへ送ったり、env全体を診断用の問い合わせ票へ貼ったりせず、ローカルの構文検査と、必要な項目の有無で確認します。

完全終了して再起動し、読込結果を見る

公式ガイドは、設定保存後にClaude Desktopを完全終了して再起動するよう説明しています。会話画面を閉じただけでプロセスが残る場合を区別し、保存した設定が次の起動へ反映されたかを見ます。未保存の作業がある場合は先に保護します。

再起動後、対象サーバーが一覧にあるか、接続状態、ツール一覧、エラーを分けて記録します。サーバーが登録されているのに接続失敗なら、設定ファイルの場所を変え続けず、起動ログへ進みます。ツール一覧に出た場合も、必要なツールが使えるかは別の確認です。

ログから、読込・起動・プロトコルを分ける

公式ガイドによるログの保存先は、macOSが~/Library/Logs/Claude、Windowsが%APPDATA%\Claude\logsです。mcp.logにはMCP接続全般と接続失敗の情報、mcp-server-SERVERNAME.logには名前に対応するサーバーの標準エラー出力（stderr）が記録されます。対象サーバーと起動時刻を合わせ、最初のエラーを確認します。標準エラー出力には通常の診断情報も入るため、警告一行だけで起動失敗と決めません。プロセスの終了や接続失敗との対応を見ます。

表は横にスクロールできます

ログの観察	次に見る範囲	関係しない変更
設定の構文エラー	対象JSONと読込ファイル	サーバーのAPIキー再発行
実行コマンドが見つからない	実行パス・ランタイム	リモート接続のOAuth設定
モジュールや依存関係がない	対象パッケージとバージョン	ファイル全体の設定置換
起動後に終了	終了結果と標準エラー出力	画面だけ再読込
解析・プロトコルのエラー	標準出力と対応バージョン	全権限を追加

シェルで起動できてもDesktopで失敗する場合は、PATH、作業ディレクトリ、ランタイム、環境変数の参照元を比較します。手動で調べる場合も、公式で出所を確認したサーバーを同じ条件で検証し、見知らぬコマンドへ秘密情報を渡しません。

標準出力（stdout）へ通常のログが混ざる問題は、設定の未読込とは別です。その場合は標準出力と標準エラー出力を分け、メッセージを確認します。ログに記録されたプロトコル版と、クライアント・サーバー双方の対応版を確認します。Claude Desktopの採用版を確認せず、接続失敗を特定の仕様差へ結び付けないようにします。

最小のアクセス範囲で再確認する

ファイルシステム等のサーバーなら、必要な検証用ディレクトリだけを対象にします。接続を直す目的でホームディレクトリ全体や秘密情報保存先を許可する変更にはしません。利用サーバーがどのユーザー権限で動くか、公開するツールが読取だけか書込も含むかを確認します。

許可された検証では、設定読込、プロセス起動、プロトコル接続、ツール一覧、影響の小さい一つの操作を順に確認します。接続成功でも、誤ったディレクトリやアカウントへつながったなら合格にしません。Inspector等の別クライアントを使う場合も、Desktopとの差は起動条件と対応バージョンで比較します。

失敗したら今回のサーバー定義の差分だけを戻し、ほかの接続を保持します。完了記録には、読込ファイル、変更箇所、サーバーとランタイムのバージョン、最初の失敗段階、確認できたツール、未確認の権限範囲を残します。ログを共有する前には、トークン、入力、非公開パスや利用者データを除きます。