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.
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
- Claude Code installed and signed in. Use Anthropic's setup guide if needed.
- An Ad Superpowers account with an active trial or paid access; see pricing.
- A platform connected in your intended workspace under Integrations.
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
claudeis not found: complete Claude Code installation, reopen the terminal and try again.- Authentication required: select the server in
/mcpand finish browser sign-in. For a connector inherited from claude.ai, reconnect on Claude's connectors page. - A claude.ai connector is missing: run
/statusto 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.
