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

# Windsurf

> Add Spiral to Windsurf (now Devin Desktop) as a remote MCP server: paste one link, sign in, no API key.

Windsurf is now called Devin Desktop. Your Windsurf settings carry over, and both agents in it, Devin Local and the
legacy Cascade, read the same MCP config file.

**1. Add the server**

Open the **Customize** page from the Agents window and click **MCPs**. Under **This computer**, open the config
file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json`
on Windows. Add this:

```json theme={null}
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

No header and no client ID or secret: Devin Desktop registers itself with Spiral. Then refresh the list.

If you also use the Devin CLI, this command writes the same file:

```bash theme={null}
devin mcp add -s user spiral https://api.spiral.ai/mcp
```

**2. Sign in**

Click **Authenticate** on the Spiral server in **Customize › MCPs**, or let the agent call Spiral once: your
browser opens. Sign in to Spiral, pick the organization and click **Authorize**. No API key.

From the terminal instead:

```bash theme={null}
devin mcp login spiral
```

**3. Check it**

Spiral is listed under **This computer** in **Customize › MCPs**. From the terminal:

```bash theme={null}
devin mcp list
```

**4. Try a starter prompt**

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

> [accordion] With an API key instead
>
> Create a key in the [console](https://spiral.ai/start) under **API keys**, keep it in `SPIRAL_API_KEY`, and
> add the header to the same file. Devin Desktop reads the key from your environment:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "spiral": {
>       "url": "https://api.spiral.ai/mcp",
>       "headers": { "Authorization": "Bearer ${env:SPIRAL_API_KEY}" }
>     }
>   }
> }
> ```

If something does not work, see [Troubleshooting](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.