Skip to content
Spec{0}

Connect Windsurf

Add Spec0

Open or create ~/.codeium/windsurf/mcp_config.json and add:

{
  "mcpServers": {
    "spec0": {
      "serverUrl": "http://127.0.0.1:7474/mcp"
    }
  }
}

Note the key is serverUrl (not url), which is Windsurf’s convention for remote HTTP MCP servers.

Then quit Windsurf completely and reopen — closing the window isn’t enough; the MCP config is read once on app start.

Or use the Command Palette

You can also let Windsurf walk you through the setup:

  1. Press ⌘⇧P (or Ctrl+Shift+P) to open the Command Palette.
  2. Search for MCP: Add Server.
  3. Pick the HTTP transport and paste http://127.0.0.1:7474/mcp.

Windsurf writes the entry to the same mcp_config.json file.

Optional fields

headers accepts a map for auth; ${env:VAR_NAME} interpolation works in serverUrl and headers. Neither is needed for Spec0 — local loopback, no auth.

Verify the connection

In Windsurf’s Cascade chat, ask:

Use the spec0_whoami tool.

You should see a kind: "windsurf"-ish identification and a fresh session id.

Tips

  • Full app restart is required after editing the config; window reload doesn’t reload MCP servers.
  • If a server fails to connect, check Cascade’s tool panel — it’ll surface the error and the URL it tried.