Windsurf

Windsurf uses a dedicated MCP config file. Keep the hosted endpoint and Authorization header there, then restart the app cleanly.

WHAT IS DIFFERENT HERE

Editor-specific MCP wiring

Windsurf reads a global MCP config, so one server entry can cover every repo you open in the app.

CONFIG LOCATION

Paste the JSON into ~/.codeium/windsurf/mcp_config.json.

Keep the server name stable as zephex and swap only the key between environments.

PREREQUISITES

Windsurf installed.
An active Zephex API key.
Access to ~/.codeium/windsurf on the current machine.

CONFIG

Create the directory first if it does not exist.
Keep the server name as zephex and the URL as the hosted /mcp endpoint.
Because this is a global file, rotate the key here if you ever revoke it from the dashboard.

mcp_config.json

{  "mcpServers": {    "zephex": {      "serverUrl": "https://zephex.dev/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

RESTART

Quit Windsurf completely.
Reopen the app.
Open a fresh session so the Cascade panel reconnects with the new MCP config.

VERIFY

Check the Cascade panel for connected MCP servers.
Confirm zephex appears and the tool inventory is non-empty.
Fallback to a direct tools/list curl call if the panel does not update.

COMMON ISSUES

The file path is wrong or the directory was not created.
The app was left running in the background instead of fully restarted.
The global JSON contains trailing commas or syntax errors.

If the editor still does not connect, return to Quickstart or check Connection Issues.