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).
Connect with OAuth (recommended)
-
Add OpsKnight to the MCP configuration file:
{ "mcpServers": { "opsknight": { "serverUrl": "https://ops.your-company.com/mcp" } } }The file is
~/.codeium/windsurf/mcp_config.jsonin Windsurf, and~/.config/devin/mcp_config.json(or.devin/mcp_config.jsonin a project) in Devin Desktop, which still reads the legacy Windsurf paths.urlis accepted in place ofserverUrl. -
Press refresh in Cascade's MCP panel.
-
When the server shows Needs authentication, select Authenticate, sign in to OpsKnight and approve.
Personal access token (alternative)
{
"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
- In Cascade's MCP panel,
opsknightno longer shows Needs authentication. - Ask Cascade "Who am I in OpsKnight, and what can you do for me?". It calls
whoamiand answers with your role, teams and enabled tools. - 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