Windsurf

One global file: ~/.codeium/windsurf/mcp_config.json. There is no per-project file.

Save the file and reload Windsurf. A remote server uses serverUrl. A field named url is ignored.

Hosted server

Streamable HTTP

{
  "mcpServers": {
    "mcp-reference-server": {
      "serverUrl": "https://your-app.onrender.com/mcp"
    }
  }
}

Local npx

stdio. Windsurf does not document a working directory, so npx is the entry that does not depend on one.

{
  "mcpServers": {
    "mcp-reference-server": {
      "command": "npx",
      "args": ["-y", "mcp-reference-server"],
      "env": { "MCP_MODE": "stdio" }
    }
  }
}

Code Engine uses the hosted block with https://your-app.xxxx.ca-tor.codeengine.appdomain.cloud/mcp.