> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuraltrust.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

> Connect Windsurf Cascade to TrustGate over MCP

Windsurf is a code editor whose Cascade agent can read repositories, edit files,
run shell commands, and call MCP tools on a developer's machine.

There is no TrustGuard hook for Windsurf yet. Point Cascade at a TrustGate
[MCP consumer](/trustgate/mcp/overview) so tool access, identity, and rate limits
stay on the gateway.

## Connect to TrustGate

1. Create or open an [MCP consumer](/trustgate/mcp/overview) and bind the
   registries Cascade should reach.
2. Copy the MCP URL from the consumer **Connect** tab.
3. In Windsurf, open **Settings → Cascade → MCP Servers**, or edit
   `~/.codeium/windsurf/mcp_config.json`.

Windsurf's HTTP field is `serverUrl` (not `url`):

```json theme={null}
{
  "mcpServers": {
    "TrustGate": {
      "serverUrl": "https://<mcp-host>/<consumer>/mcp"
    }
  }
}
```

Use OAuth when the consumer requires it — Cascade starts the sign-in flow for
servers that advertise it. For an `ag_…` API key, add a `headers` block:

```json theme={null}
{
  "mcpServers": {
    "TrustGate": {
      "serverUrl": "https://<mcp-host>/<consumer>/mcp",
      "headers": {
        "Authorization": "Bearer <ag_…>"
      }
    }
  }
}
```

Do not put a TrustGuard `tgk_…` collector key in this file.

## Verify

1. Confirm **TrustGate** is connected in the Cascade MCP panel and that its
   tools are listed.
2. Ask Cascade to use a tool from a toolkit bound to that consumer.
3. Confirm the call in TrustGate [metrics](/trustgate/observability/metrics).

## Related

* [TrustGate MCP](/trustgate/mcp/overview)
* [Integrations](/integrations/overview#ai-coding-agents)