Connect an agent
Connect your AI assistant.
Choose your client, connect Ad Superpowers and check your first read result.
On this page
Before you connect
You need an Ad Superpowers account with an active trial or subscription and access to an advertising account. Create an account if you are new, then follow the quickstart to select your workspace and connect a platform.
Your AI client's access rules are separate from your Ad Superpowers plan. Each guide explains the supported connection method and where to check client availability.
Chat assistants
- ChatGPT: install the published Ad Superpowers plugin, sign in personally and check a real report. Advanced custom setup is also covered.
- Claude Desktop or web: sign in through a remote connector.
Automation
- n8n: store an API key in a credential and test a read operation in a workflow.
Desktop, IDE and terminal
- Codex: configure a remote MCP server and sign in with OAuth, or use an API key from an environment variable.
- Claude Code: add the server and authorize it from the terminal client.
- Cursor: configure a remote server for the Agent.
- Gemini CLI: add the server and authenticate from the command line.
- Antigravity: add the server URL and an authorization header.
- Other tools: check remote MCP support and choose the client's supported authentication method.
Server address
Use this exact address when a guide asks for the remote MCP server URL:
https://mcp.adsuperpowers.ai/v1
OAuth opens Ad Superpowers sign-in in your browser. API-key clients use a key from API Keys in their connection settings. Keep keys out of chat messages and shared configuration files.
Check your first result
After connecting, ask your assistant to list the advertising accounts you can access without changing anything. Check the account name and ID, then request a report for that account with an explicit date range and currency. The quickstart result check gives a complete example.
Need help?
If no tool is available, return to your client guide's connection and permission checks. If tools work but your account is missing, check Integrations in the intended workspace and follow troubleshooting. Include your client, failed step and error message when contacting support; leave out credentials.
