MCP設定リファレンス

この記事では、MCPサーバー設定ファイルのフォーマット、関連コマンド、およびVS Codeにおける設定についてのリファレンスを提供します。MCPサーバーの追加および管理に関する詳細については、MCPサーバーの追加と管理を参照してください。

設定ファイル

MCPサーバーの設定は、JSONファイルであるmcp.jsonに保存されます。このファイルは、ワークスペース（.vscode/mcp.json）またはユーザープロファイル内に配置できます。VS Codeは、設定ファイルに対するIntelliSenseを提供します。

設定の構造

設定ファイルには主に3つのセクションがあります

• "servers": {}: サーバー名とそれらの設定をマッピングするオブジェクトです。各キーはサーバー名で、値はサーバーの設定オブジェクトです。サーバーのタイプに応じて、異なるフィールドが必要になります。

• "inputs": []: APIキーなどの機密情報用の入力変数定義のオプション配列です。

• "sandbox": {}: サンドボックス化されたサーバーのファイルシステムおよびネットワークのアクセスルールを定義するオプションオブジェクトです。サンドボックス設定を参照してください。macOSおよびLinuxにのみ適用されます。

サーバー設定では、定義済みの変数を使用して、たとえばワークスペースフォルダ（${workspaceFolder}）を参照することができます。

標準入出力（stdio）サーバー

標準入力および標準出力ストリームを介して通信するサーバーには、この設定を使用します。これは、ローカルで実行されるMCPサーバーとして最も一般的なタイプです。

{
  "servers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

サンドボックス設定

ローカルで実行されているstdio MCPサーバーのサンドボックス化を有効にして、ファイルシステムやネットワークへのアクセスを制限できます。サンドボックス化されたサーバーは、明示的に許可したファイルシステムのパスとネットワークドメインにのみアクセスできます。サンドボックス化はmacOSおよびLinuxでのみ利用可能です。

サーバーのサンドボックス化を有効にするには、設定で "sandboxEnabled": true を指定します。次に、トップレベルの sandbox オブジェクトを定義し、ファイルシステムおよびネットワークのアクセスルールを指定します。sandbox オブジェクトは servers や inputs と同階層にあり、そのルールはすべてのサンドボックス化されたサーバーに適用されます。サンドボックス化されたサーバーが現在のルールで許可されていないアクセスを必要とする場合は、サーバーの出力でエラーメッセージを確認し、必要に応じて sandbox 設定を更新してください。

sandbox オブジェクトは以下のプロパティをサポートしています

ファイルシステムのパスの値には、${workspaceFolder} などの 定義済みの変数 を使用できます。

{
  "servers": {
    "myServer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "sandboxEnabled": true
    }
  },
  "sandbox": {
    "filesystem": {
      "allowWrite": ["${workspaceFolder}"],
      "denyRead": ["${userHome}/.ssh"]
    },
    "network": {
      "allowedDomains": ["api.example.com", "*.cdn.example.com"]
    }
  }
}

HTTPおよびServer-Sent Events（SSE）サーバー

HTTPを介して通信するサーバーには、この設定を使用します。VS CodeはまずHTTP Streamトランスポートを試し、HTTPがサポートされていない場合はSSEにフォールバックします。

ネットワーク経由で利用可能なサーバーに加えて、VS Codeは、UnixソケットまたはWindowsの名前付きパイプ上でHTTPトラフィックをリッスンしているMCPサーバーに接続することができます。接続するには、ソケットまたはパイプのパスを unix:///path/to/server.sock、Windowsでは pipe:///pipe/named-pipe の形式で指定します。unix:///tmp/server.sock#/mcp/subpath のように、URLフラグメントを使用してサブパスを指定することもできます。

oauth オブジェクトは以下のプロパティをサポートしています

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

{
  "servers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "clientId": "example-client-id"
      }
    }
  }
}

機密データ用の入力変数

入力変数を使用すると、設定値のプレースホルダーを定義できるため、APIキーやパスワードなどの機密情報をサーバー設定に直接ハードコードする必要がなくなります。

${input:variable-id} を使用して入力変数を参照すると、サーバーが初めて起動するときに、VS Codeは値の入力を求めます。その値は、以降の使用のために安全に保存されます。VS Codeの 入力変数 についての詳細をご覧ください。

各入力変数には、VS Codeが値の入力を促す方法を決定する type があります。以下の入力タイプがサポートされています

• promptString: 入力ボックスを開き、ユーザーにフリーテキストの入力を求めます。
• pickString: ユーザーが選択できるオプションのリストを表示します。
• command: コマンドを実行し、その結果を入力値として使用します。

共通のプロパティ

promptString のプロパティ

pickString のプロパティ

command のプロパティ

{
  "inputs": [
    {
      "type": "promptString",
      "id": "perplexity-key",
      "description": "Perplexity API Key",
      "password": true
    }
  ],
  "servers": {
    "perplexity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "server-perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "${input:perplexity-key}"
      }
    }
  }
}

開発モード

サーバー設定に dev キーを追加することで、MCPサーバーの開発モードを有効にできます。これは2つのプロパティを持つオブジェクトです

• watch: MCPサーバーを再起動するためのファイルの変更を監視する、単一または配列のグロブパターン。すべてのサーバータイプで利用可能です。
• debug: MCPサーバーでデバッガーをセットアップできるようにします。現在、VS CodeはNode.jsおよびPython MCPサーバーのデバッグをサポートしています。stdioサーバーでのみ利用可能です。

MCPデベロッパーガイドの MCP開発モード についての詳細をご覧ください。

サーバーの名前付け規則

MCPサーバーを定義する際は、サーバー名について以下の名前付け規則に従ってください

• サーバー名には、"uiTesting" や "githubIntegration" のようにキャメルケース（camelCase）を使用します
• 空白文字や特殊文字の使用は避けてください
• 競合を避けるために、各サーバーに一意の名前を使用します
• サーバーの機能やブランドを反映した、"github" や "database" のような分かりやすい名前を使用します

コマンド

次の表は、コマンドパレット（⇧⌘P (Windows, Linux Ctrl+Shift+P)）で利用可能なMCP関連のコマンドの一覧です。

設定

VS CodeのAI設定の完全なリストについては、AI設定リファレンスを参照してください。以下の設定は、MCPサーバーに固有のものです。

関連リソース

• MCPサーバーの追加と管理
• Model Context Protocol ドキュメント
• MCP 開発ガイド