Tool overview
MCPサーバーバリデーターとは？
MCPサーバーバリデーターは、mcpServers JSONクライアント設定を検証ための開発者向けツールです。
なぜMCPサーバーバリデーターを使うのか？
mcpServers JSONクライアント設定を検証際の可読性と作業速度を向上させ、データをサーバーに送信しません。
主な機能
クライアントサイドのプライバシー、即座の結果、ワンクリックコピー。mcpServers JSONクライアント設定を検証
使い方
上のツールで正確な結果を得るための手順です。
- トップレベルの mcpServers オブジェクトを含む Cursor または Claude Desktop の JSON 設定を貼り付けます。
- リント報告でエラー（ブロック）と警告（非ブロック）を JSON ポインタパス付きで確認します。
- トランスポートを修正: stdio は command（+ args）、リモートは有効な http/https url が必要です。
- env は文字列のみ、args は文字列配列のみであることを確認します。
- 可能なら command+url の二重定義と警告の未知キーを削除します。
- ok が true になるまで再検証 — 警告だけでは失敗しませんが本番負債として扱います。
- 修正した JSON をクライアント設定に戻し、MCP サーバーを再読み込みします。
- チーム向けテンプレートでは報告を PR / CI チェックリストへ。シークレットはプレースホルダーのまま。
MCP バリデーター — 完全ガイドとユースケース
権威ある解説：エラーと警告、stdio と HTTP、Cursor / Claude Desktop、env 文字列規則、修正ガイド、シークレット衛生。
MCP Validator ガイド — ここから始める
このガイドでは、mcpServers JSON 設定をローカルで検証する方法を説明します。シークレットを除いた内容を貼り付け、Cursor または Claude Desktop の前に問題を修正してください。
MCP Validator の役割
MCP Validator はブラウザ内で mcpServers のエントリ、トランスポート、JSON 型を検査し、クライアントが起動できない設定を検出します。
JSON パスと修正可能な問題を含むローカルレポート
- JSON パスと修正可能な問題を含むローカルレポート
- JSON パスと修正可能な問題を含むローカルレポート: mcpServers, command, args, url, env
- JSON パスと修正可能な問題を含むローカルレポート: stdio, http, https
- JSON パスと修正可能な問題を含むローカルレポート: JSON, ok
MCP 設定を貼り付けたり共有したりする前に使用
- MCP 設定を貼り付けたり共有したりする前に使用
- MCP 設定を貼り付けたり共有したりする前に使用: Cursor mcp.json
- MCP 設定を貼り付けたり共有したりする前に使用: Claude Desktop
- MCP 設定を貼り付けたり共有したりする前に使用: CI / PR
スキーマやプロンプトの作成には関連ツールを使用
- スキーマやプロンプトの作成には関連ツールを使用
- スキーマやプロンプトの作成には関連ツールを使用: AI Agent Builder
- スキーマやプロンプトの作成には関連ツールを使用: JSON Schema
エラーと警告 — 貼り付けを妨げるもの
エラー: 設定が検証を妨げています
重要度ガイド
| 重要度ガイド | ok への影響 | 主な原因 |
|---|---|---|
| エラー: 設定が検証を妨げています | ok への影響: ok = false | 主な原因 |
| 警告: 本番前にこの詳細を確認してください | ok への影響: ok | 主な原因 |
警告: 本番前にこの詳細を確認してください
手順: 貼り付け、lint、修正、戻す
このツールによる解決方法
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
- サーバーごとに一つのトランスポートを選びます。
- リモートサーバーには http:// または https:// を使用します。
- env 値を文字列にします。
- ok が true になるまで再検証します。
- 修正した JSON をクライアントに戻します。
ユースケース: 再読み込み前に Cursor mcp.json を修正
エラー: 設定が検証を妨げています Cursor mcp.json.
このツールによる解決方法
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
- サーバーごとに一つのトランスポートを選びます。
結果: 明確で検証済みの、すぐ使える MCP 設定。
ユースケース: Claude Desktop のリモート MCP URL
エラー: 設定が検証を妨げています Claude Desktop.
このツールによる解決方法
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
- サーバーごとに一つのトランスポートを選びます。
結果: 明確で検証済みの、すぐ使える MCP 設定。
ユースケース: PR レビューで MCP テンプレートを lint
エラー: 設定が検証を妨げています CI / PR.
このツールによる解決方法
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
- サーバーごとに一つのトランスポートを選びます。
結果: 明確で検証済みの、すぐ使える MCP 設定。
ユースケース: デバッグ時のシークレット衛生
エラー: 設定が検証を妨げています env.
このツールによる解決方法
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
- サーバーごとに一つのトランスポートを選びます。
結果: 明確で検証済みの、すぐ使える MCP 設定。
stdio と HTTP/HTTPS のトランスポート規則
トランスポート形式
トランスポート形式
| トランスポート形式 | 必須フィールド | 注記 |
|---|---|---|
| stdio | command; args | 注記 |
| HTTP / HTTPS | url (http:// or https://) | 注記 |
注記: env, headers, disabled.
env の値は文字列でなければならない
env: 必須フィールド
- env: 必須フィールド
- 必須フィールド
- JSON
- mcpServers
修正: command または url がない
エラー: 設定が検証を妨げています: command or url.
原因
原因
診断
診断
修正
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
修正: 文字列以外の env 値
エラー: 設定が検証を妨げています: env.
原因
原因
診断
診断
修正
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
警告: 本番前にこの詳細を確認してください
修正: ルートエンベロープが誤っている
エラー: 設定が検証を妨げています: mcpServers.
原因
原因
診断
診断
修正
- mcpServers を含む JSON を貼り付けます。
- 最初にエラーを修正します。
- command、args、url、env を確認します。
MCP 検証のベストプラクティス
- Cursor または Claude Desktop に貼る前に検証します。
- command か url のどちらか一方だけを使います。
- args は文字列配列に保ちます。
- env 値は文字列に保ちます。
- シークレットにはプレースホルダーを使います。
- 最小権限の絶対パスを使います。
- 変更のたびに再検証します。
- 本番前に警告を確認します。
よくある質問
一般的なトラブルとデータプライバシーに関する回答です。
関連ツール
このツールを補完する関連ユーティリティをご覧ください。
公式ドキュメントと参照
このユーティリティの公式仕様とプラットフォーム文書です。