Docs

Windsurf

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

Add the Grovs MCP server to Windsurf and the AI chat can create deep links, pull analytics, and change project settings from inside the editor.

Prerequisites

  • Windsurf installed (download here)
  • 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:

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"

If you are self-hosting Grovs, replace mcp.grovs.io with your MCP subdomain.

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

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.