MCPに接続できないときの切り分けツールが表示されない原因も確認

Macで「npxがない」と出たら、起動の二段階を分けます。

npxの場所と、その先で使うNodeの場所は別々に確認します。 npxを絶対パスに直しても、Nodeを探せず止まることがあります。まずエラー文の対象がnpxなのかnodeなのかを読みます。

対象は、Claude Desktopのチャットで既存のローカルstdioサーバーを設定しているMac利用者です。HTTPコネクタ、Claude Codeの設定、Windows・WSLは対象外。この確認のために新しい契約やMCPサーバーを追加する必要はありません。

npmの公式npxスクリプトは、先頭の#!/usr/bin/env nodeでNodeを呼び出します。この形式なら、npxのファイルを指定した後もPATHからNodeを探します。PATHに入れるのは実行ファイル名ではなく、実行ファイルがあるフォルダです。npmのnpx実装

1. アプリのログと、Terminal側の場所を照合する

Finderの「移動」→「フォルダへ移動」で~/Library/Logs/Claude/を開きます。対象サーバーのmcp-server-対象名.logとmcp.logから、直近の起動時刻にある最初のエラーを読んでください。ログ名・場所は公式のローカル接続ガイドで確認できます。

次はMacのターミナルで、下の4行を1行ずつ実行します。コマンドの場所とNodeの版を読むだけで、MCPサーバーは起動しません。全環境変数を表示するenvや、ログ全体の貼り付けは不要です。

command -v npx
command -v node
node --version
node -p 'process.execPath'

最初の2行は、ターミナルがnpx・nodeとして見つける呼び出し先です。中継ファイルを指す場合もあります。一方、最後の行は実際に起動したNode本体の絶対パスを返します。2行目と4行目が違っていても、それだけで異常とは限りません。Node公式のexecPathの説明

例えばNode本体が/opt/homebrew/bin/nodeなら、PATHへ加えるフォルダは/opt/homebrew/binです。MacのPATHでは複数のフォルダを半角コロン:で区切ります。これは一例であり、Intel Macやnvm・fnm・nodenv等では場所が異なります。

何も表示されない、Nodeが起動しない場合は設定例へ進まず、Nodeを入れた方法の案内へ戻ります。必要なNode版は対象サーバーの公式READMEの「Prerequisites」「Requirements」等と照合します。必要版が不明なまま再インストールはしません。

パスにshimsが含まれる場合は、実行先を選ぶ中継ファイルの可能性があります。例えばasdfの公式説明では、この仕組みで使用する版を選びます。nvm・fnm・nodenv等でも、その版管理ツールの起動条件を確認してください。Terminalの成功だけでは、GUIアプリの環境まで正常とは判断できません。

2. 既存の対象サーバーだけを、1項目ずつ直す

Claude Desktopを前面にし、Mac上部の「Claude」メニュー → Settings → Developer → Edit Configを開きます。チャット内のアカウント設定とは別です。対象は~/Library/Application Support/Claude/claude_desktop_config.json。既存サーバーが書かれていない場合は、そのまま新規設定を足さず、編集先を確認します。公式の設定を開く手順

1. 準備
   変更前のコピーを残す

   Finderの「フォルダへ移動」で~/Library/Application Support/Claude/を開き、対象JSONを選んでCommand＋Dで複製します。複製側をclaude_desktop_config.before-edit.json等の別名にして原本と区別します。同名バックアップがあれば別名を使い、上書きしません。Appleの複製ショートカット

2. 編集
   元のJSONをテキストとして開く

   既存のコードエディターを使えます。なければMacの「テキストエディット」→「ファイル」→「開く」で元のJSONを選びます。「フォーマット」に「標準テキストにする」があれば選択。「リッチテキストにする」と出ていれば、すでに標準テキストなので変換せず、そのまま編集します。

JSONは項目名と値を組み合わせて書く形式です。編集する位置は次の階層。実際の対象サーバー名を探し、その内側の値だけを変更します。別サーバー、既存のargs、他のenv項目は残してください。バックアップにも秘密値が入り得るため、共有やアップロードはしません。

envがなければ、対象サーバーのcommandやargsと同じ階層に作り、その内側へPATHを置きます。既存のenvがあればその中へ追加します。JSONの項目間は半角カンマで区切り、最後の項目には付けません。位置に迷う場合は保存せず、変更前のコピーと階層を照合してください。

最初がspawn npx ENOENTなら、まずcommandを調べたnpxの絶対パスへ変えます。再起動してエラーがenv: node…へ変わったら、次はNodeのフォルダをそのサーバーのenv.PATHに含めます。既存のPATHがある場合は、必要な他のフォルダも残します。

下はnpxとNodeの両方が実際に/opt/homebrew/binで見つかった場合だけの編集箇所例です。設定ファイル全体ではありません。既存のargs、他のenv項目、他のサーバーは保持し、JSONの同じキーを重複させず、該当値だけを変更します。

{
  "command": "/opt/homebrew/bin/npx",
  "env": {
    "PATH": "/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
  }
}

argsは、起動するプログラムへ渡す追加指定（引数）の一覧です。例えばパッケージ名やオプションが入ります。commandへ「npxと引数」を一文で書かず、既存のargsを1項目ずつ保持してください。

空白を含むパスもJSONでは1つの文字列にし、その中へターミナル用の引用符を重ねません。ターミナルの~や$PATHの展開を前提にせず、確認した絶対パスを使います。

なお、Claude Codeの.mcp.jsonには環境変数展開の公式仕様があります。「MCPのJSONはすべて展開しない」という意味ではありません。ここで扱うDesktopの設定と混ぜないでください。

