Use MCP servers

2025-08-19

Model Context Protocol (MCP) is an open standard that enables AI models to interact with external tools and services through a unified interface. In Visual Studio, MCP support enhances GitHub Copilot's agent mode by allowing you to connect any MCP-compatible server to your agentic coding workflow. This article guides you through setting up MCP servers and using tools with agent mode in Visual Studio.

Prerequisites

Visual Studio 2022 version 17.14 or later. The latest servicing release of 17.14 is highly recommended as MCP features are actively being added with each release.

How do MCP and Visual Studio extend GitHub Copilot's agent?

MCP clients, such as Visual Studio connect to MCP servers and request actions on behalf of the AI model.
MCP servers provide one or more tools that expose specific functionalities through a well-defined interface.
The Model Context Protocol (MCP) defines the message format for communication between clients and servers, including tool discovery, invocation, and response handling.

For example, a file system MCP server might provide tools for reading, writing, or searching files and directories. GitHub's official MCP server offers tools to list repositories, create pull requests, or manage issues. MCP servers can run locally on your machine or be hosted remotely, and Visual Studio supports both configurations.

By standardizing this interaction, MCP eliminates the need for custom integrations between each AI model and each tool. This allows you to extend your AI assistant's capabilities by simply adding new MCP servers to your workspace. Learn more about the Model Context Protocol specification.

Configuration example with GitHub MCP server

The following walkthrough requires 17.14.9 or later.

Create a new file: <SOLUTIONDIR>\.mcp.json or %USERPROFILE%\.mcp.json. Using Visual Studio to edit this file is recommended so its JSON schema is automatically applied.

Paste the following contents into the .mcp.json file

