# Install SpringBrand in Cursor

Install SpringBrand in Cursor with a key, OAuth, or the client Plugin.

## 1. Install with a key (recommended)

Choose one option to install SpringBrand CLI for Cursor: send the prompt in your Agent chat, or run the command yourself.

### Option A: Agent chat

Paste this prompt into Cursor. If asked for a key, open [Account Settings → MCP API Keys](https://rapp.springbrand.ai/account-settings?section=mcp-api-keys) and click **View installation key** or **Create key**.

**Copyable · Paste into your Agent chat**

```text
Install or update SpringBrand CLI for Cursor using https://plugin.springbrand.ai/INSTALL.cli.cursor.md. Configure only Cursor. If you need an installation key, ask me for it.
```

### Option B: Run the command yourself

Get a key from [Account Settings → MCP API Keys](https://rapp.springbrand.ai/account-settings?section=mcp-api-keys), then replace `{{INSTALL_KEY}}` in this reference command before running it. The command as shown cannot run.

**Reference example · Replace {{INSTALL_KEY}} before running**

```shell
npx -y @springbrand/cli@latest connect cursor --url https://connector.springbrand.ai/mcp --api-key {{INSTALL_KEY}}
```

After installation, check the report for a healthy connection and open a new Cursor session if asked.

## 2. If you cannot use a key: OAuth

If you cannot use a key, ask your Agent to follow the OAuth instructions in the installation guide. You can also run the command below yourself after clearing any saved key and `SPRINGBRAND_API_KEY`, then finish browser sign-in. A saved key can prevent OAuth from starting; see the [production guide](https://plugin.springbrand.ai/INSTALL.md) for how to clear it.

**Manual OAuth command · Clear saved keys first**

```shell
npx -y @springbrand/cli@latest connect cursor --url https://connector.springbrand.ai/mcp
```

## 3. If the SpringBrand CLI fails: Cursor Marketplace Plugin

Use the host’s native Plugin path only if the SpringBrand CLI installer cannot run or reports an installation failure. Check for an existing SpringBrand Plugin or MCP entry before adding another.

1. Import the Marketplace

   Open **Customize → Browse Marketplace → Add Marketplace → Import from GitHub** and enter `springbrand-lab/springbrand-agent-setup`.

2. Install and authorize

   Install and enable the SpringBrand Plugin. Complete Cursor’s native browser OAuth for the bundled `springbrand` MCP entry.

3. Open a new task

   Restart Cursor if the new components are not visible, then open a new task. Do not add a second global SpringBrand MCP server.

## Authorize and verify

For CLI setup, check the CLI report. For the Plugin, follow its sign-in and connection checks above. Then open a new Cursor session.

## Next steps

- [Run your first task](/developers/docs/quickstart#run-your-first-task): Send a first prompt and see SpringBrand tools in action.
- [Connect another agent](/developers/docs/connect/codex-desktop): Install SpringBrand in ChatGPT Desktop and more.