変更したらCommand＋Sで保存し、元と同じ場所・claude_desktop_config.jsonという名前を保ちます。.json.txtや.rtfにしません。引用符は半角の"を使い、曲がった引用符へ自動変換された場合は修正します。保存・テキスト形式はAppleの書類ガイド、拡張子と引用符は設定ガイドで確認できます。

3. JSONを確認してから、完全終了・再起動する

次のコマンドは設定の内容を出さず、JSONとして読めるかだけを確認します。JSON syntax OKなら構文の確認は通過です。値や引数が正しいこと、サーバーに接続できることまでは証明しません。NGならファイルの場所、引用符、カンマ、括弧を見直します。

node -e 'try {
  JSON.parse(require("node:fs").readFileSync(process.argv[1], "utf8"));
  console.log("JSON syntax OK");
} catch {
  console.error("JSON syntax NG: ファイルの場所とJSON構文を確認");
  process.exitCode = 1;
}' "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

未保存の作業を確認し、Claude Desktopをメニューの「終了」またはCommand＋Qで完全に終了してから開き直します。ウィンドウを閉じるだけでは残る場合があります。再起動は登録済みサーバーを起動し得るため、信頼済みの構成で行ってください。公式の再起動・ログ確認手順

1. 1
   起動と接続の記録を分ける

   再起動後の時刻で、対象のサーバーログの起動エラーと、mcp.logの接続・切断記録を確認します。確認票に時刻・対象名・実際の表示を残します。エラーが見つからないだけなら成功とはせず、次の一覧確認へ進みます。

2. 2
   対象サーバーの道具を表示する

   チャット入力欄の＋ → Connectors → Manage connectors → 対象サーバーを選びます。提供元が案内するツール名が表示されるかを照合し、確認票へ名前を残します。空・エラーなら一覧・許可の切り分けへ。実際の表示や記録から接続を判定できない場合は、接続欄を未確認にします。

3. 3
   読み取り結果を自分の正解と照合する

   提供元が読み取り専用と説明する操作を、許可済みの対象1件に限定します。チャットのツール実行欄を開き、実際の道具名・入力・戻り値を確認。AIの回答文だけでなく、元の対象と結果が一致するかを見ます。使える道具がなければ実操作は未確認です。

ログだけで起動したかを判断できなければ、起動欄も「未確認」にします。手順3でこのローカルサーバーのツールが実行され、読み取り結果が返ったことを確認できれば、その実行時点での起動も確認できています。起動・接続・一覧だけを見て、実操作まで成功したとは書きません。

例えば、すでにファイル読取ツールがあり、許可済みのmcp-check.txtにMCP_READ_OKと書いてある場合。「このファイルだけを読み、内容をそのまま返してください。作成・編集・削除はしないでください」と依頼します。実行欄が読取で、入力がそのファイル、戻り値が同じ文字列なら、この1件の確認は通過です。

これは条件付きの入力例であり、今回実行したMCP結果ではありません。テストのために別のサーバーを導入したり、共有範囲を広げたりする必要はありません。画面名が異なる場合は公式ガイドへ戻り、送信・購入・削除を接続テストに使いません。

4. 悪化した・原因を絞れない場合は、変更箇所だけを戻す

未保存の作業を確認してClaude Desktopを終了し、変更前の複製と元のJSONをエディターで開きます。複製のmcpServers内から同じ対象名を探し、今回変えたcommandやPATHを変更前の値へ戻します。他のサーバーや、この作業と関係のない変更は戻しません。

今回新しく足したPATHなら、その項目だけを取り除いてカンマ・括弧を整えます。保存後、上の構文確認を再実行し、JSON syntax OKを確認してからアプリを開き直します。再起動後のログ・一覧をもう一度読み、元の症状と未解決の段階を確認票に残してください。元に戻すことと、障害が直ることは別です。

実際に確かめた範囲：無通信の起動教材7ケース

2026年9月11日に作成し、9月14日にAIがmacOS arm64・Node.js v24.16.0で再試験しました。npxと同じ/usr/bin/env node形式の起動役を使っていますが、npx本体・Claude Desktop・MCPサーバーは動かしていません。

残り2ケースは、commandへ余分な引用符を入れるとENOENT、シェルなしの起動でPATHへ変数名を文字のまま入れるとenv: node…で終了127でした。7ケースはこの教材の結果です。製品の全環境への保証や「MCP接続が直った」「時間を削減できた」という実績ではありません。

確認コマンドや教材は外部APIを使いません。実際のサーバーや読み取りツールには別途料金・権限条件があり得ます。修復の所要時間、本人の稼働時間、製品での効果は未測定です。

対象: macOS / Claude Desktop / ローカルstdio
アプリ版・Node版:
対象サーバー・既存command:
最初のエラー: 秘密値と個人名入りパスは伏せる
Terminalでのnpxの場所:
TerminalでのNode実体の場所:
変更した1項目:
再起動後: 起動 / MCP接続 / 対象ツール一覧 / 読取結果
証拠: 確認時刻・実表示 / 対象ツール名 / 実行の入力と結果
復元: 戻した値 / JSON構文 / 再起動後の結果
未確認の段階:
次に確認する場所:

2026年9月14日に、Nodeの実体パス、asdfの中継ファイル、Appleのテキスト形式、MCPの設定・ログ・再起動の公式資料を再確認しました。このMac補足内の他の資料は9月13日確認。部分編集・復元・確認票は編集上の手順案で、Desktopの設定変更・接続試験、人間の本文レビューは未実施です。

起動できた後にJSONの解析エラーが出るなら、次のstdoutの節へ進みます。ここからはファイルの場所ではなく、通信へ普通のログが混ざっていないかを調べます。