# Windsurf Setup

Source checked: 2026-07-24
Official source: https://docs.windsurf.com/windsurf/cascade/mcp

Use the complete Secure server address shown by Core during onboarding, including `?setup_attempt=...`. Outside onboarding, use `https://core.gradien.ai/mcp/continuity`.

## Add Core

1. Open Cascade.
2. Select the MCPs icon in the top-right corner, or open Windsurf Settings, Cascade, MCP Servers.
3. Choose Add custom MCP server.
4. Enter `Core` and paste the complete Core address.
5. Save, then approve Core in the browser.
6. Refresh the MCP list or restart Windsurf if the tools do not appear.

For manual configuration, preserve existing servers in `~/.codeium/windsurf/mcp_config.json` and use Windsurf's remote `serverUrl` form:

```json
{
  "mcpServers": {
    "core": {
      "serverUrl": "<secure-server-address>"
    }
  }
}
```

Use Streamable HTTP and OAuth. Do not add a connector key unless the current Windsurf release cannot complete OAuth and the user deliberately chooses that fallback.