MCP 設定ジェネレーター — Claude、Cursor、VS Code、Windsurf、Codex
MCP サーバーを一度定義するだけで、Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex 用の正確な設定ファイルやコマンドが得られます。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/projects"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.githubcopilot.com/mcp/",
"--header",
"Authorization:${MCP_HEADER_1}"
],
"env": {
"MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
}
}
}
}
- ファイル：macOS は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows は %APPDATA%\Claude\claude_desktop_config.json（「設定」>「開発者」>「設定を編集」から開けます）。保存後、Claude を完全に終了してから再度起動してください。
- リモートサーバーは mcp-remote で中継します（Node.js が必要）。有料プランなら、代わりに「設定」>「コネクタ」で URL を追加でき、OAuth もそこで処理されます。
- Claude Desktop はこのファイル内の ${VAR} を展開しません。プレースホルダーを実際の値に置き換えてください。
すべてブラウザ内で動作します。設定には API トークンが含まれることが多いため、入力・貼り付けした内容がアップロードや保存されることはありません。 すべての無料ツールを見る.
不具合や改善できそうな点を見つけましたか？いただいたメッセージはすべて読み、すぐに対応します。
この MCP 設定ジェネレーターは、1 つのフォームから主要なすべての AI クライアント向けの Model Context Protocol サーバー設定を書き出します。クライアントごとに求めるファイルは少しずつ異なります。Claude Desktop と Cursor は "mcpServers" オブジェクトを使い、VS Code は必須の "type" 付きで "servers" を使い、Windsurf はリモートの URL を "serverUrl" と呼び、Claude Code はリモートのエントリに "type" が必要で、Codex は TOML のテーブルを使います。コマンドや URL を一度入力するだけで、使っているツールに合った版をコピーできます。
バリデーターはその逆を行います。読み込まれない設定を貼り付けると、JSON のエラー、欠けているフィールド、クライアントが読まないキーを指摘し、サーバーをフォームに読み込むので、そのまま変換できます。チェックするのは構造で、サーバーのパッケージが存在するかやトークンが有効かは確認しません。それでもサーバーが動かない場合は、クライアントの MCP のログを確認してください。
使い方
- Filesystem や GitHub などのプリセットをクリックするか、空のサーバーを追加します。
- ローカルサーバーの場合は、コマンド（npx、uvx、docker）を設定し、各引数を 1 行ずつ入力します。リモートサーバーの場合は、URL と必要なヘッダーを設定します。
- 必要に応じて、シークレットをファイルに書かずに値を ${VAR} の参照に置き換えるオプションにチェックを入れます。
- クライアントを選び、出力をコピーまたはダウンロードして、その下に表示されたパスに保存します。
- クライアントを再起動して（Claude Desktop は完全に終了してから）設定を読み込み直させます。既存のファイルを修正するには、「検証と変換」に貼り付けます。
よくある質問
claude_desktop_config.json はどこにありますか？
macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json です。いちばん簡単に開く方法は、Claude Desktop の「設定」>「開発者」>「設定を編集」です。ファイルは起動時にしか読み込まれないため、保存したら Claude を完全に終了してから開き直してください。
Claude Code の .mcp.json と claude mcp add の違いは何ですか？
claude mcp add はターミナルからサーバーを登録します。既定の local スコープでは、自分と現在のプロジェクト専用として ~/.claude.json に保存されます。--scope user にするとすべてのプロジェクトで使えるようになり、--scope project にするとプロジェクトのルートの .mcp.json に書き込まれ、バージョン管理を通じてチームで共有できます。.mcp.json の各エントリには "type"（stdio、http、sse）を付けるべきで、url があっても type がないエントリは stdio として読み込まれ、失敗します。
VS Code が mcpServers の設定を無視するのはなぜですか？
VS Code が読むのは、トップレベルのキーが "mcpServers" ではなく "servers" の .vscode/mcp.json で、各サーバーには "type": "stdio"、"http"、"sse" のいずれかが必要です。そのため、Claude や Cursor の README からコピーしたファイルでは何も読み込まれません。バリデーターに貼り付けて、VS Code の形式に変換してください。
MCP の設定に API キーを書かずに済ませるには？
値を貼り付ける代わりに環境変数を参照します。Claude Code は ${VAR} と ${VAR:-default} を展開し、Cursor と Windsurf は ${env:VAR} を使い、VS Code は ${env:VAR} と、シークレットを安全に保存する ${input:id} のプロンプトに対応しています。Codex は env_vars、env_http_headers、bearer_token_env_var で変数を渡します。Claude Desktop は設定内の変数を展開しないため、値をそのまま書く必要があります。
Claude Desktop にリモートの MCP サーバーを追加するには？
Claude Desktop の設定ファイルが起動できるのはローカルのコマンドだけです。有料プランなら「設定」>「コネクタ」からリモートサーバーの URL を追加でき、OAuth のサインインもそこで処理されます。それ以外の場合は mcp-remote で橋渡しします。コマンドは npx、引数は -y、mcp-remote、サーバーの URL で、認証には --header オプションを加えます。Claude Desktop を選ぶと、ジェネレーターがこの橋渡しの設定を書き出します。
stdio、HTTP、SSE のトランスポートの違いは何ですか？
stdio サーバーは、クライアントが起動して標準入出力でやり取りするローカルプロセスとして動作し、ファイルを読んだり手元のマシンで動いたりするツールに向いています。Streamable HTTP サーバーは URL でリモートに動作し、ホスティングされたサーバーの現在の標準です。SSE は古いリモートのトランスポートで、Claude Code は非推奨としており、Codex は Streamable HTTP にしか対応していないので、サーバーが両方を提供している場合は HTTP を選びましょう。
MCP 設定ファイルの場所と形式
• Claude Desktop：~/Library/Application Support/Claude（macOS）または %APPDATA%\Claude（Windows）の claude_desktop_config.json。トップレベルは "mcpServers" で、エントリには command、args、env があります。
• Claude Code：プロジェクトのルートの .mcp.json（project スコープ）または ~/.claude.json（local と user スコープ、claude mcp add で管理）。トップレベルは "mcpServers" で、各エントリに "type" を付けます。
• Cursor：プロジェクト内の .cursor/mcp.json、またはグローバルな ~/.cursor/mcp.json。"mcpServers" を使い、リモートのエントリは "url" と "headers" を使います。
• VS Code：ワークスペースの .vscode/mcp.json、または「MCP: Open User Configuration」で開くユーザーレベルのファイル。トップレベルは "servers" で、任意で "inputs" を加えます。
• Windsurf：~/.codeium/windsurf/mcp_config.json。Windsurf のドキュメントは現在 Devin Desktop の下にあり、そちらは ~/.config/devin/mcp_config.json（macOS/Linux）または %APPDATA%\devin\mcp_config.json を使います。リモートのエントリは "serverUrl" を使います。
• Codex：~/.codex/config.toml、または信頼済みプロジェクト内の .codex/config.toml。サーバーごとに [mcp_servers.<name>] テーブルを 1 つ作り、command/args/env、または url と bearer_token_env_var、http_headers を書きます。
MCP サーバーが読み込まれないよくある原因
• コマンド全体が "command" に入っている（"npx -y @scope/server"）。クライアントはその名前全体の実行ファイルを探してしまいます。command には npx を、残りは args に 1 項目ずつ入れましょう。
• JSON に末尾のカンマや // コメントがある。コメントを受け付けるのは VS Code の mcp.json だけで、他のクライアントは厳密な JSON が必要です。
• npx や uvx が見つからない。macOS の GUI アプリはシェルの PATH を引き継がないことがあります。`which npx` で得られるフルパスをコマンドに使いましょう。
• トップレベルのキーが間違っている：Claude や Cursor のファイルに "servers"、VS Code に "mcpServers" と書いている。
• Claude Code の .mcp.json で、リモートのエントリに "type" がない。この場合はローカルのコマンドとして扱われます。
• クライアントを再起動していない。Claude Desktop はファイルを起動時にしか読みません。Cursor と VS Code は MCP の設定パネルでサーバーの状態を表示します。
サーバーを追加する前のセキュリティ上の注意
MCP サーバーはあなたの権限で動作します。ファイルシステムのサーバーは指定したすべてのフォルダーを読み書きでき、データベースのサーバーは渡した認証情報でクエリを実行できます。1 つのプロジェクトフォルダー、読み取り専用のデータベースユーザー、必要なリポジトリだけに限定した細かい権限の GitHub トークンなど、機能する範囲で最も狭いスコープを与えましょう。
サーバーは公式の配布元からインストールし、本番環境に関わるものはバージョンを固定し、ファイルに貼り付ける有効期限の長いトークンより OAuth を使うリモートサーバーを選びましょう。ツールの出力は信頼できない入力として扱ってください。サーバーが取得した Web ページや Issue には、モデルを狙った指示が含まれている可能性があります。
関連する無料ツール
- JSON 整形 — JSON を整形、圧縮（minify）、検証し、解析エラーは行と列で位置を示します。ブラウザ上で動作、アップロード不要。
- プロンプトテンプレート作成 — {{variables}} 付きのプロンプトを書き、フォームや CSV から値を入れて、1 行ごとに 1 つのプロンプトをテキスト、CSV、OpenAI や Anthropic のバッチファイルとして書き出せます。
- LLM API 料金計算 — キャッシュ、バッチ割引、長文コンテキストの料金区分、推論トークンを考慮して、40 以上のモデルで自分のワークロードのコストを比較できます。価格は出典と日付付き。
- llms.txt ジェネレーター — フォーム、URL のリスト、サイトマップから仕様に準拠した llms.txt を作成し、既存のファイルを検証し、AI クローラー用の robots.txt ルールを生成します。