AdAce AdsUKRUStart free
Menu
AboutPrivacy PolicyTerms of UseAI connectionsProduct websiteУкраїнськоюРусскийSign in

Documents

AdAce Ads for Claude, ChatGPT and Cursor

AdAce Ads brings supported ad platforms into one workspace for agencies and advertisers, with analytics, website tracking audits, change proposals and human approval. Over MCP the same data and actions are available in your AI client.

Claude: connect through a custom connector

Add the MCP URL using the instructions below and sign in with OAuth. No key is needed; availability depends on your account and organization.

How to do it — a 1-minute video ›

Steps for Claude

What it does

  • Read: clients, ad accounts, campaigns, performance and period comparisons, wasted spend, anomalies, search terms, GA4 by campaign tags, organic search (Search Console), website tracking audit.
  • Propose changes: budgets, campaign, ad set and ad status, negative keywords. A change waits for human approval or — if the client's policy allows — is applied within limits, for reversible actions only.
  • Create campaigns, ad sets and ads paused (no spend).
  • In Claude, ChatGPT, Cursor and VS Code — interactive cards: performance, diagnostics, account switcher, “back to chat” buttons.

Safety

  • OAuth sign-in: you choose the workspace and permissions (read; change proposals). Access can be revoked at any time.
  • Start with read. Propose is only for change proposals; execution depends on your role and the client's existing policy.
  • In the dashboard, use the approval button (an authenticator code when 2FA is enabled). In an AI chat over MCP, a current code is always required for everyone; AI cannot approve on its own. Everything is logged.

Ad platform capabilities

This matrix uses the same source as the integrations page. The date records a code and status review, not a new live test of every account.

PlatformConnectionReadingPaused creationApprovalVerification
Google Ads
Available		Official provider sign-inReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
Meta (Facebook, Instagram)
Available with limits
New accounts connect after Meta approves the app's advanced access (submitted Oct 9, 2026; expected in late October). Start with Google Ads meanwhile.		Official provider sign-inReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
Microsoft Advertising
Available		Official provider sign-inReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
LinkedIn Ads
Available
While LinkedIn reviews Standard access, changes work only in ad accounts added to the app (up to 5).		Official provider sign-inReports and account structureDrafts; developer-listed accounts only (up to 5)Dashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
Snapchat Ads
Available		Official provider sign-inReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
Reddit Ads
Available		Official provider sign-inReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
ChatGPT Ads
Available
Connects with the ad account's API key; OpenAI opens ChatGPT Ads accounts selectively.		Ad account API key; owner or admin onlyReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
Amazon Ads
In preparation
The integration is in preparation and is not offered as an available connection.		Awaiting provider accessAwaiting provider accessAwaiting provider accessAwaiting provider access The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
TikTok Ads
Available		Official provider sign-inReports and account structureCampaign, ad group and ad on pauseDashboard: Approve button, or authenticator code with 2FA. AI chat: code always. The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.
Klaviyo
In preparation
The integration is in preparation and is not offered as an available connection.		Awaiting provider accessAwaiting provider accessAwaiting provider accessAwaiting provider access The date records a review of the code and approved access status, not a live account test. Account permissions and provider restrictions still apply.

Server URL

https://ads.adace.website/mcp

How to connect

Claude

OAuth sign-in · web, desktop app, Cowork · cards in chat

  1. In Claude open Customize → Connectors → + Add → Add custom connector. Availability depends on your account and organization policy.
  2. Name: AdAce Ads; Remote MCP server URL: https://ads.adace.website/mcp. Continue and review the authentication settings.
  3. Choose OAuth sign-in. If OAuth client options appear, choose Register automatically: AdAce supports dynamic registration. No API key is needed.
  4. After Add, select Connect, sign in to AdAce Ads and choose the correct workspace and read. Add propose only if you need it.
  5. For Team/Enterprise, an authorized owner first adds the connector in Organization settings → Connectors → Add → Custom → Web; members connect individually.
  6. Enable AdAce Ads through + → Connectors in a chat and call get_started. This verifies the connection; return to AdAce Ads for the first analysis.

Official instructions · Checked: 2026-10-13

ChatGPT

OAuth sign-in · web and apps · cards in chat

  1. Open ChatGPT Plugins → + → Add custom MCP server. Creating and using it depends on your account and workspace policy.
  2. Enter the name AdAce Ads, a description and public MCP URL https://ads.adace.website/mcp; configure OAuth, review the warning and choose Create as a plugin.
  3. Sign in to AdAce Ads and choose the correct workspace and read. Never paste an API key into an ordinary chat; this is MCP, not GPT Actions/OpenAPI.
  4. Install the created plugin. In a new chat type @ and select AdAce Ads. Call get_started to check the connection, then return to AdAce Ads for the first analysis.
  5. If your account still shows Apps or Developer mode, check the official instructions below for its available flow. If custom MCP is unavailable, ask your administrator; an API key does not bypass that restriction.

