# Install SpringBrand in your Agent

Connect SpringBrand to your Agent and use its tools in your conversations.

## 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

Paste this prompt into a new conversation with your Agent:

**Paste into your Agent chat**

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

The prompt installs the SpringBrand CLI, the SpringBrand Skill set, and the MCP connection for your Agent.

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

## 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**. Copy the key and provide it when your Agent asks.
- Browser sign-in: ask your Agent to use browser sign-in, then complete the authorization. Keep the setup conversation open while it finishes checking the connection.

## 4. Start using SpringBrand

When setup is complete, restart your Agent and open a new conversation. Paste this prompt to check that SpringBrand tools are available:

**Check the connection**

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

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

## Supported Agents

| Agent | Setup |
| --- | --- |
| ChatGPT Desktop — Codex | [Connect](/developers/docs/connect/codex-desktop) |
| Codex CLI | [Connect](/developers/docs/connect/codex-cli) |
| Claude Desktop — Code tab | [Connect](/developers/docs/connect/claude-desktop-code) |
| Claude Code CLI | [Connect](/developers/docs/connect/claude-code-cli) |
| Cursor | [Connect](/developers/docs/connect/cursor-desktop) |
| WorkBuddy | [Connect](/developers/docs/connect/workbuddy-desktop) |
| OpenCode / Pi | [Connect from the terminal](/developers/docs/installation#preferred-cli) |
| Other agents, including Work | [Connect through MCP settings](/developers/docs/install-other-agents) |

## Optional: install from the terminal

You need Node.js and npm installed to run these commands.

Run each command separately. Continue only when both succeed:

**Install SpringBrand CLI**

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

**Check the CLI installation**

```shell
sp --version
```

Replace `<client>` in the connection command with the name from this table:

| App | Client name for the command |
| --- | --- |
| ChatGPT Desktop — Codex / Codex CLI | `codex` |
| Claude Desktop — Code tab / Claude Code CLI | `claude-code` |
| Cursor | `cursor` |
| WorkBuddy | `workbuddy-ai` |
| OpenCode | `opencode` |
| Pi | `pi` |

To connect with an API key, replace `<client>` and `{{INSTALL_KEY}}` before running:

**API key · Replace both placeholders**

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

For browser sign-in, replace `<client>` and run:

**Browser sign-in · Replace <client>**

```shell
sp connect <client> --url https://connector.springbrand.ai/mcp --json
```

Follow the instructions in the output to finish authorization and confirm the connection. Then restart your Agent and open a new conversation. If setup is incomplete or fails, see [Manual installation checks](/developers/docs/troubleshooting#terminal-output).