Claude Desktop · Cursor · VS Code

壊れたJSONとサーバー接続を見つける MCP設定バリデーター

Claude Desktop、Cursor、VS CodeのMCP設定を貼り付けるだけで、JSON構文、クライアント固有のルートキー、サーバーのcommandやURL、transport、引数、環境変数を確認できます。具体的なエラーと整形済みJSONを確認し、修正レポートをダウンロード可能。設定ファイルが端末外へ送信されることはありません。

今すぐMCP設定をチェック

無料・アカウントやメール登録不要・現在の設定を使用(未入力の場合はすぐ使えるサンプルを使用)

JSON構文の診断 mcpServersの確認 シークレット露出の警告
Claude Desktop向けMCP JSON設定の診断画面
端末内で検証 設定はこのブラウザ内に留まります
項目ごとの修正案 JSON · command · URL · args · env

ブラウザで使えるJSONチェッカー

Claude DesktopやCursorのMCP設定を検証

編集中のファイルに対応するクライアントを選び、JSONオブジェクト全体を貼り付けてチェックしてください。すぐ直すべきエラーと警告を分けて表示するため、修正の優先順位が分かります。

入力

MCP JSONを貼り付け

端末内のみ

選択したクライアントに応じて、想定されるルートキーとファイルの場所を切り替えます。

macOSの一般的なファイル: ~/Library/Application Support/Claude/claude_desktop_config.json

ダウンロードするレポートに含めたくない認証情報は貼り付けないでください。

このページ内のJavaScriptだけで検証します。ファイルのアップロードやネットワーク通信は行いません。

100 スコア
診断結果

MCP設定レポート

使用できます
サーバー 1
チェック数 8
エラー 0
警告 0

チェックで見つかった項目

