Update MCP documentation to use mcp.json file instead of settings.json in VS Code #46327
Copy link
Copy link
Open
Labels
contentThis issue or pull request belongs to the Docs Content teamThis issue or pull request belongs to the Docs Content team
Description
Code of Conduct
- I have read and agree to the GitHub Docs project's Code of Conduct
What article on docs.github.com is affected?
What part(s) of the article would you like to see updated?
The article states:
Your personal instance of Visual Studio Code. You will be the only person who has access to configured MCP servers. To do this, add the configuration to your settings.json file in Visual Studio Code. MCP servers configured this way will be available in all workspaces.
However, this instruction does not work as expected with Visual Studio Code.
When I add the MCP server configuration to settings.json, the MCP server does not work. When I add the same configuration to mcp.json, the MCP server works correctly.
Additionally, when I open the Command Palette and run MCP: Open User Configuration, Visual Studio Code opens mcp.json, not settings.json.
Additional information
The documentation should specify the correct configuration file and provide accurate instructions for configuring user-level MCP servers that are available across workspaces.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
contentThis issue or pull request belongs to the Docs Content teamThis issue or pull request belongs to the Docs Content team
Activity
[-]Update MCP documentation to use `mcp.json` instead of `settings.json` in VS Code[/-][+]Update MCP documentation to use `mcp.json` file instead of `settings.json` in VS Code[/+]