# Install SpringBrand in Cursor

Use SpringBrand tools in Cursor.

## 1. Sign up or sign in

Create a [SpringBrand account](https://rapp.springbrand.ai/sign-up?src=docs_markdown), or [sign in](https://rapp.springbrand.ai/?src=docs_markdown) if you already have one.

## 2. Install SpringBrand

### Install through your Agent

Paste this prompt into a new conversation in Cursor:

**Paste into your Agent chat**

```text
Install or update SpringBrand in Cursor using https://plugin.springbrand.ai/INSTALL.md.
```

Enable **Full Access** before installation begins so your Agent can install SpringBrand and save its connection settings.

For a terminal-based setup, use the [CLI steps](/developers/docs/connect/cursor-desktop#manual-cli-install) below.

## 3. Authorize the connection

When your Agent asks to connect your account, choose an authorization method:

- API key: open [Account Settings → MCP API Keys](https://rapp.springbrand.ai/account-settings?section=mcp-api-keys&src=docs_markdown), then click **View installation key** or **Create key**. Provide the key when your Agent asks.
- Browser sign-in: ask your Agent to use browser sign-in, then complete the authorization in your browser. Keep the setup conversation open until your Agent confirms the connection.

## 4. Start using SpringBrand

When your Agent confirms that setup is complete, restart Cursor and open a new conversation.

**Check the connection**

```text
Show me the SpringBrand tools available in this conversation.
```

Once the tools are available, [try your first task](/developers/docs/quickstart#run-your-first-task). If they are missing, see [Troubleshooting](/developers/docs/troubleshooting#sign-in).

## Optional: set up from the terminal

With Node.js and npm installed, run each command separately. Continue only when both succeed:

**Install or update SpringBrand CLI**

```shell
npm install -g @springbrand/cli@latest
```

**Check the CLI installation**

```shell
sp --version
```

Connect your account with an API key or browser sign-in:

### Connect with an API key

Copy a key from [Account Settings → MCP API Keys](https://rapp.springbrand.ai/account-settings?section=mcp-api-keys&src=docs_markdown). Replace `{{INSTALL_KEY}}` below with your key, then run:

**Replace {{INSTALL_KEY}} with your key**

```shell
sp connect cursor --url https://connector.springbrand.ai/mcp --api-key {{INSTALL_KEY}} --json
```

### Or use browser sign-in

For browser sign-in (OAuth), run:

**Start browser sign-in**

```shell
sp connect cursor --url https://connector.springbrand.ai/mcp --json
```

Run the login command printed in the output, if there is one, then authorize access in your browser. Keep the terminal open until sign-in finishes.

Complete any remaining connection checks shown in the output, then restart Cursor and open a new conversation. For errors or unfinished setup, see [Manual installation checks](/developers/docs/troubleshooting#terminal-output).

## Optional: manual MCP installation in Cursor

Follow this illustrated guide to add SpringBrand directly in Cursor MCP settings.

### 1. Open Cursor MCP settings

In Cursor, open **Customize → MCPs**, then select **New MCP Server**. Choose **User** for all projects or your workspace for this project only. Cursor opens an `mcp.json` file.

![Cursor Customize MCPs page with New MCP Server and the User and Workspaces destinations visible](https://file.springbrand.ai/docs/connect/78cada4fff915521b00274c94c579b50ad9d1151e48b7df16bd0f98204d22e86.webp)
*Choose where Cursor should save the MCP connection. Click the image to enlarge.*

### 2. Add the SpringBrand server

Add this entry inside `mcpServers` and save the file. If the file is empty, paste the complete example below. Keep any other servers already in the file.

**Cursor MCP configuration**

```json
{
  "mcpServers": {
    "springbrand": {
      "url": "https://connector.springbrand.ai/mcp"
    }
  }
}
```

![Cursor workspace mcp.json with springbrand pointing to the SpringBrand MCP URL](https://file.springbrand.ai/docs/connect/9d8daae275150c04926b3e384a18c4d76cdfe6f197b28db30520abf0a32d8f28.webp)
*The saved workspace configuration in a clean test folder.*

Return to **Customize → MCPs**. If SpringBrand does not appear, run **Developer: Reload Window** from Cursor's command palette. Open the SpringBrand card and switch its source on.

### 3. Authorize and verify

For the manual MCP setup, select **Authenticate** on SpringBrand's card. Review the requested access in your browser, then approve it to finish connecting. The card may show **Needs authentication** before the browser step.

![Cursor SpringBrand MCP configuration showing the enabled source and authentication required status](https://file.springbrand.ai/docs/connect/de9385e41c3bd673e5c33f270f81d6c284a7f500cf8ac2b356a52a71bf122e26.webp)
*After enabling the source, Cursor asks you to authenticate.*

After browser sign-in finishes, open a new Cursor conversation and ask it to show the available SpringBrand tools.

## Next steps

- [Try a task](/developers/docs/quickstart#run-your-first-task): Copy a prompt to get started.
- [Troubleshooting](/developers/docs/troubleshooting): Fix installation or connection problems.