Recipe
Windsurf and Devin Desktop.
Windsurf is now Devin Desktop. These steps add Stable Baseline to its Cascade agent: one config file, then sign in from the browser.
1. Add the server
In the Cascade panel, open the actions menu (the three dots at the top right), go to MCPs and open the MCP config file. It lives at:
| System | File |
|---|---|
| macOS and Linux | ~/.config/devin/mcp_config.json |
| Windows | %APPDATA%\devin\mcp_config.json |
Add Stable Baseline:
mcp_config.jsonjson
{
"mcpServers": {
"sb": {
"serverUrl": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp"
}
}
}Cascade asks you to sign in when it first connects.
Or use an API key
Create one under Organisation settings, Developers, API keys. See Setup. Then refer to it through an environment variable:
mcp_config.jsonjson
{
"mcpServers": {
"sb": {
"serverUrl": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
"headers": {
"Authorization": "Bearer ${env:STABLE_BASELINE_API_KEY}"
}
}
}
}Keep the key out of your files
Put your API key in the
STABLE_BASELINE_API_KEY environment variable or your tool's secret store, and refer to it from the config as shown. Never paste the key itself into a file you commit or share. Signing in with OAuth avoids keys altogether.Cascade's tool limit
Cascade can use up to 100 tools at a time across all its servers. If you have several, turn off the Stable Baseline tools you do not need in the MCPs settings.
2. Document the repository
Ask Cascade in plain words:
prompt
Document this repository in my Stable Baseline project. Use the Stable Baseline tools to find my workspace and project (do not create them), read the code, design a structure of folders, documents and diagrams, write them, and add a Stable Baseline section to AGENTS.md so you keep the docs current as the code changes.
It follows the same steps as the sb-setup prompt:
Checks the connection
It confirms it can reach Stable Baseline with your key or sign-in.Finds your workspace and project
It never creates them: if it cannot find the ones you mean, it asks you to create them in the app first.Remembers them
It writes their ids to .sb/config.json, and keeps .sb/ out of git.Checks for existing docs
If the project already has documentation, it asks whether to add to it, replace it, or stop.Reads the repository
It works through the code to understand what is there.Designs a structure
Folders and documents that fit this repository, not a fixed template.Writes it
Folders, documents, and the diagrams each document needs.Updates AGENTS.md
It adds a Stable Baseline section with rules for keeping the docs current, and keeps everything else in the file.Sums up
It tells you what it created.
3. Try it
- “What changed in the checkout service this week? Update its document.”
- “Add a sequence diagram of the sign-in flow to the authentication document.”
- “Create a plan for the database migration with three phases.”
- “Log a risk in the work register: the payment provider's rate limits.”