VS Code で MCP サーバーを使用する

モデルコンテキストプロトコル (MCP) は、AI モデルが統一されたインターフェースを介して外部ツールやサービスを使用できるようにするオープン標準です。VS Code では、MCP サーバーはファイル操作、データベース、外部 API との連携などのタスク用のツールを追加します。

この記事では、Visual Studio Code で MCP サーバーを設定し、エージェントモードでツールを使用する方法を説明します。

前提条件

• Visual Studio Code の最新バージョンをインストールします
• Copilot へのアクセス

VS Code で MCP サポートを有効にする

chat.mcp.access 設定は、VS Code にインストールおよび実行できる MCP サーバーを制御します

• all (デフォルト): すべての MCP サーバーが許可されます
• registry: レジストリからの MCP サーバーのみが許可されます
• none: MCP サーバーは許可されません

MCP サポートを一元的に管理する

組織内で MCP サポートを一元的に管理するには、2 つのオプションがあります

• デバイス管理: グループポリシーまたは構成プロファイルを使用して、組織内で MCP サポートを一元的に有効または無効にします。デバイス管理による VS Code 設定の管理について詳しくはこちらをご覧ください。

• GitHub Copilot ポリシー: GitHub Copilot ポリシーを使用して、組織内で MCP サーバーの可用性を制御します。GitHub Copilot ドキュメントのエンタープライズでの Copilot のポリシーと機能の管理について詳しくはこちらをご覧ください。

MCP サーバーを追加する

VS Code で MCP サーバーを追加するには、複数のオプションがあります

{
  "image": "mcr.microsoft.com/devcontainers/typescript-node:latest",
  "customizations": {
    "vscode": {
      "mcp": {
        "servers": {
          "playwright": {
            "command": "npx",
            "args": ["-y", "@microsoft/mcp-server-playwright"]
          }
        }
      }
    }
  }
}

code --add-mcp "{\"name\":\"my-server\",\"command\": \"uvx\",\"args\": [\"mcp-server-fetch\"]}"

エージェントモードで MCP ツールを使用する

MCP サーバーを追加したら、エージェントモードで提供されるツールを使用できます。

エージェントモードで MCP ツールを使用するには

1. チャット ビュー (⌃⌘I (Windows、Linux Ctrl+Alt+I)) を開き、ドロップダウンから エージェント モードを選択します。

   

2. ツール ボタンを選択して、利用可能なツールのリストを表示します。

   オプションで、使用したいツールを選択または選択解除します。検索ボックスに文字を入力してツールを検索できます。

   

   重要

   チャットリクエストでは、一度に最大 128 個のツールを有効にできます。128 個を超えるツールが選択されている場合は、ツールピッカーで一部のツールの選択を解除してツールの数を減らすか、仮想ツールが有効になっていることを確認してください (github.copilot.chat.virtualTools.threshold)。

3. チャット入力ボックスにプロンプトを入力し、必要に応じてツールが自動的に呼び出される方法に注目してください。たとえば、GitHub MCP サーバーをインストールし、「GitHub の問題を一覧表示して」と尋ねます。

   

   ヒント

   プロンプトで # とその後にツール名を入力することで、ツールを直接参照することもできます。これは、すべてのチャットモード (質問、編集、エージェントモード) で行うことができます。

4. プロンプトが表示されたら、確認する前にツールの呼び出しの詳細を慎重に確認してください。

   注意

   MCP ツールは、マシン上でローカルに実行され、ファイルやデータを変更するアクションを実行する可能性があります。ツールの操作の影響を常に理解していることを確認してください。

   続行 ボタンのドロップダウンオプションを使用して、現在のセッション、ワークスペース、または将来のすべての呼び出しに対して特定のツールを自動的に確認します。

   

5. オプションで、ツールを実行する前にツールの入力パラメータを確認および編集します。

   

キャッシュされた MCP ツールをクリアする

VS Code が MCP サーバーを初めて起動すると、サーバーの機能とツールが検出されます。その後、エージェントモードでこれらのツールを使用できます。VS Code は、MCP サーバーのツールリストをキャッシュします。キャッシュされたツールをクリアするには、コマンドパレットで MCP: Reset Cached Tools コマンドを使用します。

MCP リソースを使用する

