Installation

▤   Markdown

Install SpringBrand in ChatGPT Desktop

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

1. Install with a key (recommended)

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

Option A: Agent chat

Paste this prompt into ChatGPT Desktop. If asked for a key, open Account Settings → MCP API Keys and click View installation key or Create key.

Copyable · Paste into your Agent chat
Install or update SpringBrand CLI for ChatGPT Desktop using https://plugin.springbrand.ai/INSTALL.cli.codex.md. Configure only ChatGPT Desktop. 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, then replace {{INSTALL_KEY}} in this reference command before running it. The command as shown cannot run.

Reference example · Replace {{INSTALL_KEY}} before running
npx -y @springbrand/cli@latest connect codex --url https://connector.springbrand.ai/mcp --api-key {{INSTALL_KEY}}

In this command, codex means the Codex client inside ChatGPT Desktop.

After installation, check the report for a healthy connection and open a new ChatGPT Desktop 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 for how to clear it.

Manual OAuth command · Clear saved keys first
npx -y @springbrand/cli@latest connect codex --url https://connector.springbrand.ai/mcp

3. If the SpringBrand CLI fails: Codex 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.

This fallback uses the host’s codex command. Your Agent can run these commands, or you can run them yourself in a terminal. They are separate from the SpringBrand CLI installer above.

Add the SpringBrand Marketplace

Copyable Codex command
codex plugin marketplace add springbrand-lab/springbrand-agent-setup

Install the SpringBrand Plugin

Copyable Codex command
codex plugin add springbrand@springbrand

Connect your SpringBrand account

Copyable Codex command · Opens browser sign-in
codex mcp login springbrand

Check it in ChatGPT Desktop

Open Codex → Plugins Directory. Select the SpringBrand Marketplace and confirm SpringBrand is installed. Approve its Hook if prompted, then open a new Codex chat. The Plugin already includes the springbrand MCP entry.

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 ChatGPT Desktop session.

Next steps