add-mcp-server

To add an MCP server to Warp, edit the appropriate .mcp.json wrapper file. The process locates the correct config scope, validates paths, handles environment variables, and writes the new entry without removing existing servers.

Yes, you can configure project-scoped MCP servers in Warp. The setup determines the correct scope and locates the appropriate project-level .mcp.json file, preserving any existing global or project-specific server configurations.

Warp MCP config supports both command-based stdio transports and URL-based transports. The configuration process safely handles environment variables and working directories for either transport type during server entry creation.

The safest way to update a .mcp.json file is to validate paths and write entries without removing existing servers. This ensures safe edits by preserving your current server configurations while adding or updating new MCP entries.

Environment variables for Warp MCP servers are handled during the config editing process. The setup ensures safe edits by validating the .mcp.json paths and correctly integrating env vars for both command-based and URL-based transports.

MCP server configurations break when edits remove existing servers from the .mcp.json file. Using a safe editing process that validates paths and preserves current entries prevents this issue when adding new MCP servers to Warp.