Setting Up AdChat with Claude

Claude Desktop has native MCP support, making it the smoothest way to use AdChat. Here's exactly how to set it up.

Step 1: Get Your MCP Config

Log into your AdChat dashboard and navigate to API Keys. Copy your MCP server config. It looks like this:

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

Step 2: Open Claude Desktop Settings

1. Open Claude Desktop
2. Click the Settings icon (gear icon) in the bottom left
3. Navigate to MCP Servers (or Developer -> MCP)
4. Click Edit Config to open the JSON configuration file

Step 3: Paste Your Config

Paste the AdChat MCP config into the configuration file. If you already have other MCP servers, merge the adchat entry into your existing mcpServers object:

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

Step 4: Restart Claude Desktop

Close and reopen Claude Desktop. You should see a small MCP indicator showing that AdChat is connected.

Step 5: Start Asking Questions

Open a new conversation and ask anything about your ads:

What's wasting my budget this week?

Claude will use AdChat to pull your live ad data and give you a specific answer.

Write Access

By default, AdChat is read-only. If you want Claude to create or modify campaigns, ads, and creatives:

1. Go to your AdChat dashboard
2. Navigate to API Keys
3. Toggle Write Access on

When write access is off and Claude tries to create or update something, it will tell you to enable it with a link to your dashboard.

Tips for Best Results

• Be specific: "Compare my retargeting campaigns to prospecting campaigns this week" works better than "how are my ads?"
• Ask follow-ups: "Why is that ad's CTR dropping?" after an initial analysis
• Request actions: "Which 3 ads should I pause today and why?"
• Ask for copy: "Write 5 new headlines based on my best-performing ad"

Troubleshooting

Claude doesn't show AdChat as connected

• Make sure you saved the config file and restarted Claude Desktop
• Check that your API key is correct (find it in your AdChat dashboard under API Keys)

"Invalid API key" error

• Your API key should start with adchat_. Copy the latest one from your dashboard.
• Make sure you're using the full key, not a masked version.

"Write access is not enabled" error

• This means you tried to create or modify something. Enable write access in your dashboard under API Keys.

Slow responses

• Large ad accounts with many campaigns may take a few seconds to query. This is normal — Claude is pulling live data from Meta's API.