MCP Quick Start

Before you start#

• An active AdCue subscription on Pro, Business, or Enterprise.
• An MCP-compatible AI tool such as Claude Code, Cursor, Windsurf, or OpenClaw.
• A connected Google Ads or Meta Ads account in your AdCue dashboard.

Option 1: Browser Sign-In (Recommended)#

Your AI tool opens a browser, you sign in with Google, and the client connects through OAuth 2.0 with PKCE. There are no API keys to copy.

1. 1

   Open the MCP settings

   Claude Code uses a terminal command. Cursor and Windsurf use a JSON config file.

2. 2

   Add the AdCue MCP server

   Use https://mcp.adwhiz.ai as the server.

3. 3

   Sign in with Google

   Choose the same Google account you use for AdCue and approve access.

4. 4

   Verify the connection

   Ask your client to "List my Google Ads campaigns."

For Claude Code, the fastest setup is one command:

claude mcp add adwhiz -- npx adwhiz-mcp-client@latest

Manual browser sign-in configuration:

{
  "mcpServers": {
    "adwhiz": {
      "command": "npx",
      "args": ["adwhiz-mcp-client@latest"],
      "env": {}
    }
  }
}

Option 2: API Key#

Use an API key when browser sign-in is unavailable, such as on a remote server or in CI.

1. 1

   Go to Dashboard > Integrations

   Open Settings, then Integrations.

2. 2

   Click "Create API Key"

   Give the key a name that identifies its client or environment.

3. 3

   Copy the key

   Copy the aw_ key immediately. AdCue only shows the complete value once.

4. 4

   Add it to the MCP configuration

   Send the key as a Bearer token in the Authorization header.

{
  "mcpServers": {
    "adwhiz": {
      "type": "http",
      "url": "https://mcp.adwhiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Configuration for each AI tool#

Claude Code

claude mcp add adwhiz -- npx adwhiz-mcp-client@latest

Cursor

Create or edit the MCP config file in the project root:

{
  "mcpServers": {
    "adwhiz": {
      "command": "npx",
      "args": ["adwhiz-mcp-client@latest"]
    }
  }
}

Windsurf

Use the same npx server configuration in Windsurf's global MCP config file.

{
  "mcpServers": {
    "adwhiz": {
      "command": "npx",
      "args": ["adwhiz-mcp-client@latest"]
    }
  }
}

OpenClaw

clawhub install adwhiz

Troubleshooting#

Browser sign-in window doesn't appear

Allow pop-ups for mcp.adwhiz.ai, or open the URL manually to confirm the server is reachable.

"Unauthorized" error with API key

Confirm the full aw_ key has no extra spaces and that your paid subscription is active.

"No ad accounts found" error

Connect Google Ads or Meta Ads in the AdCue dashboard, then retry the MCP request.

Still stuck?

Email support@adcue.app with the error and AI client name.