Configure options below — the preview updates in real time.

Server Identity

Basic identification and control fields for the MCP server.

The display name for this MCP server. Used as the key in the mcpServers object.

DisabledWhether this specific MCP server should be ignored/disabled by the client without deleting the configuration.

List of tool names that the MCP client may execute automatically without prompting the user for confirmation.

List of tool names from this server that should be blocked and never executed.

Transport Configuration

Defines the transport protocol mechanism used to communicate with the MCP server.

The transport protocol used to communicate with the MCP server. Use 'stdio' for local servers and 'sse'/'http' for remote servers.

STDIO Transport (Local Server)

Configuration for locally running MCP servers started via a terminal command.

The base terminal command or executable used to start the local MCP server process.

The arguments passed to the executable. Include the script path, flags, or target directories.

Secrets, API keys, or configurations to be injected securely into the server process as environment variables. All values must be strings.

The Current Working Directory from which to start the server process. Essential for servers that rely on relative file paths.

A list of host environment variable names that the client is allowed to forward to the isolated MCP server process.

HTTP/SSE Transport (Remote Server)

Configuration for remote MCP servers accessed via HTTP or SSE endpoints.

The endpoint URL used to establish the remote MCP connection.

Custom HTTP headers to be sent when establishing the connection (e.g. bearer tokens or custom auth).

OAuth Configuration

OAuth settings for HTTP-based MCP servers requiring authentication flows.

Custom redirect URI for the OAuth flow.

List of OAuth scopes to request during authorization.

Input Variables (VS Code / Copilot)

Dynamically prompt the user for secrets or API keys on first server start. The client stores them securely and maps them into env via ${input:variable-id} syntax.

Array of input variable definitions. Each item needs an id, type (e.g. promptString), description, and optional password boolean. Referenced in env values as ${input:<id>}.

Global Client Settings

Global MCP discovery and execution rules used by CLI tools.

A global default command used to start MCP servers when no per-server command is specified.

Whitelist of MCP server names to allow connections to.

Blacklist of MCP server names to block.

Include MCP JSONWhether to inherit/merge MCP servers defined in global user-level configurations.