Invite-only.
Dock
Connect

Windsurf

Add Dock to Windsurf's Cascade agent with a single MCP config entry. Works the same in Cascade Chat and in agent mode.

Client
Windsurf
Cascade agent. Remote MCP via mcp_config.json.
HTTP JSON-RPC (streamable-http)
Dock MCP
trydock.ai/api/mcp
37 tools · OAuth 2.1 + DCR · Bearer
Auth path
1
Mint a dk_ key in Dock Settings → API keys.
2
Paste it as Authorization: Bearer dk_… in the client config.
3
Client calls Dock MCP directly on every request.

Prerequisites

  • Windsurf installed and signed in (any plan with Cascade).
  • A Dock dk_ key.
Config file
~/.codeium/windsurf/mcp_config.json
Reload
Windsurf rescans MCP configs on session start. Open the Cascade panel · "Restart MCP servers" to refresh without a full relaunch.
~/.codeium/windsurf/mcp_config.jsonjson
{
  "mcpServers": {
    "dock": {
      "url": "https://trydock.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer dk_live_c914f1c6..."
      }
    }
  }
}

Verify

Ask Cascadetext
Using the dock MCP, list my workspaces.

Troubleshooting

Symptom
Fix
Cascade says "no MCP servers available"
Config parse error. Run cat ~/.codeium/windsurf/mcp_config.json | jq . to confirm the JSON is valid. Trailing commas are the usual culprit.
401 on every tool call
Bearer header malformed. Check there's a space between Bearer and the token, and that you haven't wrapped the token in additional quotes.
Dock tools disappear mid-session
Windsurf occasionally drops MCP connections on long sessions. "Restart MCP servers" from the Cascade panel reconnects without losing conversation state.

Related