Skip to content

Connect an agent

Connect Claude Code.

Add Ad Superpowers to Claude Code over HTTP, sign in with OAuth and verify a read-only marketing query.

Markdown
On this page

Use Ad Superpowers from a Claude Code terminal session to read your advertising data. The direct connection uses OAuth and does not require a plugin or API key.

Before you begin

1. Add the server

First run /mcp inside Claude Code. An existing Ad Superpowers connector from your active claude.ai subscription login may already be listed. If it is connected, continue to the result check.

Otherwise run this command in your terminal:

claude mcp add --transport http --scope user ad-superpowers \
  https://mcp.adsuperpowers.ai/v1

--scope user makes the connection available across your projects. See Claude Code's MCP reference for configuration scopes.

2. Sign in with OAuth

Start Claude Code:

claude

Run /mcp, select ad-superpowers and follow the browser sign-in. On the Ad Superpowers consent screen, select the workspace containing your connected platform and approve access.

Keep credentials out of chat messages. This OAuth setup needs no API key.

3. Check the result

Check the connection in /mcp. For a server added with the command above, you can also inspect its status from your terminal:

claude mcp list

Then ask Claude Code:

Use Ad Superpowers to show my connected workspace and list the
advertising accounts I can access. Include account names and IDs.
Do not change anything.

Confirm the workspace and expected account, then ask:

For [account name and ID], show campaign spend for the last 7 days.
Include the date range and currency. Do not change any campaigns.

Verify the account, date range and currency against the platform. A connected status alone does not prove access to the account you need.

Optional plugin

The published Ad Superpowers plugin bundles additional skills, commands and agents. Follow its installation instructions if you want those features. It also configures the MCP server, so check /mcp before adding another copy.

If something goes wrong

  • claude is not found: complete Claude Code installation, reopen the terminal and try again.
  • Authentication required: select the server in /mcp and finish browser sign-in. For a connector inherited from claude.ai, reconnect on Claude's connectors page.
  • A claude.ai connector is missing: run /status to check the active Claude login. Otherwise use the direct server setup above, subject to your organization's MCP policy.
  • Wrong workspace or missing accounts: authorize again for the intended workspace, then check its Integrations and your account permissions. Changing the dashboard workspace does not retarget this connection.
  • Trial expired or usage limit reached: check your workspace's access and usage in the dashboard. Reinstalling Claude Code does not change Ad Superpowers limits.

Next steps

Continue with example questions or the tool reference.

Official sources

Checked on 18 September 2026: Claude Code MCP reference, setup guide and the published plugin repository.

Cookies on this site

We use analytics cookies to see how the site is used. They load only if you accept, and you can change your choice at any time. Read our privacy policy.