Busabase for Windsurf

Connect Windsurf to Busabase

The Cascade agent's editor; MCP servers live in a single JSON file and support OAuth per transport type.

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

Read the Windsurf Skills documentation

Busabase

Agent Skill

Give your agent this one instruction

You end up with more than a connector: the busabase skill carries the whole change-request workflow, the CLI, and the full API — available in every future session without re-pasting anything.

Asks first

Busabase Cloud or Personal Desktop — your call, before anything happens.

Connects

Signs you in and stores the credential itself. No API key to copy by hand.

Seeds a Base

Creates and fills your first Base, so the workspace is not an empty screen.

Installs the skills

busabase and busabase-app-creator become permanent, for every session after this.

Install the Busabase skills

npx skills add busabase/skills

Prefer a connector?

If you would rather wire Busabase in as MCP tools than let the agent install a skill, use the server URL below.

Windsurf MCP documentation

At a glance

Vendor: Cognition
How it connects: MCP + OAuth · Plugin / Skill
Transport: Streamable HTTP
Authentication: OAuth (dynamic registration)
Config file: ~/.config/devin/mcp_config.json (project: .devin/mcp_config.json; legacy: ~/.codeium/windsurf/mcp_config.json)

Add Busabase to ~/.config/devin/mcp_config.json (the app is now Devin Desktop; on older Windsurf installs the file was ~/.codeium/windsurf/mcp_config.json, which is still read during the transition):

{
  "mcpServers": {
    "busabase": {
      "serverUrl": "https://busabase.com/api/mcp"
    }
  }
}

Or use the MCPs icon in the top right of the Cascade panel, or Settings → Cascade → MCP Servers.

Complete OAuth in the browser when Cascade connects, then ask it to call auth_verify.

Known gotchas

Rebrand: on June 2, 2026, Windsurf became Devin Desktop — the same IDE, with settings auto-ported and the docs moved under docs.devin.ai. This record keeps the `windsurf` name and slug pending a human decision on renaming the row. New data is written to the Devin config paths (~/.config/devin/mcp_config.json); legacy Codeium paths are read only during the transition. For remote servers the config accepts a `serverUrl` or `url` field (earlier docs accepted `serverUrl` only). OAuth is available for Streamable HTTP/SSE servers in Cascade but not for stdio servers — pass credentials through env or args there. The config also supports `${env:VAR}` interpolation, so a token never has to be hardcoded.

How it compares

Connection capabilities side by side with other agents already in this directory.

Capability	Windsurf	Claude Code	Cursor
Type	AI editors	Terminal agents	AI editors
Recommended path	Agent Skill	Agent Skill	Agent Skill
How it connects	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill
Transport	Streamable HTTP	Streamable HTTP	Streamable HTTP
Authentication	OAuth (dynamic registration)	OAuth (dynamic registration)	OAuth (dynamic registration)

These stepsFrom official docsLast checked Nov 11, 2026

Written from this agent's own documentation. We have not re-run every step on a real machine, so check the linked docs if a command has changed.

Where these steps come from Official site

Let your agent do the setup

One instruction, one authorization, and every change it makes afterwards carries a message and a diff you can check or revert.

Browse every agent

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.