# Windsurf Windsurf

Source: https://userguide.qualytics.io/using-the-platform/mcp/connecting-external-ai-clients/windsurf/

Connect the Windsurf editor, the Windsurf plugins, and Devin CLI to the Qualytics MCP server. Before you start, have a Personal API Token and your Qualytics MCP server URL ready. See [External AI Client Requirements](https://userguide.qualytics.io/using-the-platform/mcp/connecting-external-ai-clients/requirements/).

All three read the same user MCP configuration file, `~/.config/devin/mcp_config.json` on macOS and Linux, or `%AppData%/devin/mcp_config.json` on Windows. Add the Qualytics server to it under `mcpServers`:

```json
{
  "mcpServers": {
    "qualytics": {
      "url": "https://your-qualytics-instance.qualytics.io/api/mcp/"
    }
  }
}
```

Leave out the `headers` and OAuth client properties. Each client registers its own client with Qualytics, and Qualytics does not accept an API token in a header. Each client also keeps its own sign-in, so you authorize Qualytics once in each one you use.

**Tab: Windsurf Editor**

The Windsurf editor is now Devin Desktop.

1. Open **Customize** from the Agents window, or click **Customize** in the agent sidebar, then click **MCPs**.
2. In **Install MCPs for**, choose **This computer**.
3. Open the config file, add the Qualytics server shown above, and save it.
4. Refresh the list so the Qualytics server appears.
5. When Qualytics shows **Needs authentication**, click **Authenticate**. On the Qualytics authorization page, paste your Qualytics API token and approve the access.

By default, the agent asks for your approval before it calls any MCP tool.

**Tab: Windsurf Plugins**

These steps are for the Windsurf plugins that run inside other editors, such as JetBrains IDEs.

1. Open the MCP configuration. Go to **Settings** > **Tools** > **Windsurf Settings** > **Add Server**, or choose **Open MCP config file** from the MCP menu in Cascade.
2. Add the Qualytics server shown above and save the file.
3. Press the refresh button so Cascade loads the new server.
4. When the plugin asks you to sign in, paste your Qualytics API token on the Qualytics authorization page and approve the access.

> **Info: Teams and Enterprise**
>
> A team admin can turn MCP access on or off and allow only listed servers. Once any server is on the allowlist, every other server is blocked, so ask your admin to add the Qualytics MCP URL if it does not load. On Enterprise, MCP must also be turned on in settings.

**Tab: Devin CLI**

1. Add the Qualytics server to the configuration file shown above.
2. Sign in:

   ```bash
   devin mcp login qualytics
   ```
3. On the Qualytics authorization page, paste your Qualytics API token and approve the access. Devin CLI stores the MCP tokens and refreshes them on its own.

To sign in again after the authorization expires, run `devin mcp logout qualytics` and then `devin mcp login qualytics`.

> **Info: Official Documentation**
>
> These steps follow the guides for [MCP in Devin Desktop](https://docs.devin.ai/desktop/cascade/mcp), [MCP in the Windsurf plugins](https://docs.windsurf.com/plugins/cascade/mcp), and [MCP configuration in Devin CLI](https://docs.devin.ai/cli/extensibility/mcp/configuration). If a menu or file path in your version differs, check those pages.

If the connection fails, see [MCP Troubleshooting](https://userguide.qualytics.io/using-the-platform/mcp/troubleshooting/).

*Last updated: November 7, 2026.*