# Windsurf

Source: /docs/mcp/connect/windsurf

Windsurf reads remote MCP servers from its own config file. Add OrbitOrca there and refresh.

### Get a token [#get-a-token]

Open the dashboard's [Connect an agent](https://app.orbitorca.com/mcp) page and create a token. Read-only is the default; add write only if you want the agent to deploy and change apps. The full token is shown **once**, at creation — copy it now.

### Add the server [#add-the-server]

Add this block to `~/.codeium/windsurf/mcp_config.json` (create the file if it doesn't exist), with your token in place of `{{token}}`:

```json
{
  "mcpServers": {
    "orbitorca": {
      "serverUrl": "https://api.orbitorca.com/mcp",
      "headers": { "Authorization": "Bearer {{token}}" }
    }
  }
}
```

Then open Windsurf's MCP settings and refresh the server list.

### Try it [#try-it]

Ask Cascade to *"list my OrbitOrca apps"*. If it comes back with your apps, you're connected.

The dashboard's [Connect an agent](https://app.orbitorca.com/mcp) page has ready-to-paste snippets for other editors and always shows the current server URL and your token. Windsurf uses the same URL and `Authorization` header as every other host.

Next: [what a token can and can't do](/docs/mcp/scopes-and-safety).