MCP サーバーは、チャットプロンプトでコンテキストとして使用できるリソースに直接アクセスできます。たとえば、ファイルシステム MCP サーバーはファイルやディレクトリにアクセスでき、データベース MCP サーバーはデータベーステーブルにアクセスできる場合があります。

MCP サーバーからチャットプロンプトにリソースを追加するには

1. チャットビューで、コンテキストを追加 > MCP リソース を選択します。

2. リストからリソースタイプを選択し、オプションのリソース入力パラメータを指定します。

   

MCP サーバーで利用可能なリソースのリストを表示するには、MCP: Browse Resources コマンドを使用するか、MCP: List Servers > Browse Resources コマンドを使用して特定のサーバーのリソースを表示します。

MCP ツールは、応答の一部としてリソースを返すことができます。これらのリソースは、保存 を選択するか、リソースをエクスプローラービューにドラッグアンドドロップすることで、ワークスペースで表示または保存できます。

MCP プロンプトを使用する

MCP サーバーは、スラッシュコマンドでチャットで呼び出すことができる一般的なタスクの事前構成済みプロンプトを提供できます。チャットで MCP プロンプトを呼び出すには、チャット入力フィールドに / を入力し、その後に mcp.servername.promptname の形式でプロンプト名を入力します。

オプションで、MCP プロンプトは追加の入力パラメータを要求する場合があります。

関連するツールをツールセットにグループ化する

MCP サーバーを追加すると、ツールのリストが長くなる可能性があります。これにより、個々のツールの管理が面倒になる場合があります。たとえば、再利用可能なプロンプトファイルやカスタムチャットモードを定義する場合などです。

ツールを管理しやすくするために、関連するツールをツールセットにグループ化できます。ツールセットは、単一のエンティティとして参照できる個々のツールのコレクションです。ツールセットには、組み込みツール、MCP ツール、または拡張機能によって提供されるツールを含めることができます。

VS Code でツールセットを作成して使用する方法について詳しくはこちらをご覧ください。

インストールされた MCP サーバーを管理する

インストールされた MCP サーバーに対して、サーバーの起動または停止、サーバーログの表示、サーバーのアンインストールなど、さまざまなアクションを実行できます。

MCP サーバーに対してこれらのアクションを実行するには、次のいずれかのオプションを使用します

• MCP SERVERS - INSTALLED セクションのサーバーを右クリックするか、歯車アイコンを選択します

  

• mcp.json 構成ファイルを開き、エディター (コードレンズ) でインラインアクションにアクセスします

  

  MCP: Open User Configuration または MCP: Open Workspace Folder Configuration コマンドを使用して、MCP サーバー構成にアクセスします。

• コマンドパレットから MCP: List Servers コマンドを実行し、サーバーを選択します

  

MCP サーバーを自動的に起動する

MCP サーバーを追加または構成を変更すると、VS Code はサーバーが提供するツールを検出するためにサーバーを (再) 起動する必要があります。

chat.mcp.autostart 設定 (実験的) を使用して、構成変更が検出されたときに VS Code が MCP サーバーを自動的に再起動するように構成できます。

または、チャットビューから、またはMCP サーバーリストから再起動アクションを選択して、MCP サーバーを手動で再起動します。

MCP サーバーを見つける

MCP は比較的新しい標準であり、エコシステムは急速に進化しています。より多くの開発者が MCP を採用するにつれて、プロジェクトとの統合に利用できるサーバーとツールの数が増えることが予想されます。

GitHub MCP サーバーレジストリは素晴らしい出発点です。VS Code の拡張機能ビューから直接レジストリにアクセスできます。

MCP の公式サーバーリポジトリには、MCP の多機能性を示す公式サーバーとコミュニティ貢献サーバーが提供されています。ファイルシステム操作、データベースインタラクション、Web サービスなど、さまざまな機能のサーバーを探索できます。

VS Code 拡張機能は、MCP サーバーを貢献し、拡張機能のインストールプロセスの一部として構成することもできます。Visual Studio Marketplace で MCP サーバーサポートを提供する拡張機能を確認してください。

MCP サーバーの信頼

MCP サーバーは、マシン上で任意のコードを実行できます。信頼できるソースからのみサーバーを追加し、起動する前にパブリッシャーとサーバー構成を確認してください。VS Code で AI を使用する際の影響を理解するには、セキュリティドキュメントをお読みください。

