# Cursor

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

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

Add the Grovs MCP server to [Cursor](https://cursor.com) and the AI chat can create deep links, pull analytics, and change project settings without ever leaving the editor.

## Prerequisites

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

## One-click install

[Add the Grovs server to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=grovs&config=eyJ1cmwiOiJodHRwczovL21jcC5ncm92cy5pby9tY3AifQ==). Cursor opens and asks you to confirm the install. Then continue with [Authorize access](#manual-setup) below. The same button is on [Build with AI](https://docs.grovs.io/docs/ai#connect-the-mcp-server) and in every page's menu.

## Manual setup

### 1. Open MCP settings

In Cursor, open **Settings → Cursor Settings → MCP**.

Click **+ Add new global MCP server**.

### 2. Add the Grovs server

This opens your `~/.cursor/mcp.json` file. Add the Grovs server:

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

Save the file. Cursor will detect the new server automatically.

### 3. Authorize access

Back in Cursor, you should see the Grovs server listed. Click to enable it, and the OAuth flow will start:

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

### 4. Start using Grovs

Open Cursor's AI chat (Cmd+L / Ctrl+L) and try:

- _"Show my Grovs projects and their links"_
- _"Create a new deep link for the pricing page"_
- _"What are the analytics for the past month?"_

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

## Project-Scoped Configuration

To add Grovs only to a specific project, create a `.cursor/mcp.json` file in your project root:

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

This takes precedence over the global configuration for that project.

## Managing the Connection

To disconnect, either:

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

## Troubleshooting

### Server shows as disconnected

- Check that the URL is exactly `https://mcp.grovs.io/mcp`
- Verify your JSON is valid (no trailing commas, correct structure)
- Restart Cursor after editing the config

### Authorization window doesn't open

- Try disabling your browser's popup blocker
- Manually open `https://mcp.grovs.io/mcp` in your browser to verify connectivity

### Tools not available in chat

- Make sure the server shows a green status indicator in **Settings → MCP**
- Try toggling the server off and on again
- If the issue persists, remove and re-add the server