# Install SpringBrand in Codex CLI

Use SpringBrand tools in Codex CLI.

## 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 Codex CLI:

**Paste into your Agent chat**

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

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

To run the commands yourself, use the [terminal setup](/developers/docs/connect/codex-cli#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 Codex CLI 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 codex --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 codex --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 Codex CLI and open a new conversation. For errors or unfinished setup, see [Manual installation checks](/developers/docs/troubleshooting#terminal-output).

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