ワークスペースに MCP サーバーを追加したり、構成を変更したりするときは、起動する前にサーバーとその機能を信頼することを確認する必要があります。VS Code は、サーバーを初めて起動するときに、サーバーを信頼することを確認するダイアログを表示します。ダイアログの MCP サーバーへのリンクを選択して、別のウィンドウで MCP サーバー構成を確認します。

サーバーを信頼しない場合、サーバーは起動せず、チャットリクエストはサーバーが提供するツールを使用せずに続行されます。

コマンドパレットから MCP: Reset Trust コマンドを実行して、MCP サーバーの信頼をリセットできます。

デバイス間で MCP サーバーを同期する

設定同期を有効にすると、MCP サーバー構成を含む設定と構成をデバイス間で同期できます。これにより、一貫した開発環境を維持し、すべてのデバイスで同じ MCP サーバーにアクセスできます。

設定同期で MCP サーバーの同期を有効にするには、コマンドパレットから 設定同期: 構成 コマンドを実行し、同期する構成のリストに MCP サーバー が含まれていることを確認します。

構成形式

MCP サーバーは、サーバー定義と機密データ用のオプションの入力変数の 2 つの主要セクションを定義する JSON ファイル (mcp.json) を使用して構成されます。

MCP サーバーは、異なるトランスポート方法を使用して接続できます。サーバーがどのように通信するかをに基づいて、適切な構成を選択してください。

構成構造

構成ファイルには 2 つの主要セクションがあります

• "servers": {} - MCP サーバーとその構成のリストが含まれます
• "inputs": [] - API キーなどの機密情報のオプションのプレースホルダー

サーバー構成で事前定義変数を使用できます。たとえば、ワークスペースフォルダー (${workspaceFolder}) を参照する場合などです。

標準 I/O (stdio) サーバー

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

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

HTTP および Server-Sent Events (SSE) サーバー

HTTP 経由で通信するサーバーには、この構成を使用します。VS Code は最初に HTTP ストリームトランスポートを試行し、HTTP がサポートされていない場合は SSE にフォールバックします。

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

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

機密データ用の入力変数

入力変数を使用すると、構成値のプレースホルダーを定義でき、API キーやパスワードなどの機密情報をサーバー構成に直接ハードコーディングする必要がありません。

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

入力変数のプロパティ

{
  "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}"
      }
    }
  }
}

サーバーの命名規則

MCP サーバーを定義するときは、サーバー名に次の命名規則に従ってください

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

MCP サーバーのトラブルシューティングとデバッグ

MCP 出力ログ

VS Code が MCP サーバーで問題に遭遇すると、チャットビューにエラーインジケーターが表示されます。

チャットビューのエラー通知を選択し、出力表示 オプションを選択してサーバーログを表示します。または、コマンドパレットから MCP: List Servers を実行し、サーバーを選択して、出力表示 を選択します。

MCP サーバーをデバッグする

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

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

MCP Dev Guide のMCP 開発モードについて詳しくはこちらをご覧ください。

よくある質問

どの MCP ツールを使用するかを制御できますか？

• エージェントモードのときにチャットビューで ツール ボタンを選択し、必要に応じて特定のツールをオン/オフに切り替えます。
• コンテキストを追加 ボタンを使用するか、# を入力して、特定のツールをプロンプトに追加します。
• より高度な制御については、.github/copilot-instructions.md を使用してツールの使用を微調整できます。

Docker を使用しているときに MCP サーバーが起動しない

コマンド引数が正しいこと、およびコンテナがデタッチモード (-d オプション) で実行されていないことを確認してください。エラーメッセージがないか MCP サーバーの出力を確認することもできます (トラブルシューティングを参照)。

「リクエストあたり 128 個を超えるツールを使用することはできません。」というエラーが表示されます。

モデルの制約により、チャットリクエストでは一度に最大 128 個のツールしか有効にできません。128 個を超えるツールが選択されている場合は、チャットビューのツールピッカーで一部のツールまたはサーバー全体の選択を解除してツールの数を減らすか、仮想ツールが有効になっていることを確認してください (github.copilot.chat.virtualTools.threshold)。

関連リソース

• モデルコンテキストプロトコルドキュメント
• モデルコンテキストプロトコルサーバーリポジトリ
• Visual Studio Code でエージェントモードを使用する