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

# Windsurf

> Use the LightOn MCP server directly from Windsurf.

## Prerequisites

* [Windsurf](https://windsurf.com) installed
* A LightOn API key from the [LightOn Console](https://console.lighton.ai)

## Configuration

Windsurf configures MCP servers via a JSON file. Add the following to `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "lighton": {
      "serverUrl": "https://api.lighton.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LIGHTON_API_KEY}"
      }
    }
  }
}
```

<Note>
  `${env:LIGHTON_API_KEY}` is Windsurf's syntax for reading an environment variable at runtime. The key is never stored in the config file. Make sure `LIGHTON_API_KEY` is set in your shell environment, you can grab your key from the [LightOn Console](https://console.lighton.ai).
</Note>

## Verification

1. Open the MCP panel in Windsurf and confirm `lighton` appears and shows as connected.

2. Test the connection with a prompt like:

   ```
   Search my LightOn workspaces for documents about [topic]
   ```

You're all set. From any Windsurf session you can now ask Cascade to search or ingest documents in your LightOn workspaces directly.

## References

* [Windsurf docs: MCP](https://docs.windsurf.com/windsurf/cascade/mcp)