Skip to content

install-cursor.md

Latest commit

 

History

History
91 lines (59 loc) · 4.42 KB

install-cursor.md

File metadata and controls

91 lines (59 loc) · 4.42 KB
Raw

Install Browserless MCP in Cursor

Marketplace install (recommended)

Requires Cursor 3.13 or later.

  1. Open Cursor Settings → Plugins.
  2. Search for Browserless.
  3. Click Install.
  4. Click Authenticate, sign in with your Browserless account, and approve access.

Or run /add-plugin browserless in chat.

The plugin authenticates with OAuth. Cursor discovers the server's OAuth metadata, registers itself, and handles the token exchange — there is no credential to paste and nothing stored in plaintext. Re-authenticate at any time from Settings → Plugins → Browserless.

Manual install (fallback)

For Cursor builds older than 3.13, or if you prefer to manage MCP config directly, edit ~/.cursor/mcp.json and paste:

{
  "mcpServers": {
    "browserless": {
      "type": "http",
      "url": "https://mcp.browserless.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BROWSERLESS_TOKEN"
      }
    }
  }
}

Replace YOUR_BROWSERLESS_TOKEN with a token from browserless.io/signup/email. Restart Cursor, then Settings → MCP should show browserless with all 14 tools.

One-click deeplink

Cursor's deeplink format (cursor://anysphere.cursor-deeplink/mcp/install?name=...&config=...) pops an in-Cursor confirm dialog with the config pre-filled. Click this in any browser on a machine with Cursor installed:

  • Install with Bearer token — token comes through as a placeholder; replace it before approving.

Cursor registers the cursor:// URL handler the first time it launches. If clicking does nothing, open Cursor once and retry.

Cursor does not publish an HTTPS fallback (e.g. https://cursor.com/install-mcp). The cursor:// scheme is the only supported install link.

Regenerate the deeplink with node scripts/build-deeplinks.mjs if the server URL or default config changes.

Project-scoped install

Place the same JSON at <project-root>/.cursor/mcp.json to scope the server to a single project. Project config takes precedence over the global config when both are present.

Installing from source

To run this plugin from a local checkout — for development, or to test a change before it reaches the Marketplace — copy the repository into Cursor's local plugin directory:

git clone https://github.com/browserless/cursor-mcp-plugin.git ~/.cursor/plugins/local/browserless

Reload Cursor. The plugin appears under Settings → Plugins as a local plugin, with the same Authenticate button as a Marketplace install. Click it and sign in with your Browserless account.

Verifying the install

  1. Open Cursor → Settings → MCP.

  2. Find browserless in the list. It should show 14 tools — see docs/tools.md for the full list.

  3. In a chat, ask the model to use one — for example:

    Use the browserless smart scraper to fetch example.com as markdown.

  4. Cursor will prompt for permission to call the tool. Approve, and the result returns inline.

To check the hosted server independently of Cursor:

BROWSERLESS_TOKEN=your_token node scripts/verify-mcp.mjs

This runs the same initialize → tools/list handshake Cursor performs and prints the advertised tools.

Troubleshooting

Symptom Likely cause Fix
Plugin does not appear in Settings → Plugins Cursor older than 3.13 Update Cursor, or use the manual install above.
browserless shows 0 tools Not authenticated Click Authenticate under Settings → Plugins → Browserless. For manual installs, re-check the Authorization header.
Tools enumerate but every call fails with 401 Authorization revoked, or token expired Re-authenticate in Settings → Plugins → Browserless, or generate a new token at account.browserless.io.
Tools enumerate but calls hit 429 Account quota exceeded Check usage in your Browserless dashboard; upgrade plan or wait for quota reset.

Uninstall

Settings → Plugins → Browserless → Uninstall. For manual installs, remove the browserless block from ~/.cursor/mcp.json (or the project-local file) and restart Cursor.