> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.promo.ly/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connect Claude Code

These steps connect Claude Code to your Promoly account. Last tested on **October 11, 2026** with Claude Code 2.1.285.

Connected agents are in an invite-only beta. See [Connect an AI coding agent](https://support.promo.ly/en/article/connect-an-ai-coding-agent-1udge2h/) for what an agent can and can't do.

## Add the Promoly server

Run this in your terminal:

```sh
claude mcp add --transport http --scope user promoly https://api.promo.ly/mcp
```

That's all Claude Code needs. If you added Promoly earlier with `--client-id promoly-claude-code` and `--callback-port 18432`, that setup keeps working.

## Sign in

```sh
claude mcp login promoly
```

Your browser opens Promoly. Sign in, choose the account, tick the access you want to allow, and click **Allow access**. The terminal confirms when Claude Code is connected.

You can also sign in from inside Claude Code: type `/mcp`, pick **promoly**, then choose **Authenticate**.

## Check the connection

Start Claude Code and paste:

```text
Use the promoly tools to show which Promoly account you're connected to, then list my five most recent campaigns.
```

## Sign out or remove it

```sh
claude mcp logout promoly
claude mcp remove promoly --scope user
```

Signing out on your computer doesn't end the connection on Promoly's side. To do that, disconnect it under **Profile** → **Manage connected apps** in the dashboard.

## If something goes wrong

- **`/mcp` shows promoly as needing authentication.** The connection was disconnected or has ended. Run `claude mcp login promoly`.
- **You're on a remote machine over SSH.** `claude mcp login promoly --no-browser` prints the sign-in link. Open it on any computer, then paste the address the browser lands on back into the terminal.