Skip to content

Windsurf 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.

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:

{
  "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.

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.

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.

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.

  1. Add the Qualytics server to the configuration file shown above.

  2. Sign in:

    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.

Official Documentation

These steps follow the guides for MCP in Devin Desktop, MCP in the Windsurf plugins, and MCP configuration in Devin CLI. If a menu or file path in your version differs, check those pages.

If the connection fails, see MCP Troubleshooting.