JSON構文とルートキー
不正なJSON、ルート値として使われた配列、mcpServersまたはserversオブジェクトの欠落、クライアント固有のルートキー不一致を検出します。
Claude Desktop · Cursor · VS Code
Claude Desktop、Cursor、VS CodeのMCP設定を貼り付けるだけで、JSON構文、クライアント固有のルートキー、サーバーのcommandやURL、transport、引数、環境変数を確認できます。具体的なエラーと整形済みJSONを確認し、修正レポートをダウンロード可能。設定ファイルが端末外へ送信されることはありません。
無料・アカウントやメール登録不要・現在の設定を使用(未入力の場合はすぐ使えるサンプルを使用)
ブラウザで使えるJSONチェッカー
編集中のファイルに対応するクライアントを選び、JSONオブジェクト全体を貼り付けてチェックしてください。すぐ直すべきエラーと警告を分けて表示するため、修正の優先順位が分かります。
無料・登録不要・診断結果、修正済みJSON、ファイルパス、再起動チェックリストを収録
すぐ修正できるエラーを検出
JSONとして正しくても、MCP設定として正しいとは限りません。文書構造に加え、クライアントの接続を妨げやすいサーバー設定も確認します。
不正なJSON、ルート値として使われた配列、mcpServersまたはserversオブジェクトの欠落、クライアント固有のルートキー不一致を検出します。
ローカルstdioサーバーのcommand、引数配列、環境変数の値の型を確認し、commandとURLがどちらもない設定を検出します。
HTTP・HTTPSエンドポイント、対応するtransport値、接続方式の競合、headerの型、安全に共有できない可能性がある認証情報を確認します。
検証後は、以下のファイル場所、正常に動作する構造、診断表を活用してください。プレースホルダーのパスやURLは、対象サーバーの公式インストール手順に記載された値へ置き換えます。
クライアント固有のファイルを開いてバックアップを作成し、サーバー項目だけでなくJSONオブジェクト全体を検証してください。
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.cursor/mcp.json
.vscode/mcp.json
stdio項目はローカルの実行ファイルを起動します。各引数はJSON配列の個別要素として記述してください。
{
"mcpServers": {
"my-local-server": {
"command": "npx",
"args": [
"-y",
"your-mcp-package"
],
"env": {
"API_KEY": "replace-me"
}
}
}
}
リモート項目はローカルプロセスを起動せず、URLへ接続します。ローカル以外のエンドポイントにはHTTPSを使用してください。
{
"mcpServers": {
"my-remote-server": {
"type": "http",
"url": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer replace-me"
}
}
}
}
有効なJSONは最初の確認項目にすぎません。サーバーパッケージの不具合と判断する前に、以下の動作確認を完了してください。
表示された症状と、考えられる原因を確認または除外できる最初のチェック項目を照らし合わせてください。
| 症状 | 考えられる原因 | 確認すること |
|---|---|---|
| Unexpected token | JSON構文が不正 | 報告された位置の周辺に、末尾のカンマ、引用符の欠落、エスケープされていないバックスラッシュ、対応しない波括弧がないか確認します。 |
| サーバーが表示されない | ルートキーまたはファイルが誤っている | 選択したクライアント、正確な設定ファイルの場所、ルートオブジェクトがmcpServersかserversかを確認します。 |
| spawn ENOENT | commandが見つからない | ターミナルでcommandを実行し、クライアントのPATHを確認するか、実行ファイルの絶対パスを使用します。 |
| サーバーがすぐ終了する | argsが不正、またはenvが不足 | argsが文字列の配列になっているか、必要な環境変数が設定されているか確認します。 |
| HTTP 401 / 403 | リモート認証に失敗 | 認証方式とトークンの取得元を確認します。公開されてしまった認証情報は更新してください。 |
| 接続タイムアウト | URLまたはtransportが誤っている | エンドポイント、HTTPS証明書、サーバーの稼働状況、クライアントがHTTPと従来型SSEのどちらを想定しているか確認します。 |
3ステップの確認手順
構文、スキーマ、実行時の順に確認します。この順序なら、クライアントがファイルを解析できない段階で、実行ファイルの不足に気を取られることを防げます。
Claude Desktop、Cursor、VS Code、汎用のいずれかを選択すると、想定されるルートキーと関連するファイルパスが適用されます。
ファイル全体を貼り付けます。最初に処理を妨げるエラーを修正し、続いてcommand、url、args、env、シークレットに関する警告を確認してください。
修正レポートをダウンロードし、整形済みJSONとバックアップを比較します。必要な変更を保存し、クライアントを完全に再起動してからログを確認してください。
MCP設定のよくある質問
開発者がよく直面する設定、transport、プライバシー、トラブルシューティングの疑問に簡潔に答えます。
macOSでは通常、~/Library/Application Support/Claude/claude_desktop_config.jsonにあります。Windowsでは通常、%APPDATA%\Claude\claude_desktop_config.jsonです。ファイルを置き換える前にClaude Desktopを完全に終了し、バックアップを保存してから、アプリを再起動してください。
mcpServersは、サーバー名をキーとするトップレベルのJSONオブジェクトです。各値には、通常、ローカルのcommandとargs、またはリモートのurlを使った接続方法を記述します。VS Codeの設定では、代わりにトップレベルのserversオブジェクトを使用する場合があります。
JSONが有効であることは、文書を解析できることだけを示します。ルートキーが誤っている、サーバー値がオブジェクトではない、commandとurlがどちらもない、argsやenvなどのフィールドが誤ったデータ型になっている場合、クライアントは設定を拒否または無視することがあります。
stdioはローカルプロセスを起動し、標準入力と標準出力を通じてメッセージをやり取りします。HTTPはリモートMCPエンドポイントへ接続します。SSEは、一部の既存サーバーで現在も使われている従来型のリモート接続方式です。サーバーの資料に記載され、使用中のクライアントバージョンが対応しているtransportを選んでください。
spawn ENOENTは通常、設定された実行ファイルが見つからないことを示します。ターミナルでcommandを実行し、インストールされていることを確認してください。ターミナルのPATHとデスクトップアプリの環境を比較し、必要に応じて実行ファイルの絶対パスを使います。command名が誤ってargs内に記述されていないかも確認してください。
このページはブラウザ内で検証を行い、貼り付けたテキストをアップロードしません。また、認証情報と思われる値について警告します。それでも、実際のシークレットを含むスクリーンショットやダウンロード済みレポートは共有せず、漏えいした可能性がある認証情報は更新してください。
必要ありません。レポートボタンを押すと、選択したクライアント、現在の診断結果、整形済みJSON、再起動チェックリストを含むMarkdownファイルがブラウザ内ですぐ生成されます。設定を入力していない場合は、利用可能なサンプル設定がレポートに含まれます。
いいえ。合格結果は、このページに記載されたチェックに合格したことを示すものであり、実行ファイル、パッケージ、ネットワークエンドポイント、認証情報、ファイルシステム権限、クライアント固有機能の利用可否を保証するものではありません。設定を修正した後は、クライアントを再起動して実行時ログを確認してください。
選択したクライアント、ファイルパス、検証スコア、優先順位付きの診断結果、整形済みJSON、6ステップの再起動チェックリストを含むMarkdownレポートを生成します。
無料・登録不要・現在の診断結果から端末内で生成