Skip to main content
Windsurf supports servers through mcp_config.json, which Cascade reads when you use MCP tools. See Cascade MCP integration in the Windsurf docs for the latest UI.

​
Setup

1

Open the config file

From the Command Palette (Shift+Command+P / Ctrl+Shift+P), run Windsurf: Configure MCP Servers, or edit the file directly:
  • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
You can also open it from the MCPs menu in the Cascade panel, then choose the option to view or edit the raw config.
2

Add the OpenCX server

Use the same structure as in Get Started under the Windsurf tab:
Replace your-api-key-here with your OpenCX API key.
3

Restart and verify

Fully quit and reopen Windsurf so Cascade picks up changes. In Cascade, ask: “List my recent chat sessions.”

​
Tips

  • Keep the API key out of shared repos. Windsurf supports interpolation such as ${env:OPENCX_API_KEY} in command, args, and env fields so you can read the key from your shell environment instead of pasting it into the file.
  • If the server fails to start, run npx -y @opencx/mcp in a terminal to confirm Node and network access.

Get Started

API key setup and all client configs

Cursor

Similar mcpServers JSON shape

VS Code

Microsoft editor MCP via mcp.json

Troubleshooting

Common issues and fixes