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 for what an agent can and can't do.

Add the Promoly server

Run this in your terminal:

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.

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:

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

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.

Updated on: 12/10/2026

Was this article helpful?

Thank you!