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
https://mcp.supero.dev/mcp.Status
Add the server
~/.config/devin/mcp_config.json (on Windows, %AppData%/devin/mcp_config.json):{
"mcpServers": {
"supero": {
"serverUrl": "https://mcp.supero.dev/mcp"
}
}
}- 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
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
Use it
Ask Cascade to build an app; it calls the Supero tools.
Check the connection
build_whoami and answers with your workspace and access. Supero lists about 50 tools, with the build tools first.Your first app
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)
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.{
"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.
On this page