By Ira Bodnar, Ryze AI · Updated · Steps re-tested on claude.ai, Claude Desktop and Claude Code
Quick answer
Claude has no built-in Meta Ads integration. You connect it through an MCP connector: sign in with Facebook inside Ryze AI to authorize the ad account, paste https://connector.get-ryze.ai/mcp into Claude's Add custom connector dialog, click Connect and start a new chat. Two minutes, no Meta developer app, no access token, no app review. The same connector also works in Claude Desktop, Claude Code and ChatGPT, and covers Google Ads, GA4 and Shopify.
- Free Ryze AI account, Facebook sign-in on Meta Ads
- Settings, Connectors, Add custom connector in Claude
- Paste the URL, Add, Connect, Allow
- New chat, ask your first question
Before you start
- A Claude account. Custom connectors are available on Free, Pro, Max, Team and Enterprise; Free is limited to one custom connector. On Team and Enterprise an organization owner adds the connector first.
- Access to the Meta ad account. Your Facebook profile needs at least Advertiser access on the ad account in Business Manager (Business Portfolio). Agencies use partner access on the client's account; no developer app or system-user token is involved.
- A free Ryze AI workspace. This is where Meta Ads is authorized and where write approvals live. Connecting is free; you only pay if you switch on Paid Ads Autopilot later.
How to connect Claude to Meta Ads in claude.ai
Six clicks in two apps. Screenshots are from a real account; the connector URL is the same for every user.
Create a free Ryze AI account and connect Meta Ads
Sign up at get-ryze.ai, open the workspace and click Connect on Meta Ads. Facebook's login dialog opens; sign in, keep every ad account you want Claude to see ticked, and click Continue. Ryze lists the ad accounts your profile can access, including client accounts shared through Business Manager.
Copy the connector URL
On the Ryze home screen the connector address is shown under Connect Claude to your marketing data. It is the same for everyone: https://connector.get-ryze.ai/mcp. Click Copy link.
Open Connectors in Claude
In claude.ai click your initials in the bottom-left corner, open Settings, then Connectors. Newer builds show a Customize page instead; Connectors is the second tab there. Click Add custom connector.
Paste the URL and add the connector
Name it Ryze AI, paste https://connector.get-ryze.ai/mcp into the Remote MCP server URL field and click Add. Leave Advanced settings empty; there is no app ID, app secret or access token to enter.
Click Connect and authorize
The connector appears in your list with a Connect button. Click it, sign in to Ryze, pick the workspace that holds your Meta ad account and click Allow. Claude now lists the Meta Ads tools under the connector.
Start a new chat and ask your first question
Connectors only appear in chats started after you add them, so open a new chat. Ask: Which ad sets have frequency above 2.5 and a CTR drop of more than 20% week over week? Claude pulls the answer from your live account.
Prefer to skip the copy-paste? The Ryze AI listing in the Claude directory adds the same connector with one click. Either way, the connector FAQ covers every error message we have seen.
Claude Desktop
Connectors belong to your Claude account, not the device, so anything you add on claude.ai is already there in the desktop app. To add it from the app instead: click your name in the bottom-left corner, open Settings, choose Connectors, click Add custom connector, paste the URL and click Add, then Connect. The desktop app also has a separate Developer section for local MCP servers configured in claude_desktop_config.json; you do not need it for a hosted connector.
Claude Code
Claude Code reads MCP servers from the command line. One command registers the connector for every project on your machine:
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userThen open Claude Code, type /mcp, pick ryze and finish the sign-in in the browser tab that opens. Use --scope project instead if the whole team should get it from a shared .mcp.json. claude mcp list confirms the server is connected. Cursor and ChatGPT take the same URL; see the Meta Ads MCP page for those clients.
What Claude Code adds over the chat apps: it can save the creative-fatigue report to a file, run it on a schedule, and combine the Meta Ads tools with your codebase, for example rebuilding landing pages for the ads that are winning. The Claude Code marketing workflows guide has worked examples.
Ryze connector vs Meta’s official MCP vs CSV upload
Three ways exist to get Meta Ads data in front of Claude. They differ on setup, freshness and whether Claude can act.
| Method | Setup | Read / write | Works in | Best for |
|---|---|---|---|---|
| Ryze AI connector (hosted MCP) | Facebook sign-in, paste one URL. About 2 minutes. | 12 Meta Ads tools: 9 read including raw Insights, Graph reads and Ad Library search, 3 approval-gated writes | claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor | Marketers and agencies who want to analyze and fix accounts from chat |
| Meta’s official MCP server and CLI | Install the CLI, log in with Facebook, edit Claude Desktop’s config file. About 10 minutes. | Read and manage campaigns through Meta’s supported automation path | Claude Desktop and Claude Code via local config; not claude.ai web | Teams who want Meta’s own supported server and do not mind the config edit |
| CSV export uploaded to the chat | Download a report from Ads Manager, attach the file | Read-only, frozen at export time | Any Claude surface | One-off analysis when you cannot authorize a connector |
Meta’s official server is the right pick if you want Meta’s own supported path and you work in Claude Desktop; the install is covered step by step in the Meta MCP for Claude guide. It does not run in claude.ai web, and every client account means another config edit. The Claude connectors for Meta Ads compared ranks the hosted options.
Alternative: upload a Meta Ads CSV to Claude
When you cannot authorize a connector, a manual export still gets you a useful first audit.
- In Ads Manager open the Campaigns, Ad sets or Ads tab and set the date range to the last 30 days.
- Customize columns: amount spent, results, cost per result, frequency, CTR (link), CPM and purchase ROAS if you track it.
- Click Reports, then Export table data, and choose .csv. Export one ad account at a time.
- In Claude click the plus button in the chat box, attach the file and ask: Which ads have frequency above 2.5 and a falling CTR, and which should be refreshed first?
Limits: the data is stale as soon as you export, files over a few thousand rows get truncated, and Claude cannot apply anything back to the account. Use it to decide whether the live connection is worth the two minutes.
First prompts to run once Claude is connected
Copy these as written. Each one maps to a tool the connector exposes, so Claude answers from account data rather than guessing.
Agency and freelancer
- List every ad account I can access with 7-day spend, results, cost per result and the change versus the prior 7 days, sorted by biggest CPA increase.
- For the Acme account, find ad sets with frequency above 2.5 and CTR down more than 20% week over week, and rank them by wasted spend.
- Write a client-ready summary of last month: spend, results, cost per result, the three ads that carried the account, the three to retire, and what we test next.
B2B and lead gen
- Pull the last 30 days of leads from every lead form with cost per lead by form and placement, and flag forms with a rising cost per lead.
- Which audiences overlap by more than 30% across my active ad sets, and how much spend is competing against itself?
- Check learning phase: which ad sets are stuck in learning or learning limited, and what budget change would get them out?
Ecommerce
- Show purchase ROAS by campaign for Advantage+ Shopping versus manual campaigns over the last 30 days and flag anything under 1.5x.
- Search the Ad Library for my top three competitors and summarize the hooks and formats they have been running for more than 30 days.
- Compare Meta Ads and Google Ads CPA for the last 14 days and estimate how much of the overlap is the same customer counted twice.
The Claude skills for Meta Ads page turns the checks above into reusable skills, and the Meta creative fatigue workflow shows the complete first-session flow.
Troubleshooting
- Connector missing from the chat
- Connectors only appear in chats started after they were added. Open a new chat. On Team and Enterprise plans an owner has to enable the connector in organization settings first.
- Authorization with the MCP server failed
- Remove the Ryze connector from Settings, Connectors, add it again with https://connector.get-ryze.ai/mcp and start a fresh chat. Connector URLs ending in run.app are retired.
- An ad account is missing in Ryze
- The Facebook profile you signed in with does not have access to it, or it was unticked in the login dialog. Grant access in Business Manager, then reconnect Meta Ads in the Ryze workspace and tick every account.
- Claude cannot see my Meta data
- Check that Meta Ads shows Connected in the Ryze workspace under Integrations, and that Claude is connected to that same workspace. Each authorization is tied to one workspace.
- Numbers differ from Ads Manager
- Ask Claude which attribution window, date range and time zone it used. The Insights API defaults to the account's attribution setting; Ads Manager views may use a different comparison window.
- Something went wrong, tap retry
- Retry once and start a new chat. If it persists, the Ryze workspace may have an overdue subscription or an empty credit balance.
Google Ads, GA4 and the rest
The same connector URL covers Google Ads, Google Analytics 4, Search Console, Shopify, TikTok Ads and more. Connect each platform once in the Ryze workspace and Claude can compare them in one chat, for example deduplicated CPA across Meta and Google. Google has its own steps around manager accounts and the official read-only MCP, covered in how to connect Claude to Google Ads.
Frequently asked questions
How do I connect Claude to Meta Ads?
Create a free Ryze AI account, connect Meta Ads with a Facebook sign-in, then in claude.ai open Settings, Connectors, Add custom connector and paste https://connector.get-ryze.ai/mcp. Click Connect, authorize, and start a new chat. The whole process takes about two minutes and needs no developer app, access token or app review.
Can Claude connect to Facebook Ads Manager directly?
Not on its own. Claude has no built-in Meta Ads connector, so an MCP server sits in between. Options are a hosted connector such as Ryze AI, Meta's official MCP server and CLI that you install locally for Claude Desktop, or uploading CSV exports from Ads Manager into the chat.
Which Claude plan do I need for a custom connector?
Anthropic's help center lists custom connectors as available on Free, Pro, Max, Team and Enterprise plans, with Free limited to one custom connector. On Team and Enterprise an organization owner has to add the connector first, then each member clicks Connect. Checked September 2026.
Does this work in Claude Desktop and Claude Code as well as claude.ai?
Yes. Connectors are tied to your Claude account, so a connector added on claude.ai shows up in the Claude Desktop app too. Claude Code uses the command line: run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user, then type /mcp to authenticate in the browser.
What is the difference between the Ryze connector and Meta's official MCP?
Meta's official server is installed through its CLI and a Claude Desktop config-file edit, about ten minutes per machine, and does not run in claude.ai web. The Ryze connector is hosted, needs only a Facebook sign-in, runs in every Claude surface and ChatGPT, and exposes 12 Meta Ads tools including approval-gated writes.
Can Claude change my Meta campaigns, or only read them?
Through the Ryze connector Claude can read insights, creatives, lead forms and the Ad Library, and also propose changes through Graph API writes: pause or enable ad sets, adjust budgets, upload creative. Every write is held for your approval by default, so nothing changes in Ads Manager until you confirm it in the chat.
Will connecting an AI tool get my Meta ad account flagged or banned?
No. Access goes through Facebook's own OAuth login and the Marketing API, the same path Meta's official MCP uses, so it is a supported integration rather than browser automation. You can revoke access at any time under Business Integrations in your Facebook settings or from the Ryze workspace.
Does the connector work with Business Manager and agency client accounts?
Yes. Ryze lists every ad account your Facebook profile can access, including client accounts shared through Business Manager partner access. Tick them all in the login dialog and Claude can query any of them by name in one chat, or create one Ryze workspace per client for separation.
Why does the Ryze connector not show up in my chat?
Connectors are only available in conversations started after you add them. Open a new chat. If the tools still do not appear, remove the Ryze connector in Settings, Connectors, add it again with the current URL and start another new chat. Older connector URLs ending in run.app are retired.
Can I upload an Ads Manager CSV to Claude instead of connecting?
Yes. In Ads Manager choose the columns you need, click Reports, then Export table data as a CSV, and attach the file to a Claude chat with your question. It works for one-off analysis, but the data is stale the moment you export it and Claude cannot apply any change back to the account.
How much does it cost to connect Claude to Meta Ads?
Connecting through Ryze AI is free; you pay only for your Claude plan. The paid-ads plan at $89 per month adds Paid Ads Autopilot, where Ryze runs approved optimizations for you on a schedule instead of waiting for you to ask in chat.
Can I connect Google Ads, GA4 and Shopify in the same chat?
Yes. The same connector URL covers Google Ads, Google Analytics 4, Search Console, Shopify, TikTok Ads and more. Connect each platform in the Ryze workspace once and Claude can compare them in one conversation, for example deduplicated CPA across Meta and Google.
What should I ask Claude first after connecting Meta Ads?
Start with creative fatigue: ad sets with frequency above 2.5 and falling CTR, ads carrying most of the spend, and audiences that overlap. Then ask for a weekly summary prompt you can reuse every Monday. Both give you a concrete list of fixes in the first session.
