Connect Windsurf

Open MCP settings

Click the MCP icon in the top-right of the Cascade panel, or go to Settings → Cascade → MCP Servers.

Open the raw config

Choose Add custom server (or View raw config) to open ~/.codeium/windsurf/mcp_config.json.

Add the Rings server

{
  "mcpServers": {
    "rings": {
      "serverUrl": "https://production-api.joinrings.com/mcp"
    }
  }
}

Remote servers use serverUrl instead of a command.

Refresh and authenticate

Save the file and click Refresh in the MCP panel. Windsurf connects and prompts you to sign in to Rings.

Check the tools

The Rings tools appear under the server entry in the MCP panel. Toggle off any you do not want Cascade to call.

Using an API key instead

{
  "mcpServers": {
    "rings": {
      "serverUrl": "https://production-api.joinrings.com/mcp",
      "headers": {
        "x-api-key": "${env:RINGS_API_KEY}"
      }
    }
  }
}

Windsurf interpolates ${env:VAR_NAME} and ${file:/path/to/file} in config values, so the key never has to sit in the file itself.

Getting Started

MCP Guide

Using an API key instead

​Using an API key instead

Using an API key instead