Skip to main content
This guide walks you through connecting the Bizzy MCP server to Windsurf, allowing Cascade (Windsurf’s AI) to access your contacts, messages, and other business data.

​
Prerequisites

Before you begin, ensure you have:

​
Connect

Windsurf supports streamable-HTTP MCP servers and runs the OAuth 2.1 + PKCE handshake for you.
  1. Add Bizzy to ~/.codeium/windsurf/mcp_config.json: 
    {
    "mcpServers": {
        "bizzy": {
            "serverUrl": "https://mcp.bizzyco.ai/mcp"
        }
    }
}
    Or, from Windsurf, open the Command Palette with Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux), run Open Windsurf Settings, navigate to Cascade → Plugins, and add Bizzy as a custom MCP plugin pointing at https://mcp.bizzyco.ai/mcp — Windsurf writes the same JSON.
  2. Restart Windsurf.
  3. The first time Cascade uses a Bizzy tool — or when you click Connect in the plugin entry — Windsurf opens a browser tab for OAuth.
  4. Sign in to Bizzy and approve the consent screen. Cascade then has access to the tools you granted.
See Authentication for details on the OAuth handshake.

​
Verification

To verify the connection is working:
  1. Open Cascade (Windsurf’s AI assistant)
  2. Ask: “What Bizzy tools do you have access to?”
  3. Cascade should list the available tools

​
Example Usage

Once connected, you can use Bizzy tools in Cascade:
TaskExample Prompt
Find contact info”Look up contact information for our vendor”
Search communications”Find messages mentioning the deployment issue”
View thread”Show the full conversation thread with support”

​
Troubleshooting

Possible causes:
  • Configuration file in wrong location
  • Invalid JSON syntax
  • Windsurf not restarted
Solutions:
  1. Verify the file is at ~/.codeium/windsurf/mcp_config.json
  2. Validate your JSON syntax
  3. Completely restart Windsurf
If the OAuth browser tab fails to load, check that you can reach https://mcp.bizzyco.ai/.well-known/oauth-protected-resource from your machine.If Cascade shows a stale token error, remove the bizzy entry from ~/.codeium/windsurf/mcp_config.json, restart Windsurf, and re-add it — that forces a fresh Dynamic Client Registration.See Authentication for the underlying flow.
Cascade has a limit of 100 total tools. If you have many MCP servers configured, you may need to disable some tools.Solution:
  1. Open Windsurf Settings, navigate to Cascade → Plugins
  2. Navigate to the Tools tab
  3. Toggle off tools you don’t need

​
Next Steps

Available Tools

Explore all available MCP tools

Authentication

Learn about MCP server authentication
Last modified on May 30, 2026