← All connections

Connect to Windsurf

Windsurf — MCP in Cascade, configured through mcp_config.json.

Before you start, create your free account.Create account

Which MCP will you connect? The commands below change according to your choice.

  1. 1

    Generate your API key

    Sign in to app.newalgorithm.io with your account, open Keys & apps and generate a key. It is shown only once: copy it and store it somewhere safe.

    Key format
    na_live_xxxxxxxxxxxxxxxxx
  2. 2

    Open the Cascade configuration

    In the Cascade panel, click the tools/plugins icon and choose the option to view the raw configuration (View raw config). It opens the file below:

    Where the file is
    ~/.codeium/windsurf/mcp_config.json
  3. 3

    Declare the NewAlgorithm server

    Windsurf uses serverUrl (not url) to identify remote servers:

    mcp_config.json
    {
      "mcpServers": {
        "NewAlgorithm-TOTVS": {
          "serverUrl": "https://totvs.mcp.newalgorithm.io/mcp",
          "headers": {
            "Authorization": "Bearer na_live_xxxxxxxxxxxxxxxxx"
          }
        }
      }
    }
  4. 4

    Reload

    Save the file and use the Refresh button in Cascade's MCP panel. NewAlgorithm appears with its tools listed.

    Expected: na_prepare, na_search, na_route, na_specialists, na_version

Cascade limits the number of tools active at the same time. If you already have many servers connected, disable the ones you aren't using to make sure the na_* tools stay available.

Authentication and tool details in the Docs.