Getting Started with AdChat

AdChat connects your Facebook Ads account to Claude, ChatGPT, or any MCP-compatible AI — so you can ask questions about your ads in plain English and get told what to do.

What You Need

A Facebook Ads account with admin or advertiser access
An AI tool that supports MCP (Claude Desktop, ChatGPT, Cursor, Windsurf, etc.)
An AdChat account

Quick Setup (60 Seconds)

1. Create Your Account

2. Connect Your Facebook Ads Account

Click Connect Facebook in your dashboard. You'll be asked to authorize AdChat to read your ad data.

By default, the MCP server is read-only. You can enable write access in the API Keys section of your dashboard.

3. Copy Your Connection Details

Once connected, your dashboard shows two connection options:

Server URL (easiest) — copy the URL and paste it into any "Add connector" or "Add MCP" dialog:

https://mcp.adchat.app/mcp?token=adchat_YOUR_API_KEY

JSON config — for apps that use a config file:

json

{
  "mcpServers": {
    "adchat": {
      "url": "https://mcp.adchat.app/mcp",
      "headers": {
        "Authorization": "Bearer adchat_YOUR_API_KEY"
      }
    }
  }
}

Your API key starts with adchat_ and is unique to your account. The MCP server resolves it to your Meta access token securely — your Meta token is never exposed to the AI client.

4. Paste Into Your AI Tool

Claude.ai (web): Click "Add connector" -> paste the Server URL (detailed guide)
Claude Desktop: Settings -> MCP Servers -> paste the JSON config (detailed guide)
ChatGPT: Settings -> MCP -> Add Server -> paste the Server URL (detailed guide)

5. Ask Your First Question

Open your AI tool and type something like:

"How are my ads doing this week?"
"What's wasting my budget?"
"Which ad should I scale?"

That's it. You're up and running.

Read vs Write Access

By default, your MCP connection is read-only — the AI can view your campaigns, ad sets, ads, and insights, but cannot make changes.

To enable write access (creating campaigns, updating ads, uploading images, etc.):

Go to your dashboard
Navigate to API Keys
Toggle Write Access on

Write operations include:

Creating and updating campaigns
Creating and updating ad sets
Creating and updating ads and creatives
Uploading ad images
Creating budget schedules

When write access is disabled and the AI tries a write operation, it will see a message directing you to enable it in the dashboard.

How It Works

Your AI Tool (Claude, ChatGPT, etc.)
       |
       | sends request with your adchat API key
       v
mcp.adchat.app (MCP Server)
       |
       | resolves your API key → Meta token + permissions
       | checks read/write access
       v
Meta Ads API
       |
       | returns your live ad data
       v
Response flows back to your AI tool

Every question you ask pulls live data from your Meta ad account. The AI analyzes your campaigns, ad sets, and ads in real time and gives you specific, actionable answers — not generic marketing advice.

See the Use Cases guide for inspiration on what to ask.

Claude Setup