Guides3 min read

Windsurf (Devin Desktop)

Connect Windsurf's Cascade agent (now Devin Desktop) to OpsKnight with OAuth or a personal access token header.

Status: Expected. These steps follow the vendor documentation; no end-to-end run of Windsurf against OpsKnight is recorded.

Vendor documentation (fetched 12 November 2026): Cascade MCP (docs.windsurf.com now redirects there) and Devin Desktop MCP. Windsurf has been renamed Devin Desktop; the vendor pages disagree on the configuration path, so both are listed below.

Before you begin

  • An administrator has turned on AI assistant access in Settings → Integrations & ChatOps → MCP (AI Assistants) (see MCP setup).
  • Copy the MCP server URL from the Connect tab on that page; the examples below use https://ops.your-company.com/mcp.
  • You have your own OpsKnight account and Windsurf (Devin Desktop) installed. On Teams and Enterprise, its administrator must allow MCP (see Known limits).
  1. Add OpsKnight to the MCP configuration file:

    json
    {
      "mcpServers": {
        "opsknight": { "serverUrl": "https://ops.your-company.com/mcp" }
      }
    }
    

    The file is ~/.codeium/windsurf/mcp_config.json in Windsurf, and ~/.config/devin/mcp_config.json (or .devin/mcp_config.json in a project) in Devin Desktop, which still reads the legacy Windsurf paths. url is accepted in place of serverUrl.

  2. Press refresh in Cascade's MCP panel.

  3. When the server shows Needs authentication, select Authenticate, sign in to OpsKnight and approve.

Personal access token (alternative)

json
{
  "mcpServers": {
    "opsknight": {
      "serverUrl": "https://ops.your-company.com/mcp",
      "headers": { "Authorization": "Bearer ${env:OPSKNIGHT_TOKEN}" }
    }
  }
}

${env:NAME} is expanded in serverUrl, url and headers.

Verify the connection

  1. In Cascade's MCP panel, opsknight no longer shows Needs authentication.
  2. Ask Cascade "Who am I in OpsKnight, and what can you do for me?". It calls whoami and answers with your role, teams and enabled tools.
  3. In OpsKnight, select Check connection on the Connect tab to see the connection you just made.

Known limits

  • Cascade is limited to 100 tools available at a time (stated on the German-language vendor page; the English pages fetched do not state it). OpsKnight lists at most 54; turn off tools of other servers if you exceed the cap.
  • On Teams and Enterprise, an administrator must turn MCP on, and once any server is allowlisted every other server is blocked. Ask for a pattern that matches your OpsKnight URL (anchored, case-sensitive regular expression).
  • No result-size limit is documented.

Troubleshooting

  • Press refresh in the MCP panel after editing the file.
  • Needs authentication after a few days: the sign-in expired; select Authenticate again.
  • An invalid allowlist regular expression is logged and blocks the server; check it with your administrator.

Last updated for v2.2.0

Edit this page on GitHub