Add Salient to Windsurf¶

Connect Salient's MCP server to Windsurf (formerly Codeium) for use with the Cascade AI agent.

Configuration¶

Windsurf stores MCP config in a single global file:

macOSWindowsLinux

~/.codeium/windsurf/mcp_config.json

%USERPROFILE%\.codeium\windsurf\mcp_config.json

~/.codeium/windsurf/mcp_config.json

Stdio Config (Local)¶

{
  "mcpServers": {
    "salient": {
      "command": "python3",
      "args": ["/path/to/salient/tools/mcp-ttx/server.py"],
      "env": {
        "SALIENT_API_URL": "http://localhost:8000",
        "SALIENT_TOKEN": "${env:SALIENT_TOKEN}"
      }
    }
  }
}

Environment variable interpolation

Windsurf supports ${env:VAR} syntax to pull values from your shell environment. Set SALIENT_TOKEN in your .bashrc/.zshrc to avoid hardcoding secrets.

Remote Config¶

For connecting to a hosted Salient MCP endpoint:

{
  "mcpServers": {
    "salient": {
      "serverUrl": "https://your-salient-host/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SALIENT_TOKEN}"
      }
    }
  }
}

Restart Required¶

After editing mcp_config.json, restart Windsurf for changes to take effect. Use Cmd/Ctrl+Shift+P > Reload Window.

Using Salient with Cascade¶

In Windsurf's Cascade agent panel, Salient tools are available automatically:

"List my tabletop scenarios with Salient" "Query the digital twin for recent security gaps"

MCP Marketplace¶

Windsurf has an MCP Marketplace for discovering servers. Salient is not yet listed but can be added manually using the config above.

Tools Reference · MCP Overview