{
  "servers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Save the file, then activate the CodeLens that appears over the new server to authenticate to this server using a GitHub account.
In Visual Studio, click the Ask dropdown in the GitHub Copilot Chat window, and then select Agent.
Select the tools you'd like to use, for example, list_issues
Try a sample prompt: list issues assigned to me on GitHub
Copilot asks for permission to use a tool made available to it by the MCP server, select Allow with the scope you wish to proceed with.

Supported MCP capabilities

Visual Studio supports the following MCP capabilities:

MCP Server transport: Local standard input/output (stdio), server-sent events (sse), and streamable HTTP (http).
MCP features: Currently of the three primitives (tools, prompts, resources), servers can only provide tools to Copilot's agent mode. The list and descriptions of tools can be updated dynamically using list changed events.
Visual Studio provides servers with the current solution folders using roots (spec).
MCP authorization: Visual Studio supports authentication for remote servers with any OAuth provider.

Finding MCP servers

MCP's official server repository is a great starting point for reference, official, and community-contributed servers that showcase MCP's versatility. You can explore servers for various functionalities, such as file system operations, database interactions, and web services.

MCP is still a relatively new standard, and the ecosystem is rapidly evolving. As more developers adopt MCP, you can expect to see an increasing number of servers and tools available for integration with your projects.

Add an MCP server

You have multiple options to add an MCP server in Visual Studio:

One-click install from the web

With the latest servicing release of 17.14, Visual Studio now supports direct installation of MCP Servers. You can click the Install button on an MCP server to automatically add it to your Visual Studio instance.

Add one-click install button for MCP server

Write your MCP server config in JSON.

HTTP/SSE server example

{"name":"My Server","type":"http","url":"https://example.com/mcp/"}

stdio server example

{"name":"My Server","type":"stdio","command":"python","args":["-m","my_mcp.server"]}

Required fields:

Field	Description
`name`	Friendly name for your server
`type`	Server connection type, for example, "http" or "stdio"
`url`	URL of the server, required for "http"
`command`	Command to start the server executable, required for "stdio"
`args`	Array of arguments passed to the command, required for "stdio"

URL-encode the JSON, you can use an online encoder or your browser console.

Browser console example:
```
encodeURIComponent('{"name":"My Server","type":"http","url":"https://example.com/mcp/"}')
```
Insert the URL-encoded JSON into the MCP URI format to form a Visual Studio install link.

Format:
```
vsweb+mcp:/install?<ENCODED_JSON>
```

Add the markdown badge to your GitHub repo/docs.

Example:

[![Install MCP Server in Visual Studio](https://img.shields.io/badge/Install%20in%20Visual%20Studio-blue?logo=visualstudio)](vsweb+mcp:/install?<ENCODED_JSON>)

When a user clicks the badge, Visual Studio will launch (or prompt to open), and the MCP install dialog will appear, pre-filled with your server details.

Add from chat view

To add an MCP server in Visual Studio:

Select the green plus (+) button in the tool picker in the chat window.
Specify the server name and connection details, such as the URL for HTTP servers or the command and arguments for stdio servers.

Create a file to manage configuration of MCP servers

If you do not already have an mcp.json file, create one in any of the supported locations based on your repository, user, or IDE requirements. To add an MCP server, locate the server’s JSON configuration online (for example, from the GitHub MCP servers repository) and paste it into your mcp.json file.

File locations for automatic discovery of MCP configuration

Visual Studio also checks for MCP configurations set up by other development environments. MCP server configurations are read from the following directories, in the following order:

%USERPROFILE%\.mcp.json
Serves as a global MCP server configuration for a specific user. Adding an MCP server here would make it load for all Visual Studio solutions.
<SOLUTIONDIR>\.vs\mcp.json
Specific to Visual Studio and only loads the specified MCP servers for a specific user, for the specified solution.
<SOLUTIONDIR>\.mcp.json
Works well if you're looking for an MCP configuration that you can track in source control for a repo.
<SOLUTIONDIR>\.vscode\mcp.json
Scoped to the repository/solution and typically not source controlled.
<SOLUTIONDIR>\.cursor\mcp.json
Scoped to the repository/solution and typically not source controlled.

Some of these locations require .mcp.json while others require mcp.json.

MCP configuration format

You may define both remote (URL and credentials) and local (command-line invocation) servers.

It’s common to invoke tools via package managers. For example, npx -y @azure/mcp@latest or docker run ... mcp/github. Visual Studio respects whatever command you specify, allowing you to pin versions or pass flags as needed.

Format must follow the MCP specification, for example, an array of server objects, each with name, command or url, transport, etc.

Editing MCP configuration

With an existing mcp.json file, add the file location to Solution Items in Solution Explorer, if you're checking the file into your version control system.

When the file is saved with valid syntax, GitHub Copilot's agent restarts and reloads the configured servers.

Tool lifecycle

As soon as a server is discovered or added:

Visual Studio initializes the server (performs a handshake and queries the tool list).
Visual Studio subscribes to the MCP event notifications/tools/list_changed.
When that event fires, Visual Studio resets any prior acceptances or permissions on tools (to prevent rug-pull attacks), re-fetches the tool list, and updates the count/UI live.
When the server is successfully enabled, tools are made available to the Agent. The tools are disabled by default and must be manually enabled.
If a server is removed, Visual Studio immediately kills its process and withdraws all its tools from the UI.
If you edit a server definition, Visual Studio terminates and relaunches it, and then re-queries.

Manage tool approvals

When a tool is invoked, Copilot requests confirmation to run the tool. This is because tools might run locally on your machine and perform actions that modify files or data.

In the chat pane, after a tool invocation, use the Allow dropdown options to automatically confirm the specific tool for the current session, solution, or all future invocations.

You can reset tool confirmation selections in Tools > Options > GitHub > Copilot > Tools.

Manage authorization

Visual Studio now supports authentication for remote servers with any OAuth provider, per MCP authorization spec, in addition to integration with the Visual Studio keychain.

To manage authentication for an MCP server:

Select Manage Authentication for that server from CodeLens in the .mcp.json file.
Provide credentials for the necessary OAuth provider for that server in the browser pop-up.

Frequently asked questions

As an administrator, how do I control use of MCP servers in agent mode for Visual Studio users?

Agent mode and MCP usage in Visual Studio are governed by the GitHub policy settings in the GitHub Copilot dashboard for administrators. If the administrator turns off this setting, users under that subscription won’t be able to use agent mode or connect to MCP servers in Visual Studio.

For more information, see managing policies and features for copilot in your enterprise.