Official instructions · Checked: 2026-10-13

Claude Code

OAuth sign-in · terminal

  1. Run the command below.
  2. In Claude Code type /mcp → adace-ads → Authenticate and sign in to AdAce Ads.
  3. Instead of signing in you can pass a key: add --header "Authorization: Bearer ak_…" to the command.
claude mcp add --transport http adace-ads https://ads.adace.website/mcp

Codex CLI

OAuth sign-in · terminal

  1. Run the commands below: the second one opens the AdAce Ads sign-in.
  2. Or with a key in ~/.codex/config.toml: [mcp_servers.adace-ads] url = "https://ads.adace.website/mcp", bearer_token_env_var = "ADACE_ADS_KEY".
codex mcp add adace-ads --url https://ads.adace.website/mcp
codex mcp login adace-ads

Cursor

API key · editor · cards in chat

  1. Create an API key in Settings → Developer tools.
  2. Add the snippet to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in a project, with your key.
  3. Restart Cursor; AdAce Ads appears among MCP servers.
{
  "mcpServers": {
    "adace-ads": {
      "url": "https://ads.adace.website/mcp",
      "headers": { "Authorization": "Bearer ak_…" }
    }
  }
}

VS Code (GitHub Copilot)

API key · editor · cards in chat

  1. Create an API key in Settings → Developer tools.
  2. Add the snippet to .vscode/mcp.json: VS Code asks for the key once and stores it securely.
  3. Enable AdAce Ads in Copilot agent mode.
{
  "servers": {
    "adace-ads": {
      "type": "http",
      "url": "https://ads.adace.website/mcp",
      "headers": { "Authorization": "Bearer ${input:adace-ads-key}" }
    }
  },
  "inputs": [{ "type": "promptString", "id": "adace-ads-key", "description": "AdAce Ads API key", "password": true }]
}

Windsurf / Devin Desktop

API key · editor

  1. Create an API key and store it in the ADACE_ADS_KEY environment variable.
  2. Add the snippet to mcp_config.json (Windsurf: ~/.codeium/windsurf/, Devin Desktop: ~/.config/devin/).
  3. Refresh the MCP server list in Cascade.
{
  "mcpServers": {
    "adace-ads": {
      "serverUrl": "https://ads.adace.website/mcp",
      "headers": { "Authorization": "Bearer ${env:ADACE_ADS_KEY}" }
    }
  }
}

Gemini CLI

API key · terminal

  1. Create an API key in Settings → Developer tools.
  2. Run the command below with your key (or add httpUrl and headers to settings.json).
gemini mcp add --transport http --header "Authorization: Bearer ak_…" adace-ads https://ads.adace.website/mcp

Grok

OAuth sign-in · web

  1. Open grok.com/connectors → New Connector → Custom.
  2. MCP server URL: https://ads.adace.website/mcp. Sign in to AdAce Ads, choose the workspace and permissions (read; change proposals optional).
  3. Grok Business or Enterprise: a team admin adds the connector first; availability depends on your plan.
  4. Grok uses AdAce Ads tools on its own when a question is about ads.

Manus

OAuth sign-in · web

  1. Settings → Connectors → “+ Add connectors” → the Custom MCP tab.
  2. “+ Add custom MCP” → Direct configuration: name AdAce Ads, transport HTTP, Server URL https://ads.adace.website/mcp → Save.
  3. In the sign-in window sign in to AdAce Ads and approve access.
  4. Then just give tasks, for example: “Find the client's wasted spend over the last 14 days”.

OpenClaw

OAuth sign-in · terminal

  1. Run the commands below: the first saves the server, the second prints the AdAce Ads sign-in link.
  2. Open the link, sign in and approve access: OpenClaw receives the answer on a local address.
  3. Use OAuth sign-in for OpenClaw: an API key header is not recommended for this client.
openclaw mcp set adace-ads '{"url":"https://ads.adace.website/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login adace-ads

Other MCP client

OAuth or API key · any

  1. Streamable HTTP transport, MCP protocol 2025-06-18 or 2025-03-26.
  2. Auth: OAuth 2.1 with PKCE and dynamic client registration, or an API key in the Authorization header.
  3. Clients that support MCP Apps render interactive cards.
URL: https://ads.adace.website/mcp
Authorization: Bearer ak_…
OAuth metadata: https://ads.adace.website/.well-known/oauth-authorization-server

Check

Ask: “Call get_started in AdAce Ads”, then refresh activity on the AI assistants page. A successful call verifies the connection, not a useful analysis. Open Get started for the first analysis using stored data.

Support: info@adace.website · Privacy policy · Terms of use