警告より先にエラーを修正してください
    整形済みJSON
    
                

    無料・登録不要・診断結果、修正済みJSON、ファイルパス、再起動チェックリストを収録

    すぐ修正できるエラーを検出

    実際の設定ミスに対応したMCP JSONチェッカー

    JSONとして正しくても、MCP設定として正しいとは限りません。文書構造に加え、クライアントの接続を妨げやすいサーバー設定も確認します。

    JSON構文とルートキー

    不正なJSON、ルート値として使われた配列、mcpServersまたはserversオブジェクトの欠落、クライアント固有のルートキー不一致を検出します。

    command、args、env

    ローカルstdioサーバーのcommand、引数配列、環境変数の値の型を確認し、commandとURLがどちらもない設定を検出します。

    URL、transport、シークレット

    HTTP・HTTPSエンドポイント、対応するtransport値、接続方式の競合、headerの型、安全に共有できない可能性がある認証情報を確認します。

    0 主要な検証カテゴリ
    0 選択できるクライアント設定
    0 必要な設定ファイルのアップロード数

    MCP設定の修正ガイドとコピー用テンプレート

    検証後は、以下のファイル場所、正常に動作する構造、診断表を活用してください。プレースホルダーのパスやURLは、対象サーバーの公式インストール手順に記載された値へ置き換えます。

    Claude DesktopとCursorの設定ファイルの場所

    クライアント固有のファイルを開いてバックアップを作成し、サーバー項目だけでなくJSONオブジェクト全体を検証してください。

    • Claude macOS ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Windows %APPDATA%\Claude\claude_desktop_config.json
    • Cursor ~/.cursor/mcp.json
    • VS Code .vscode/mcp.json

    ローカルstdio MCPサーバーのテンプレート

    stdio項目はローカルの実行ファイルを起動します。各引数はJSON配列の個別要素として記述してください。

    claude_desktop_config.json
    {
      "mcpServers": {
        "my-local-server": {
          "command": "npx",
          "args": [
            "-y",
            "your-mcp-package"
          ],
          "env": {
            "API_KEY": "replace-me"
          }
        }
      }
    }

    リモートHTTP MCPサーバーのテンプレート

    リモート項目はローカルプロセスを起動せず、URLへ接続します。ローカル以外のエンドポイントにはHTTPSを使用してください。

    リモートサーバー設定
    {
      "mcpServers": {
        "my-remote-server": {
          "type": "http",
          "url": "https://example.com/mcp",
          "headers": {
            "Authorization": "Bearer replace-me"
          }
        }
      }
    }

    安全な再起動チェックリスト

    有効なJSONは最初の確認項目にすぎません。サーバーパッケージの不具合と判断する前に、以下の動作確認を完了してください。

    1. 以前動作していた設定をバックアップします。
    2. ターミナルでバージョンまたはヘルプコマンドを実行し、commandが存在することを確認します。
    3. サーバー側で必要な場合は、相対ファイルパスを絶対パスへ置き換えます。
    4. 修正済みJSONをUTF-8で保存します。
    5. MCPクライアントを完全に終了してから再起動します。
    6. クライアントのMCPログまたは開発者ログで、最初に出ている具体的なエラーを確認します。

    Claude DesktopのMCP接続エラー対応表

    表示された症状と、考えられる原因を確認または除外できる最初のチェック項目を照らし合わせてください。

    症状 考えられる原因 確認すること
    Unexpected token JSON構文が不正 報告された位置の周辺に、末尾のカンマ、引用符の欠落、エスケープされていないバックスラッシュ、対応しない波括弧がないか確認します。
    サーバーが表示されない ルートキーまたはファイルが誤っている 選択したクライアント、正確な設定ファイルの場所、ルートオブジェクトがmcpServersserversかを確認します。
    spawn ENOENT commandが見つからない ターミナルでcommandを実行し、クライアントのPATHを確認するか、実行ファイルの絶対パスを使用します。
    サーバーがすぐ終了する argsが不正、またはenvが不足 argsが文字列の配列になっているか、必要な環境変数が設定されているか確認します。
    HTTP 401 / 403 リモート認証に失敗 認証方式とトークンの取得元を確認します。公開されてしまった認証情報は更新してください。
    接続タイムアウト URLまたはtransportが誤っている エンドポイント、HTTPS証明書、サーバーの稼働状況、クライアントがHTTPと従来型SSEのどちらを想定しているか確認します。

    3ステップの確認手順

    MCP設定を確認して修正する方法

    構文、スキーマ、実行時の順に確認します。この順序なら、クライアントがファイルを解析できない段階で、実行ファイルの不足に気を取られることを防げます。

    01

    MCPクライアントを選択

    Claude Desktop、Cursor、VS Code、汎用のいずれかを選択すると、想定されるルートキーと関連するファイルパスが適用されます。

    02

    JSONを貼り付けて検証

    ファイル全体を貼り付けます。最初に処理を妨げるエラーを修正し、続いてcommandurlargsenv、シークレットに関する警告を確認してください。

    03

    ダウンロード、保存、再起動

    修正レポートをダウンロードし、整形済みJSONとバックアップを比較します。必要な変更を保存し、クライアントを完全に再起動してからログを確認してください。

    MCP設定のよくある質問

    MCP JSONに関するよくある質問

    開発者がよく直面する設定、transport、プライバシー、トラブルシューティングの疑問に簡潔に答えます。

    Claude DesktopのMCP設定ファイルはどこにありますか?

    macOSでは通常、~/Library/Application Support/Claude/claude_desktop_config.jsonにあります。Windowsでは通常、%APPDATA%\Claude\claude_desktop_config.jsonです。ファイルを置き換える前にClaude Desktopを完全に終了し、バックアップを保存してから、アプリを再起動してください。

    ClaudeやCursorの設定にあるmcpServersとは何ですか?

    mcpServersは、サーバー名をキーとするトップレベルのJSONオブジェクトです。各値には、通常、ローカルのcommandargs、またはリモートのurlを使った接続方法を記述します。VS Codeの設定では、代わりにトップレベルのserversオブジェクトを使用する場合があります。

    有効なJSONなのにMCP設定として拒否されるのはなぜですか?

    JSONが有効であることは、文書を解析できることだけを示します。ルートキーが誤っている、サーバー値がオブジェクトではない、commandurlがどちらもない、argsenvなどのフィールドが誤ったデータ型になっている場合、クライアントは設定を拒否または無視することがあります。

    stdio、HTTP、SSEにはどのような違いがありますか?

    stdioはローカルプロセスを起動し、標準入力と標準出力を通じてメッセージをやり取りします。HTTPはリモートMCPエンドポイントへ接続します。SSEは、一部の既存サーバーで現在も使われている従来型のリモート接続方式です。サーバーの資料に記載され、使用中のクライアントバージョンが対応しているtransportを選んでください。

    Claude Desktopの「spawn ENOENT」はどう直せますか?

    spawn ENOENTは通常、設定された実行ファイルが見つからないことを示します。ターミナルでcommandを実行し、インストールされていることを確認してください。ターミナルのPATHとデスクトップアプリの環境を比較し、必要に応じて実行ファイルの絶対パスを使います。command名が誤ってargs内に記述されていないかも確認してください。

    APIキーを含む設定を貼り付けても安全ですか?

    このページはブラウザ内で検証を行い、貼り付けたテキストをアップロードしません。また、認証情報と思われる値について警告します。それでも、実際のシークレットを含むスクリーンショットやダウンロード済みレポートは共有せず、漏えいした可能性がある認証情報は更新してください。

    MCP修正レポートのダウンロードにアカウントは必要ですか?

    必要ありません。レポートボタンを押すと、選択したクライアント、現在の診断結果、整形済みJSON、再起動チェックリストを含むMarkdownファイルがブラウザ内ですぐ生成されます。設定を入力していない場合は、利用可能なサンプル設定がレポートに含まれます。

    合格結果ならMCPサーバーが必ず起動しますか?

    いいえ。合格結果は、このページに記載されたチェックに合格したことを示すものであり、実行ファイル、パッケージ、ネットワークエンドポイント、認証情報、ファイルシステム権限、クライアント固有機能の利用可否を保証するものではありません。設定を修正した後は、クライアントを再起動して実行時ログを確認してください。

    MCPのトラブルシューティングに診断結果を持ち出せます

    選択したクライアント、ファイルパス、検証スコア、優先順位付きの診断結果、整形済みJSON、6ステップの再起動チェックリストを含むMarkdownレポートを生成します。

    無料・登録不要・現在の診断結果から端末内で生成