MCP

Windsurf

Add Gummble MCP to Windsurf in one config file.

Windsurf has first-class support for Streamable HTTP MCP servers with OAuth 2.1, so the config is one line.

1. Edit the MCP config

Open ~/.codeium/windsurf/mcp_config.json (or the Plugins panel in Cascade → Edit JSON) and add:

{
  "mcpServers": {
    "gummble": {
      "serverUrl": "https://mcp.gummble.com/mcp"
    }
  }
}

2. Reload Windsurf

Cmd+Shift+PReload Window.

3. Sign in

The first time Cascade calls a Gummble tool, Windsurf opens Gummble OAuth in your browser. Sign in, approve the consent screen, and the tool call resumes.

You'll see the consent screen once. After that the token is cached inside Windsurf's MCP credential store.

4. Verify

Ask Cascade:

List 3 apps from the Gummble library

You should see Cascade invoke gummble_search_apps and render the result.

Troubleshooting

For the full checklist, see MCP Troubleshooting.

The browser opens but the consent page is blank. Make sure third-party cookies are allowed for api.gummble.com. The gummble_session cookie is HttpOnly + SameSite=Lax and only used during the OAuth dance.

tools/list returns empty. Your token might be missing the mcp:tools scope. Sign out from Windsurf MCP and re-authorize — the consent screen will request the right scopes by default.