Windsurf integration.

Setup

Open Windsurf MCP settings and add Empirical as a custom remote MCP server. Windsurf docs define the raw config at `~/.codeium/windsurf/mcp_config.json`.

mcp_config.json example

Use a remote MCP server entry pointing to Empirical `/mcp`. If you use a bearer token header, refresh it when expired.

{
  "mcpServers": {
    "empirical": {
      "serverUrl": "https://empirical.gauzza.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EMPIRICAL_ACCESS_TOKEN}"
      }
    }
  }
}

Runtime check

Restart or reload MCP in Windsurf, then run one memory query call and confirm tools are visible and returning results. This manual remote configuration is supported; the CLI installer does not currently edit every Windsurf installation automatically.

Support boundary: Use the hosted `/mcp` endpoint with OAuth. Do not paste a long-lived access token into a committed Windsurf config file.