Skip to content

Commit 5de3e9d

Browse files
authored
mcp: add a section on user/remote setting differences (#8750)
1 parent e49a737 commit 5de3e9d

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

docs/copilot/chat/mcp-servers.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,13 @@ You have multiple options to add an MCP server in VS Code:
7575

7676
* **Direct installation**: visit the [curated list of MCP servers](https://code.visualstudio.com/mcp) and select **Install** on any MCP server to automatically add it to your VS Code instance.
7777
* **Workspace settings**: add a `.vscode/mcp.json` file in your workspace to configure MCP servers scoped to a workspace.
78-
* **User settings**: specify the server in your user configuration (**MCP: Open User Configuration**) to enable the MCP server across all workspaces, synchronized via [Settings Sync](/docs/configure/settings-sync.md).
78+
* **User or Remote settings**: specify the server in your user configuration (**MCP: Open User Configuration** or **MCP: Open Remote User Configuration**) to enable the MCP server across all workspaces. MCP servers in your user settings can be synchronized via [Settings Sync](/docs/configure/settings-sync.md).
7979
* **Automatic discovery**: enable autodiscovery (`setting(chat.mcp.discovery.enabled)`) of MCP servers defined in other tools, such as Claude Desktop.
8080

8181
To view and manage the list of configured MCP servers, run the **MCP: Show Installed Servers** command from the Command Palette or visit the **MCP SERVERS - INSTALLED** section in the Extensions view.
8282

83+
MCP servers are executed wherever they're configured. If you're connected to a [remote](/docs/remote/remote-overview.md) and want a server to run on the remote machine, it should be defined in your remote settings (**MCP: Open Remote User Configuration**) or in the workspace's settings. MCP servers defined in your user settings are always executed locally.
84+
8385
When VS Code starts the MCP server for the first time, it discovers the server's capabilities and tools. You can then [use these tools in agent mode](#use-mcp-tools-in-agent-mode). VS Code caches the list of tools for an MCP server. To clear the cached tools, use the **MCP: Reset Cached Tools** command in the Command Palette.
8486

8587
> [!CAUTION]

0 commit comments

Comments
 (0)