~/tools / MCP Config Checker
MCP Config Checker — MCP 設定ファイルの間違いを調べる
MCP サーバーの設定ファイル(.mcp.json や claude_desktop_config.json)にある間違いを調べます。type の欠落、トップレベルのキーの誤り、予約済みや不正な名前、相対パス、未設定の変数、ファイルに直接書かれたシークレットを見つけます。データはブラウザの外に出ません。
ルールは 2026-10-23 時点のドキュメントで確認しています。
ドキュメント: Claude Code / Model Context Protocol / VS Code
確認していないもの: コマンドが存在するか、パッケージをインストールできるか、リモートサーバーが応答するか、そして他のアプリケーションが異なる扱いをする設定。
すべてブラウザ内で実行されます。設定はアップロードされません。
MCP サーバーは JSON ファイルで設定しますが、ちょっとした間違いでサーバーが何も表示されないまま動かなくなることがあります。url があるのに type がないエントリは読み飛ばされ、VS Code 用のキー servers を使ったファイルは Claude Code でも Claude Desktop でも読み込まれず、設定されていない環境変数はそのまま文字列として渡されます。このツールは貼り付けた設定を読み、ドキュメント上で動かないもの、確認したほうがよいもの、参考情報にとどまるものを一覧にします。トークンがファイルに直接書かれているように見える場合も警告します。そのままではバージョン管理に入ってしまうおそれがあるためです。ルールは Claude Code、Model Context Protocol、VS Code のドキュメントに基づいており、確認した日付はツールの下に表示しています。
こんな時に使う
- .mcp.json や claude_desktop_config.json を編集したあと、MCP サーバーが表示されない原因を調べたいとき
- README からコピーした設定を、共有プロジェクトに加える前に確認したいとき
- 設定ファイルをコミットする前に、書き込まれたトークンやパスワードを見つけたいとき
使い方
- MCP 設定ファイルの内容を貼り付けるか、例を読み込みます。
- 見つかったサーバーとその種類、続いて指摘の一覧を確認します。「修正」はドキュメント上そのエントリが動かないこと、「確認」は見ておいたほうがよいこと、「補足」は参考情報を表します。
- ファイルを編集して貼り付け直し、そのファイルを読み込むアプリケーションを再起動します。
FAQ
どのファイルとアプリケーションに対応していますか?
Claude Code のプロジェクトファイル .mcp.json と、Claude Desktop の claude_desktop_config.json で使われる mcpServers 形式です。ほかのアプリケーションは別のフィールドや別のトップレベルのキーを読むことがあるため、それぞれのドキュメントで確認してください。たとえば VS Code のトップレベルのキーは servers です。
エントリに url はあるのに type がありません。何が問題ですか?
Claude Code は type がないエントリを stdio サーバーとして読みます。そのため url があって type がないエントリは設定エラーとなり、サーバーは読み飛ばされます。type に http、sse、ws のいずれかを追加してください。
${API_KEY} のような変数が設定されていないとどうなりますか?
Claude Code は command、args、env、url、headers にある ${VAR} と ${VAR:-default} を展開します。変数が未設定でデフォルト値もない場合、設定は読み込まれますが、Claude Code は警告を表示し、${VAR} という文字列をそのまま使います。安全に使える場合は ${VAR:-default} でデフォルト値を指定してください。
ファイル内のトークンについて警告が出るのはなぜですか?
設定ファイルに直接書かれたトークンは、ファイルをコミットしたり誰かに送ったりしたときに共有されるおそれがあります。この検査は既知のトークン形式と api-key、token、password などの名前に基づくヒューリスティックなので、シークレットを見逃すことも、問題のない値を指摘することもあります。${VAR} を使えば、値をファイルの外に置けます。
サーバーを起動したり、接続をテストしたりしますか?
いいえ。テキストを読むだけです。コマンドが存在するか、パッケージをインストールできるか、リモートサーバーに接続できるかは判断できません。ファイルがチェックを通ったら、アプリケーション上でサーバーを試してください。
設定はサーバーに送信されますか?
いいえ。チェックはブラウザ内で実行されます。