What MCP config does
The Model Context Protocol (MCP) lets AI assistants use external tools and data through servers. Each client reads a JSON file listing the servers to start or connect to: Claude Desktop uses claude_desktop_config.json, Claude Code and Cursor use .mcp.json or mcp.json in the project, and VS Code uses .vscode/mcp.json with a servers key.
If your product has an MCP server, publishing a ready config snippet in your docs is the fastest way to get developers to try it.
Questions
Local or remote server?
Local servers run as a command on the user's machine (stdio). Remote servers are reached over HTTP at a URL, often with OAuth or a header token.
Where do secrets go?
In env or headers. Avoid committing real keys to a shared .mcp.json; use placeholders and environment variables.
Why does VS Code use a different key?
VS Code's file uses servers instead of mcpServers. The generator writes the right shape for each client.
Is the config sent anywhere?
No. It is built in your browser.