> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

> Connect Bizzy to Windsurf using MCP

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:

* [Windsurf](https://windsurf.com/) installed
* A Bizzy account

## 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`:

   ```json theme={null}
   {
       "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](/mcp-server/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:

| Task                  | Example 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

<AccordionGroup>
  <Accordion title="Cascade doesn't see Bizzy tools">
    **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
  </Accordion>

  <Accordion title="Authentication errors">
    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](/mcp-server/authentication) for the underlying flow.
  </Accordion>

  <Accordion title="Tool limit exceeded">
    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
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Available Tools" icon="wrench" href="/mcp-server/tools">
    Explore all available MCP tools
  </Card>

  <Card title="Authentication" icon="key" href="/mcp-server/authentication">
    Learn about MCP server authentication
  </Card>
</CardGroup>