Early access

Apply

Documentation
Developers/MCP/Connect Windsurf (Devin Desktop)

Connect Windsurf (Devin Desktop)

Add Supero to Windsurf / Devin Desktop with serverUrl https://mcp.supero.dev/mcp in mcp_config.json, sign in in the browser, and build Supero apps from Cascade.

  • Windsurf
  • Devin Desktop
  • Cascade
  • MCP
  • OAuth
  • mcp_config.json

Overview

Windsurf (now Devin Desktop) connects to remote MCP servers over Streamable HTTP and signs in with OAuth. Point it at https://mcp.supero.dev/mcp.

Status

Supero accepts every sign-in shape Windsurf documents (a local callback on any port, all scopes, with or without a resource), checked against the live server and in Supero's tests on 2026-11-13. Windsurf does not publish its exact registration, so if sign-in fails, use the API key option below and tell us at app.supero.dev.

Add the server

For the Cascade agent, add Supero to ~/.config/devin/mcp_config.json (on Windows, %AppData%/devin/mcp_config.json):
json
{
  "mcpServers": {
    "supero": {
      "serverUrl": "https://mcp.supero.dev/mcp"
    }
  }
}
  1. 1

    Sign in

    When Windsurf connects to the server it opens your browser at Supero. Sign in, or create an account. If the server later shows Needs authentication (the sign-in expired), authenticate it again from the MCP list.

  2. 2

    Allow

    The approval page says "Supero hasn't verified this app", followed by the local address the tool uses (such as 127.0.0.1 or localhost). That is normal. Supero can't check a program on your computer, so it asks you to confirm you started the sign-in. Pick where it may work (access options). Click Allow.

  3. 3

    Use it

    Ask Cascade to build an app; it calls the Supero tools.

Check the connection

Ask the assistant: "Use Supero and tell me who I am connected as." It calls build_whoami and answers with your workspace and access. Supero lists about 50 tools, with the build tools first.

Your first app

text
Build a booking app for a dog grooming salon: customers pick a groomer and a time slot and pay a deposit; staff see the day's appointments.

Use an API key instead (optional)

Only for CI pipelines, scripts, and machines without a browser. The tools are the same. Use https://api.supero.dev/mcp/v1/messages with the key in the X-API-Key header; Two addresses, one set of tools explains why there are two addresses, and Use an API key instead covers creating a key in the console (Build via MCP). A project key can read, change and delete records in every tenant of its project. Never commit a key.
json
{
  "mcpServers": {
    "supero": {
      "serverUrl": "https://api.supero.dev/mcp/v1/messages",
      "headers": { "X-API-Key": "${env:SUPERO_API_KEY}" }
    }
  }
}

Troubleshooting

  • Use the URL exactly as https://mcp.supero.dev/mcp, with no trailing slash. Some clients compare it with the server's published resource and stop if they differ.
  • "Too many registrations" (HTTP 429). Each new sign-in registers the tool with Supero. One IP address may register 10 times an hour (an IPv6 /64 network 20 times), and there is an overall hourly limit. Wait, then try again. A sign-in that already works is not affected.
  • Signed in as the wrong account: remove the server, add it again, and use Switch account on the approval page.
  • To disconnect, use Disconnect at app.supero.dev/oauth/connections, then remove the server from the tool's config.
  • Changing your Supero password or email ends every assistant connection you signed in. Your projects and apps are not affected; sign in again from the tool.
  • Cascade can use at most 100 tools across all servers at once. Supero lists about 50 when you sign in and about 70 with an API key. If you hit the limit, turn off tools you don't need.