# Windsurf

> Add Grovs to Windsurf so you can manage links and pull analytics from the AI chat.

Source: https://docs.grovs.io/docs/ai/mcp/windsurf

Add the Grovs MCP server to [Windsurf](https://codeium.com/windsurf) and the AI chat can create deep links, pull analytics, and change project settings from inside the editor.

## Prerequisites

- Windsurf installed ([download here](https://codeium.com/windsurf))
- A Grovs account with at least one project

## Setup

### 1. Open MCP settings

In Windsurf, open the command palette (Cmd+Shift+P / Ctrl+Shift+P) and search for **"MCP: Configure"** or navigate to **Settings → MCP**.

### 2. Add the Grovs server

Add the Grovs server to your MCP configuration, `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "grovs": {
      "serverUrl": "https://mcp.grovs.io/mcp"
    }
  }
}
```

Save the file and restart Windsurf.

### 3. Authorize access

After restarting, Windsurf will initiate the OAuth flow:

1. A browser window opens automatically
2. Log in to your Grovs account if prompted
3. Review the permissions and click **Authorize**
4. Return to Windsurf. The server should show as connected.

### 4. Start using Grovs

Open Windsurf's AI chat and try:

- _"List my Grovs projects"_
- _"Create a deep link for the referral program"_
- _"Show top performing links this week"_

> **Note:** Self-hosting Grovs? Use your own MCP server's URL; see [Self-hosted MCP](https://docs.grovs.io/docs/ai/mcp/self-hosted).

## Managing the Connection

To disconnect, either:

- Remove the server entry from your MCP configuration and restart Windsurf
- Revoke access from the Grovs dashboard — see [Revoking access](https://docs.grovs.io/docs/ai/mcp/introduction#revoking-access)

## Troubleshooting

### Server not connecting

- Verify the URL is `https://mcp.grovs.io/mcp`
- Check your JSON syntax for errors
- Restart Windsurf after any configuration changes

### Authorization issues

- Check your browser's popup blocker settings
- Verify you can reach `https://mcp.grovs.io` from your browser

### Re-authorize after revocation

If you revoked the connection from the dashboard, restart Windsurf and it will prompt you to re-authorize.