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

# Windsurf

> Connect VexiData to Windsurf so Cascade can query your databases while you code.

## Prerequisites

* [Windsurf](https://codeium.com/windsurf) editor installed
* A [VexiData](https://vexidata.com) account with at least one connected database

## Connect VexiData to Windsurf

<Steps>
  <Step title="Copy your MCP Server URL">
    Your MCP Server URL is:

    ```
    https://vexidata.com/mcp
    ```

    You can also find this in **Settings** > **AI Integrations** in your [VexiData AI Integrations](https://vexidata.com/settings/ai-integrations) page.
  </Step>

  <Step title="Add VexiData as an MCP server in Windsurf">
    1. Open Windsurf
    2. Go to **Settings** > **Cascade** > **MCP**
    3. Click **Add Server**
    4. Enter a name (e.g., "VexiData")
    5. Paste your MCP Server URL
    6. Click **Save**
  </Step>

  <Step title="Authorize the connection">
    Windsurf will open a browser window to VexiData for authorization. Review the requested permissions and click **Approve**.

    Once authorized, you'll see VexiData listed as a connected MCP server in Windsurf's settings.
  </Step>

  <Step title="Start querying your data">
    In Windsurf's Cascade chat, you can now reference your database. For example:

    * *"What does the schema look like for the products table?"*
    * *"Write a query to find duplicate email addresses"*
    * *"Generate an API endpoint that returns orders by status"*

    Cascade will use VexiData to access your schema and run queries against your connected databases.
  </Step>
</Steps>

## Manual configuration

You can also add VexiData directly to your Windsurf MCP configuration file (`~/.codeium/windsurf/mcp_config.json`):

```json theme={null}
{
  "mcpServers": {
    "vexidata": {
      "serverUrl": "https://vexidata.com/mcp"
    }
  }
}
```

Restart Windsurf after saving the file.

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP server shows as disconnected">
    * Check that your VexiData account has an active session — try logging in at [vexidata.com](https://vexidata.com)
    * Verify the MCP Server URL is correct in Windsurf settings
    * Try removing and re-adding the MCP server
  </Accordion>

  <Accordion title="Authorization window doesn't open">
    * Make sure your default browser is set and working
    * Try adding VexiData manually via the config file method
    * Check that no browser extensions are blocking the redirect
  </Accordion>

  <Accordion title="Cascade can't access my tables">
    * Verify you have at least one database connected in VexiData under **Data Sources**
    * Check that your database connection is active and the schema has been analyzed
    * Try asking specifically about a table name to confirm the connection is working
  </Accordion>
</AccordionGroup>