Connect Windsurf

Connect Windsurf so its Cascade agent can create and edit designs on your Brilliant canvas.

Prerequisites

• Windsurf installed.

• Brilliant open. The MCP server only runs while the app is running.

Setup

1. Open Settings (Cmd+,) in Brilliant and pick MCP Connections.

2. Flip the Windsurf row on.

The MCP Connections list with the Windsurf row toggled on (screenshot coming soon)

Brilliant writes a brilliant server into ~/.codeium/windsurf/mcp_config.json. Restart Windsurf so it loads the server.

By hand

Windsurf uses a serverUrl key:

{
  "mcpServers": {
    "brilliant": {
      "serverUrl": "http://127.0.0.1:3333/mcp"
    }
  }
}

Use 3334 or 3335 if Brilliant reported a fallback port.

Try it

Ask Cascade to work in Brilliant:

• In Brilliant, design a checkout screen with an order summary and a payment form.

• Read the Marketing canvas in Brilliant and add a FAQ accordion in the same style.

• Generate an icon set for navigation in Brilliant and lay them out in a row.

Cascade building a design in Brilliant (screenshot coming soon)

Troubleshooting

• Windsurf doesn't list the brilliant tools. Restart Windsurf; it reads MCP servers at launch. Check its MCP panel to confirm brilliant connected.

• Calls fail. Brilliant must be open for the endpoint to answer. Launch it and retry.

• Port mismatch. If Brilliant is on 3334 or 3335, re-toggle the Windsurf row in Settings to rewrite the address, then restart Windsurf.

• The row shows unchecked but the config has a brilliant entry. Its URL points elsewhere. Toggle on to rewrite it to the correct local address.