How to Integrate Meta (Facebook & Instagram) Ads with Claude AI Using MCP: A Complete Step-by-Step Guide

Updated: October 31, 2026 | Beginner to Intermediate | Technical Tutorial

SEO Title: Meta Ads Integration with Claude AI Using MCP

Meta Description: Learn how to connect Meta Facebook and Instagram Ads to Claude AI using MCP. Follow setup steps for Claude Web, Desktop, and Code with practical examples.

URL Slug: meta-ads-integration-with-claude-ai-mcp

Primary Keyword: Meta Ads Integration with Claude

1. Introduction

Imagine managing your Facebook and Instagram advertising campaigns simply by having a conversation with an AI assistant.

Instead of opening Meta Ads Manager, navigating different dashboards, applying filters, exporting campaign data, and calculating advertising performance manually, you could ask:

Show me all my Facebook and Instagram advertising campaigns from the last 30 days. Compare spending, clicks, cost per lead, and return on advertising spend. Identify which campaigns need attention.

Claude AI can retrieve the relevant advertising information through a connected tool, organize the results, analyze performance, and explain potential improvements in understandable language.

This is possible through Meta Ads AI Connectors, powered by the Model Context Protocol (MCP).

On April 29, 2026, Meta introduced Ads AI Connectors in open beta, allowing eligible advertisers to connect their advertising accounts to external AI agents. Meta subsequently expanded the integration with developer-app support and account-level controls. Digiday+2

Official Meta Ads MCP endpoint

This is Meta’s hosted remote MCP endpoint, not a third-party MCP server. Independent endpoint monitoring also reported it reachable on October 31, 2026. MartechDB+1

What you will learn

By completing this tutorial, you will understand how to prepare your Meta advertising account, connect it to Claude Web or Claude Desktop, configure the connection in Claude Code, complete authentication, retrieve campaign information, calculate performance metrics, troubleshoot common failures, and introduce safeguards before allowing AI to modify live campaigns.

We will also explore practical marketing workflows, including advertising performance reports, budget analysis, creative comparisons, and campaign optimization.

Important: Meta Ads MCP remained a beta integration in the sources reviewed for this guide. The tools and permissions available to you can depend on your Meta account, business portfolio, organization policies, and the MCP client’s capabilities. A successful connection does not guarantee that every advertised operation is available.

2. Understanding the Technologies

Before configuring anything, let’s understand the three important technologies involved.

2.1 What is Meta Ads?

Meta Ads Manager is Meta’s advertising management platform for creating, running, measuring, and optimizing paid advertising campaigns across Facebook, Instagram, and other eligible Meta placements.

Its basic advertising structure has three levels:

A business might run several campaigns simultaneously, making it difficult to compare advertising results manually.

2.2 What is Claude AI?

Claude is an AI assistant developed by Anthropic. It can understand natural-language instructions, analyze information, write reports, and use external tools through supported integrations.

In this tutorial, Claude acts as the intelligent interface for your Meta advertising data.

It does not automatically know your campaign performance. It must first receive authorized access to the relevant information through a connector.

2.3 What is Model Context Protocol (MCP)?

MCP is an open protocol that standardizes communication between AI applications and external tools or data sources.

Think of it as a common connection method that lets AI applications communicate with business systems without requiring a completely different integration architecture for every service.

There are three basic components:

The protocol allows an assistant to discover which tools a server provides and invoke them using structured requests.

Anthropic documents MCP as an open standard for connecting AI applications with tools and information sources. Anthropic

2.4 Why did Meta introduce an MCP server?

Traditionally, accessing advertising information programmatically required working with the Meta Marketing API, authentication tokens, permissions, API endpoints, and custom application code.

Meta’s official Ads MCP server offers another approach: supported AI applications connect to a Meta-hosted server, and authorized users ask questions in natural language.

The main advantages include faster reporting, less manual data exporting, natural-language investigation of advertising problems, and a simpler way to initiate supported campaign-management operations.

Importantly, Meta Ads MCP complements the Marketing API; it does not replace every Marketing API feature.

3. Prerequisites

3.1 Requirements checklist

Before you begin

0 of 8 ready

Facebook account

A personal Facebook login authorized to access the business

Meta business portfolio

A business portfolio containing or granting access to the advertising account

Meta Ads account

An advertising account you can inspect in Ads Manager

Account permissions

Appropriate access for reporting; additional permissions for management operations

Claude account

A supported account with custom connector availability

Internet access

Connectivity for Claude, Meta authentication, and the remote MCP server

Eligible Ads MCP access

Meta must enable the integration for the relevant advertising account

Approval policy

Decide whether Claude can only read data or may propose account changes

3.2 Claude subscription requirements

As of the documentation reviewed on October 31, 2026, Anthropic supports remote custom MCP connectors on Free, Pro, Max, Ultra, Team, and Enterprise plans.

However, Free users are limited to one custom connector, and Claude Code is not available through the Free plan.

These distinctions are documented by Anthropic. Claude Help Center+2

3.3 Choose your integration method

File:Claude-ai-icon.svg – Wikimedia Commons

Method 1: Claude Web

Best for beginners, digital marketers, and business owners. No software installation is required.

Claude

Method 2: Claude Desktop

Best for professionals who prefer a dedicated desktop application for daily marketing analysis.

Claude Code Auto Mode Pricing, Availability

Method 3: Claude Code

Best for developers and technically experienced marketers who work in a terminal.

4. Meta Ads MCP Architecture

The following diagram illustrates the main connection and authorization components.

#chatgpt-mermaid-_r_jc_{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:16px;fill:rgb(13, 13, 13);}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#chatgpt-mermaid-_r_jc_ .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#chatgpt-mermaid-_r_jc_ .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#chatgpt-mermaid-_r_jc_ .error-icon{fill:rgb(243, 243, 243);}#chatgpt-mermaid-_r_jc_ .error-text{fill:rgb(13, 13, 13);stroke:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ .edge-thickness-normal{stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .edge-thickness-thick{stroke-width:3.5px;}#chatgpt-mermaid-_r_jc_ .edge-pattern-solid{stroke-dasharray:0;}#chatgpt-mermaid-_r_jc_ .edge-thickness-invisible{stroke-width:0;fill:none;}#chatgpt-mermaid-_r_jc_ .edge-pattern-dashed{stroke-dasharray:3;}#chatgpt-mermaid-_r_jc_ .edge-pattern-dotted{stroke-dasharray:2;}#chatgpt-mermaid-_r_jc_ .marker{fill:rgb(143, 143, 143);stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_jc_ .marker.cross{stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_jc_ svg{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:16px;}#chatgpt-mermaid-_r_jc_ p{margin:0;}#chatgpt-mermaid-_r_jc_ .label{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ .cluster-label text{fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ .cluster-label span{color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ .cluster-label span p{background-color:transparent;}#chatgpt-mermaid-_r_jc_ .label text,#chatgpt-mermaid-_r_jc_ span{fill:rgb(13, 13, 13);color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ .node rect,#chatgpt-mermaid-_r_jc_ .node circle,#chatgpt-mermaid-_r_jc_ .node ellipse,#chatgpt-mermaid-_r_jc_ .node polygon,#chatgpt-mermaid-_r_jc_ .node path{fill:rgb(222, 234, 251);stroke:rgb(83, 154, 248);stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .rough-node .label text,#chatgpt-mermaid-_r_jc_ .node .label text,#chatgpt-mermaid-_r_jc_ .image-shape .label,#chatgpt-mermaid-_r_jc_ .icon-shape .label{text-anchor:middle;}#chatgpt-mermaid-_r_jc_ .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .rough-node .label,#chatgpt-mermaid-_r_jc_ .node .label,#chatgpt-mermaid-_r_jc_ .image-shape .label,#chatgpt-mermaid-_r_jc_ .icon-shape .label{text-align:center;}#chatgpt-mermaid-_r_jc_ .node.clickable{cursor:pointer;}#chatgpt-mermaid-_r_jc_ .root .anchor path{fill:rgb(143, 143, 143)!important;stroke-width:0;stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_jc_ .arrowheadPath{fill:rgb(143, 143, 143);}#chatgpt-mermaid-_r_jc_ .edgePath .path{stroke:rgb(143, 143, 143);stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .flowchart-link{stroke:rgb(143, 143, 143);fill:none;}#chatgpt-mermaid-_r_jc_ .edgeLabel{background-color:rgb(252, 252, 252);text-align:center;}#chatgpt-mermaid-_r_jc_ .edgeLabel p{background-color:rgb(252, 252, 252);}#chatgpt-mermaid-_r_jc_ .edgeLabel rect{opacity:0.5;background-color:rgb(252, 252, 252);fill:rgb(252, 252, 252);}#chatgpt-mermaid-_r_jc_ .labelBkg{background-color:rgba(252, 252, 252, 0.5);}#chatgpt-mermaid-_r_jc_ .cluster rect{fill:rgb(243, 243, 243);stroke:rgba(0, 0, 0, 0.1);stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .cluster text{fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ .cluster span{color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:12px;background:rgb(243, 243, 243);border:1px solid rgba(0, 0, 0, 0.1);border-radius:2px;pointer-events:none;z-index:100;}#chatgpt-mermaid-_r_jc_ .flowchartTitleText{text-anchor:middle;font-size:18px;fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_jc_ rect.text{fill:none;stroke-width:0;}#chatgpt-mermaid-_r_jc_ .icon-shape,#chatgpt-mermaid-_r_jc_ .image-shape{background-color:rgb(252, 252, 252);text-align:center;}#chatgpt-mermaid-_r_jc_ .icon-shape p,#chatgpt-mermaid-_r_jc_ .image-shape p{background-color:rgb(252, 252, 252);padding:2px;}#chatgpt-mermaid-_r_jc_ .icon-shape .label rect,#chatgpt-mermaid-_r_jc_ .image-shape .label rect{opacity:0.5;background-color:rgb(252, 252, 252);fill:rgb(252, 252, 252);}#chatgpt-mermaid-_r_jc_ .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#chatgpt-mermaid-_r_jc_ .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#chatgpt-mermaid-_r_jc_ .node .neo-node{stroke:rgb(83, 154, 248);}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node rect,#chatgpt-mermaid-_r_jc_ [data-look=”neo”].cluster rect,#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node polygon{stroke:url(#chatgpt-mermaid-_r_jc_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].swimlane.cluster rect{filter:none;}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node path{stroke:url(#chatgpt-mermaid-_r_jc_-gradient);stroke-width:1px;}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node .outer-path{filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node .neo-line path{stroke:rgb(83, 154, 248);filter:none;}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node circle{stroke:url(#chatgpt-mermaid-_r_jc_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].node circle .state-start{fill:#000000;}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].icon-shape .icon{fill:url(#chatgpt-mermaid-_r_jc_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_jc_ [data-look=”neo”].icon-shape .icon-neo path{stroke:url(#chatgpt-mermaid-_r_jc_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_jc_ .node text{font-size:14px;font-weight:600;letter-spacing:normal;fill:rgb(0, 79, 153);}#chatgpt-mermaid-_r_jc_ .edgeLabels text{font-size:13px;font-weight:600;letter-spacing:-0.08px;fill:rgb(0, 79, 153);}#chatgpt-mermaid-_r_jc_ .node tspan[font-weight=”normal”],#chatgpt-mermaid-_r_jc_ .edgeLabels tspan[font-weight=”normal”]{font-weight:600;}#chatgpt-mermaid-_r_jc_ .edgeLabel .label rect{opacity:1;rx:13px;ry:13px;fill:rgb(245, 250, 255);stroke:rgb(206, 219, 229);stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .node rect,#chatgpt-mermaid-_r_jc_ .node circle,#chatgpt-mermaid-_r_jc_ .node ellipse,#chatgpt-mermaid-_r_jc_ .node polygon,#chatgpt-mermaid-_r_jc_ .node path{fill:rgb(229, 243, 255);stroke:rgba(0, 0, 0, 0.1);stroke-width:1px;}#chatgpt-mermaid-_r_jc_ .node rect{rx:16px;ry:16px;}#chatgpt-mermaid-_r_jc_ .mermaid-decision .label-container{fill:rgb(245, 250, 255);stroke:rgb(206, 219, 229);stroke-dasharray:2,2;}#chatgpt-mermaid-_r_jc_ .edgePaths .flowchart-link{stroke:rgb(143, 143, 143);stroke-width:1px;stroke-linecap:round;stroke-linejoin:round;}#chatgpt-mermaid-_r_jc_ .marker{fill:rgb(143, 143, 143);stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_jc_ :root{–mermaid-font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;}Advertiser / Marketing TeamClaude AIMCP ClientMeta Ads MCP ServerMeta Authorization / OAuthMeta Advertising Services /Marketing APIMeta Business PortfolioFacebook & Instagram AdAccountNatural-language requestRemote MCP over HTTPSAuthorized accessAdvertising operationsAccount authorizationReport / proposal / confirmation

This is a conceptual architecture. Meta owns the hosted MCP endpoint. Its internal routing to advertising services is not fully public, so the diagram does not claim that every MCP tool invokes the Marketing API in the same way.

Request and response lifecycle

Consider this example request:

Show the advertising spend and leads generated by my active campaigns during the last seven days.

The process works as follows:

1. You submit the request in Claude.
2. Claude identifies a relevant Meta Ads tool exposed by the MCP server.
3. The MCP client sends the structured request to Meta’s remote endpoint.
4. Meta checks the authorized connection, account access, and applicable restrictions.
5. The server retrieves the advertising information permitted by the account.
6. Claude interprets the returned information and prepares a readable report.

OAuth handles authorization. MCP handles tool discovery and invocation. Claude handles interpretation and presentation.

The important distinction is that the advertising figures originate from Meta’s data, not from Claude inventing campaign results.

5. Method One: Integrate Meta Ads with Claude Web

Recommended for beginners

This approach requires no coding, Node.js installation, API token copying, or locally hosted server.

Step 1: Prepare your Meta business account

Objective: Confirm you can access the advertising account before connecting it to Claude.

1. Open Meta Business Suite.
2. Sign in with your authorized Facebook account.
3. Choose the correct business portfolio.
4. Navigate to Settings and locate the advertising accounts associated with your business.
5. Open Meta Ads Manager and select the desired account.
6. Verify that you can view campaigns, ad sets, advertisements, and performance reports.
7. Record the advertising account ID and its currency.

In some Meta interfaces, the numeric account ID is visible in the account selector or the Ads Manager URL. Programmatic references commonly use the act_ prefix followed by that numeric ID.

Expected result: The relevant account is visible, and you can read its campaign information.

Common issues: The wrong business portfolio is selected, your Facebook login has insufficient access, or the account is disabled.

Troubleshooting: Ask the portfolio administrator to verify your assigned advertising permissions. Use the account selector to confirm you are checking the intended account.

Step 2: Review Ads MCP access and restrictions

Objective: Check whether Meta has enabled Ads MCP and whether account-level controls are available.

Where the feature is visible, go to:

Meta Business Suite → Settings → Integrations → Ads MCP Server

An August 2026 walkthrough documents this location and describes per-account restrictions for creating campaigns, changing budgets, editing targeting and creative, and changing campaign status. The available interface may differ by account. Jon Loomer Digital

Before connecting Claude, review which advertising accounts and catalogs are exposed and disable unnecessary modification capabilities.

Expected result: You can inspect any available MCP access and action restrictions.

Common issue: The Ads MCP Server option is missing.

Troubleshooting: Check your role and account eligibility. Meta’s gradual rollout means this setting may not yet be available to every advertiser.

Step 3: Open Claude Web

Objective: Access the Claude account that will host the connector.

1. Open Claude Web.
2. Log in with your Claude account.
3. Open your account settings.
4. Navigate to Customize → Connectors.

You may also access connector management from a conversation using the + menu, followed by Connectors and Manage connectors.

Expected result: Claude displays available and previously configured connectors.

Common issue: Connector management is missing or restricted.

Troubleshooting: Confirm you are using a supported account and that your organization’s administrator permits custom connectors. Claude Help Center

Step 4: Add Meta Ads as a custom connector

Objective: Register Meta’s official remote MCP endpoint.

Anthropic’s current custom connector workflow is:

1. Open Customize → Connectors.
2. Click Add or + Add.
3. Choose Custom → Web or the equivalent Add custom connector entry.
4. Enter the connector name and server URL.
5. Click Continue.

Use this configuration:

Do not enter a random API key or select a local command-based server.

Expected result: Claude recognizes the remote server configuration and proceeds to authentication settings.

Common issues: Invalid server URL, connectivity failure, or unsupported connector configuration.

Troubleshooting: Check that you pasted the exact HTTPS endpoint, not a Meta Ads Manager URL. Ensure the server is configured as a remote web connector.

Anthropic documents this connector workflow in its official support guide. Claude Help Center

Step 5: Configure OAuth authentication

Objective: Allow Claude to connect to Meta without exposing your Facebook password.

Claude’s current custom connector workflow includes authentication settings. The available controls can include:

Review Claude’s detected settings and click Continue or Add, as appropriate.

For the normal Meta-hosted MCP connection, you do not need to create your own Meta developer application or manually register a redirect URI.

Creating your own OAuth application is a separate advanced integration scenario. Do not assume that switching OAuth modes will fix a Meta account that has not been enabled for Ads MCP.

Expected result: Claude initiates the Meta account authorization process.

Common issues: invalid_client, dynamic registration failures, or an OAuth callback mismatch.

Troubleshooting: Use the standard Claude-hosted connector flow first. Do not guess a client ID, secret, or redirect URI. If authorization is rejected, record the exact error and verify Meta’s supported sign-in method. Claude Help Center+1

Step 6: Authorize the correct Meta business assets

Objective: Grant the minimum access necessary for your marketing workflow.

During the Meta sign-in process:

1. Confirm that the destination is an authentic Meta authentication page.
2. Sign in with the Facebook account authorized for the advertising business.
3. Review the requested permissions.
4. If Meta displays a choice of business portfolios, Pages, or Instagram accounts, select only the required assets.
5. Avoid granting access to all present and future assets unless necessary.
6. Approve the connection only after reviewing its scope.

Meta’s authorization interface can expose portfolio, Page, and Instagram asset choices. However, not every account provides fine-grained advertising-account selection directly in the OAuth dialog; use Meta’s portfolio-level MCP restrictions where available. Jon Loomer Digital

Expected result: Claude displays Meta Ads as connected.

Common issue: You authenticate successfully but cannot see the desired advertising account.

Troubleshooting: Confirm the Facebook account, business portfolio, account permissions, and Meta’s MCP rollout status. A successful OAuth flow does not itself prove that account-level MCP access is enabled.

Step 7: Enable Meta Ads in a Claude conversation

Objective: Make the connected advertising tools available to Claude.

1. Open a new conversation.
2. Click the + button near the chat input.
3. Open Connectors.
4. Find Meta Ads.
5. Enable the connector.
6. Review the tools and their permissions, particularly those that modify advertising assets.

For initial testing, disable unnecessary write or delete tools wherever Claude’s interface permits this. Prefer per-action approval rather than automatically allowing changes.

Expected result: Claude can discover authorized Meta Ads tools during the conversation.

Common issue: The connector exists in settings but is unavailable in the chat.

Troubleshooting: Confirm it is enabled for that conversation, reload if necessary, and check whether workspace administrators have restricted its tools. Claude Help Center+1

Step 8: Verify the integration

Start with a read-only prompt:

COPY-AND-PASTE TEST PROMPT

Using the connected Meta Ads tools, list the advertising accounts I am authorized to access. Show each account’s name, ID, status, currency, and time zone. Do not create or modify any advertising assets. If access fails, report the exact tool error rather than guessing.

Copy prompt

If successful, Claude should return actual account information. A response such as the following is illustrative only:

These are fictional examples, not live results.

Expected result: Claude invokes a Meta Ads MCP reporting tool and returns your authorized account information.

Common issue: Claude responds with general instructions instead of actual data.

Troubleshooting: Explicitly ask Claude to use the connected Meta Ads tools, inspect the tool invocation, and confirm the connection is authenticated and active.

Verification rule: A successful integration means a real tool invocation produced real authorized account data. Merely seeing the connector listed is not enough.

6. Method Two: Integrate Meta Ads with Claude Desktop

Claude Desktop provides the same general remote connector approach in a dedicated application. You do not need to create a separate locally hosted Meta MCP process.

Step 1: Download and install Claude Desktop

Visit the official Claude download page.

Macは初めてですか? – Apple サポート (日本)

macOS

Download the macOS application, install it, and launch Claude from Applications.

Announcing the first Insider Preview for Windows 11 | Windows Insider Blog

Windows

Download the Windows installer, complete installation, and launch Claude from the Start menu.

Anthropic also offers a Linux desktop application in beta, although this tutorial focuses on macOS and Windows. Claude Help Center

Steps 2–10: Configure the remote connector

1. Launch Claude Desktop and sign in to your Claude account.
2. Open Customize → Connectors.
3. Check whether Meta Ads has already been configured in Claude Web using the same account.
4. If it is not present, choose the option to add a custom web connector.
5. Enter Meta Ads as the connector name.
6. Enter https://mcp.facebook.com/ads as the remote MCP URL.
7. Review the detected OAuth authentication settings.
8. Authenticate through your authorized Meta account and review the requested asset access.
9. Open a Claude Desktop conversation and enable the Meta Ads connector.
10. Run the read-only account verification prompt from Method One.

Expected result: Claude Desktop discovers the authorized Meta Ads MCP tools and can retrieve permitted advertising information.

Common errors: The connector does not appear, the authorization has expired, the Meta account is not eligible, or the wrong business account is selected.

Troubleshooting: Check the same connector in Claude Web, verify the active account, reconnect Meta if necessary, and check the organization’s connector policies.

Should you edit claude_desktop_config.json?

Not for the standard remote Meta Ads integration described here.

claude_desktop_config.json belongs to a separate local MCP server configuration mechanism. Anthropic explicitly distinguishes local Desktop MCP servers from remote connectors configured through your Claude account. Claude Help Center

For Meta’s hosted server, use the remote connector UI rather than inventing an npx package, executable path, or local server command.

7. Method Three: Integrate Meta Ads with Claude Code

Claude Code offers a terminal-based approach for developers who want to work with MCP tools while building scripts, analyzing campaign information, or developing marketing workflows.

Step 1: Install Claude Code

The current official native installer does not require Node.js.

For macOS, Linux, or Windows Subsystem for Linux:

curl -fsSL https://claude.ai/install.sh | bashCode language: JavaScript (javascript)

For Windows PowerShell:

irm https://claude.ai/install.ps1 | iexCode language: JavaScript (javascript)

Alternatively, on Windows with WinGet:

winget install Anthropic.ClaudeCodeCode language: CSS (css)

These are documented Anthropic installation methods. Use only installation commands from its official site. Claude Code Docs

Verify the installation:

claude --version
claude doctor

Expected result: Claude Code reports its installed version and passes the relevant setup checks.

Step 2: Register the Meta Ads MCP server

Open a terminal and run:

claude mcp add --transport http meta-ads https://mcp.facebook.com/adsCode language: JavaScript (javascript)

This command:

• Uses claude mcp add to register a new MCP server.
• Uses --transport http for the remote HTTP transport.
• Names the server meta-ads.
• Sets the endpoint to Meta’s official server.

The command syntax is confirmed by Anthropic’s Claude Code MCP documentation. Claude Code Docs

Expected result: Claude Code reports that the MCP server configuration was added.

An important distinction: registering the server does not mean you have successfully authenticated or retrieved advertising data.

Step 3: Check the configuration

Run:

claude mcp listCode language: PHP (php)

Then:

claude mcp get meta-adsCode language: JavaScript (javascript)

These commands inspect configured servers and their connection status.

Possible statuses include:

Step 4: Authenticate Meta Ads

Start Claude Code:

claude

Inside the interactive Claude Code session, type:

/mcp

Select the Meta Ads server and initiate authentication if that option is available.

Claude Code normally opens a browser for OAuth authorization. Complete Meta sign-in and approve the requested permissions.

You can also attempt direct OAuth login from a terminal:

claude mcp login meta-ads

Expected result: The server becomes connected, and its authorized tools are available.

Step 5: Address OAuth compatibility problems

There is an important practical limitation.

Although Claude Code supports OAuth, individual remote servers may require particular OAuth client identities, redirect URIs, or registration mechanisms.

Meta Ads users have reported errors involving unregistered redirect URIs and unsupported client registration when connecting directly from Claude Code. These errors are not necessarily fixed by repeating the same command. AdChat

Recommended alternative when direct authentication fails:

1. Configure and authenticate the Meta Ads connector in Claude Web first.
2. Sign into Claude Code using the same Claude account through a Claude subscription login.
3. Start Claude Code.
4. Run /mcp.
5. Look for the Meta Ads connector imported from claude.ai.
6. Use the imported connection rather than registering an additional conflicting server.

Anthropic confirms that compatible connectors established through claude.ai can be made available automatically in Claude Code when using the appropriate claude.ai login method. This does not apply in the same way to API-key or third-party provider sessions. Claude Code Docs

If your directly registered meta-ads server conflicts with the imported connector, inspect both entries and remove the unwanted direct configuration:

claude mcp remove meta-ads

Step 6: Run a basic advertising query

Inside Claude Code, enter:

Use the authenticated Meta Ads MCP connection to list
my available advertising accounts.

Show:
- Account name
- Account ID
- Account status
- Currency
- Time zone

Do not modify any campaigns or account settings.
If the connector is unavailable, report the tool error.Code language: PHP (php)

A successful response containing actual account details confirms that the relevant reporting tools work.

Step 7: Remove the integration safely

For a directly configured Claude Code MCP server:

claude mcp logout meta-ads
claude mcp remove meta-ads

The logout command attempts to clear or revoke authorization according to the supported OAuth behavior. Removing the server cleans up its local configuration, but you should also review and revoke the connection in Meta if access is no longer required. Claude Code Docs

8. Testing Meta Ads Integration: 15 Practical Claude Prompts

Once your connection is working, use the following prompts to test common advertising operations.

Before asking Claude to compare numbers, understand these basic metrics:

For CTR, CPC, and conversion rate, explicitly select the click and conversion definitions. Meta offers different click measures and attribution settings, which can change the interpretation of a campaign.

Account management prompts

PROMPT 01 · List all advertising accounts Copy

List every Meta advertising account accessible through my connected MCP tools. Include account name, numeric account ID, delivery status, currency, and time zone. If any fields are unavailable, show ‘Unavailable’ rather than guessing.Expected output: Authorized account inventory

PROMPT 02 · Show account details Copy

Retrieve the details of my Meta advertising account. If multiple accounts are available, ask me to select one first. Show account status, business information available to me, and advertising settings. Do not change anything.Expected output: Account profile and settings

PROMPT 03 · Check currency and time zone Copy

For each accessible Meta advertising account, identify its configured currency and time zone. Highlight accounts that have different settings, and explain how these differences affect reporting comparisons. Do not convert currencies without an exchange-rate source.Expected output: Currency and reporting-day consistency

PROMPT 04 · List active campaigns Copy

Find all active campaigns in my selected Meta advertising account. Show campaign names, IDs, objectives, statuses, and available budget details. Include zero-spend campaigns and do not modify their delivery settings.Expected output: Current campaign inventory

Campaign analytics prompts

PROMPT 05 · Last 30 days Copy

Using my selected Meta advertising account, retrieve campaign performance for the last 30 completed calendar days in the account’s time zone. Show spend, impressions, reach, link clicks, link CTR, CPC, CPM, results, and cost per result. Include campaigns with zero delivery.Expected output: Campaign KPI report

PROMPT 06 · Compare advertising spend Copy

Compare total advertising expenditure across all campaigns for the last 30 days. Rank campaigns by spend, calculate each campaign’s percentage of total expenditure, and highlight campaigns with high spend but low results. Keep amounts in the account currency.Expected output: Spend ranking and budget concentration

PROMPT 07 · Find high-CPC campaigns Copy

Analyze link CPC for all campaigns with delivery in the last 30 days. Identify the five campaigns with the highest link CPC, show their spend, link clicks, link CTR, and CPM, and suggest possible factors to investigate. Do not assume CPC alone measures profitability.Expected output: High-CPC campaign investigation

PROMPT 08 · Calculate CPA and ROAS Copy

For the last 30 days, calculate cost per lead and purchase ROAS for campaigns where Meta reports the necessary conversion and attributed purchase-value data. Show the conversion event and attribution setting. Mark missing or zero-denominator results as N/A; never invent revenue.Expected output: CPA and ROAS assessment

PROMPT 09 · Analyze reach and engagement Copy

Compare impressions, reach, frequency, link clicks, and link CTR across my active campaigns over the last 14 completed days. Identify unusual frequency, low engagement, or declining trends, and distinguish observations from hypotheses.Expected output: Reach and engagement analysis

PROMPT 10 · Find low-conversion campaigns Copy

Identify campaigns with high link-click volume but relatively few completed leads or purchases in the last 30 days. Use a consistent conversion event and attribution window. Calculate conversion rates only where the required denominator exists, then suggest landing-page or tracking checks.Expected output: Conversion-funnel investigation

Advertising optimization prompts

PROMPT 11 · Identify wasted expenditure Copy

Review campaigns and ad sets over the last 30 days. Find instances where spend is significant relative to their defined results or where delivery produces no tracked conversions. Explain the limitations of attribution and conversion tracking before calling spending wasted. Recommend investigations only; make no changes.Expected output: Potential inefficiencies and confidence levels

PROMPT 12 · Recommend budget optimization Copy

Analyze my campaigns over the last 30 days and recommend a budget allocation based on comparable objectives, cost per result, purchase ROAS where available, and recent performance trends. Show current versus proposed allocations and expected risks. Do not apply budget changes.Expected output: Proposed budget redistribution

PROMPT 13 · Facebook versus Instagram Copy

Compare performance between Facebook and Instagram placements for the last 30 days, where placement breakdown data is available. Report spend, impressions, link clicks, link CTR, CPC, results, and cost per result. Explain where campaign objectives or attribution make comparisons unreliable.Expected output: Placement performance comparison

PROMPT 14 · Identify winning advertisements Copy

Identify my top-performing advertisements for the last 30 days using a clearly defined primary outcome, such as cost per qualified lead or attributed purchase ROAS. Include creative names, placement, spend, results, and performance trends. Explain whether the available sample sizes support a reliable ranking.Expected output: Creative performance shortlist

PROMPT 15 · Generate a weekly report Copy

Prepare a weekly Meta Ads report for the most recent seven completed calendar days, compared with the preceding seven days. Include spend, impressions, reach, link clicks, CPC, CTR, reported conversions, CPA, and ROAS where available. Summarize the three strongest results, three concerns, and five recommended next actions. Do not modify campaigns.Expected output: Weekly advertising performance report

These prompts describe the desired behavior, not guaranteed tool coverage. If a particular breakdown or metric is not exposed by the authorized MCP tools, Claude should explicitly identify that limitation.

9. Campaign Management: Read Operations Versus Write Operations

Meta’s advertising MCP is not limited to reporting. Its documented tool categories include campaign creation and management, catalogs, datasets, help and troubleshooting, experiments, and account activity logs.

However, different operations carry different levels of risk.

9.1 Supported tool categories

These tool names were documented in a third-party inventory based on Meta’s developer documentation, checked in October 2026. They are examples of documented tools, not a live discovery result from your account. Confirm their current availability and input schemas through your authenticated client before using them. MartechDB

9.2 Can Claude change live advertising campaigns?

Potentially, yes, when the relevant tool is available and authorized.

For example, Claude might be able to propose or perform an action such as changing a campaign’s daily budget or pausing an underperforming ad set.

But there is an important 2026 update.

On October 6, 2026, Meta described an expanded MCP workflow in which agent-prepared advertising work can arrive as a draft in Ads Manager and be published after explicit approval. Meta specifically discussed this expansion for large advertisers and agencies. It should not be assumed that the same draft behavior applies identically to every write tool and every account. Acerca de Meta

A safe workflow should therefore distinguish:

#chatgpt-mermaid-_r_qg_{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:16px;fill:rgb(13, 13, 13);}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#chatgpt-mermaid-_r_qg_ .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#chatgpt-mermaid-_r_qg_ .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#chatgpt-mermaid-_r_qg_ .error-icon{fill:rgb(243, 243, 243);}#chatgpt-mermaid-_r_qg_ .error-text{fill:rgb(13, 13, 13);stroke:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ .edge-thickness-normal{stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .edge-thickness-thick{stroke-width:3.5px;}#chatgpt-mermaid-_r_qg_ .edge-pattern-solid{stroke-dasharray:0;}#chatgpt-mermaid-_r_qg_ .edge-thickness-invisible{stroke-width:0;fill:none;}#chatgpt-mermaid-_r_qg_ .edge-pattern-dashed{stroke-dasharray:3;}#chatgpt-mermaid-_r_qg_ .edge-pattern-dotted{stroke-dasharray:2;}#chatgpt-mermaid-_r_qg_ .marker{fill:rgb(143, 143, 143);stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_qg_ .marker.cross{stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_qg_ svg{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:16px;}#chatgpt-mermaid-_r_qg_ p{margin:0;}#chatgpt-mermaid-_r_qg_ .label{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ .cluster-label text{fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ .cluster-label span{color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ .cluster-label span p{background-color:transparent;}#chatgpt-mermaid-_r_qg_ .label text,#chatgpt-mermaid-_r_qg_ span{fill:rgb(13, 13, 13);color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ .node rect,#chatgpt-mermaid-_r_qg_ .node circle,#chatgpt-mermaid-_r_qg_ .node ellipse,#chatgpt-mermaid-_r_qg_ .node polygon,#chatgpt-mermaid-_r_qg_ .node path{fill:rgb(222, 234, 251);stroke:rgb(83, 154, 248);stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .rough-node .label text,#chatgpt-mermaid-_r_qg_ .node .label text,#chatgpt-mermaid-_r_qg_ .image-shape .label,#chatgpt-mermaid-_r_qg_ .icon-shape .label{text-anchor:middle;}#chatgpt-mermaid-_r_qg_ .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .rough-node .label,#chatgpt-mermaid-_r_qg_ .node .label,#chatgpt-mermaid-_r_qg_ .image-shape .label,#chatgpt-mermaid-_r_qg_ .icon-shape .label{text-align:center;}#chatgpt-mermaid-_r_qg_ .node.clickable{cursor:pointer;}#chatgpt-mermaid-_r_qg_ .root .anchor path{fill:rgb(143, 143, 143)!important;stroke-width:0;stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_qg_ .arrowheadPath{fill:rgb(143, 143, 143);}#chatgpt-mermaid-_r_qg_ .edgePath .path{stroke:rgb(143, 143, 143);stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .flowchart-link{stroke:rgb(143, 143, 143);fill:none;}#chatgpt-mermaid-_r_qg_ .edgeLabel{background-color:rgb(252, 252, 252);text-align:center;}#chatgpt-mermaid-_r_qg_ .edgeLabel p{background-color:rgb(252, 252, 252);}#chatgpt-mermaid-_r_qg_ .edgeLabel rect{opacity:0.5;background-color:rgb(252, 252, 252);fill:rgb(252, 252, 252);}#chatgpt-mermaid-_r_qg_ .labelBkg{background-color:rgba(252, 252, 252, 0.5);}#chatgpt-mermaid-_r_qg_ .cluster rect{fill:rgb(243, 243, 243);stroke:rgba(0, 0, 0, 0.1);stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .cluster text{fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ .cluster span{color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:12px;background:rgb(243, 243, 243);border:1px solid rgba(0, 0, 0, 0.1);border-radius:2px;pointer-events:none;z-index:100;}#chatgpt-mermaid-_r_qg_ .flowchartTitleText{text-anchor:middle;font-size:18px;fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_qg_ rect.text{fill:none;stroke-width:0;}#chatgpt-mermaid-_r_qg_ .icon-shape,#chatgpt-mermaid-_r_qg_ .image-shape{background-color:rgb(252, 252, 252);text-align:center;}#chatgpt-mermaid-_r_qg_ .icon-shape p,#chatgpt-mermaid-_r_qg_ .image-shape p{background-color:rgb(252, 252, 252);padding:2px;}#chatgpt-mermaid-_r_qg_ .icon-shape .label rect,#chatgpt-mermaid-_r_qg_ .image-shape .label rect{opacity:0.5;background-color:rgb(252, 252, 252);fill:rgb(252, 252, 252);}#chatgpt-mermaid-_r_qg_ .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#chatgpt-mermaid-_r_qg_ .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#chatgpt-mermaid-_r_qg_ .node .neo-node{stroke:rgb(83, 154, 248);}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node rect,#chatgpt-mermaid-_r_qg_ [data-look=”neo”].cluster rect,#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node polygon{stroke:url(#chatgpt-mermaid-_r_qg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].swimlane.cluster rect{filter:none;}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node path{stroke:url(#chatgpt-mermaid-_r_qg_-gradient);stroke-width:1px;}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node .outer-path{filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node .neo-line path{stroke:rgb(83, 154, 248);filter:none;}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node circle{stroke:url(#chatgpt-mermaid-_r_qg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].node circle .state-start{fill:#000000;}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].icon-shape .icon{fill:url(#chatgpt-mermaid-_r_qg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_qg_ [data-look=”neo”].icon-shape .icon-neo path{stroke:url(#chatgpt-mermaid-_r_qg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_qg_ .node text{font-size:14px;font-weight:600;letter-spacing:normal;fill:rgb(0, 79, 153);}#chatgpt-mermaid-_r_qg_ .edgeLabels text{font-size:13px;font-weight:600;letter-spacing:-0.08px;fill:rgb(0, 79, 153);}#chatgpt-mermaid-_r_qg_ .node tspan[font-weight=”normal”],#chatgpt-mermaid-_r_qg_ .edgeLabels tspan[font-weight=”normal”]{font-weight:600;}#chatgpt-mermaid-_r_qg_ .edgeLabel .label rect{opacity:1;rx:13px;ry:13px;fill:rgb(245, 250, 255);stroke:rgb(206, 219, 229);stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .node rect,#chatgpt-mermaid-_r_qg_ .node circle,#chatgpt-mermaid-_r_qg_ .node ellipse,#chatgpt-mermaid-_r_qg_ .node polygon,#chatgpt-mermaid-_r_qg_ .node path{fill:rgb(229, 243, 255);stroke:rgba(0, 0, 0, 0.1);stroke-width:1px;}#chatgpt-mermaid-_r_qg_ .node rect{rx:16px;ry:16px;}#chatgpt-mermaid-_r_qg_ .mermaid-decision .label-container{fill:rgb(245, 250, 255);stroke:rgb(206, 219, 229);stroke-dasharray:2,2;}#chatgpt-mermaid-_r_qg_ .edgePaths .flowchart-link{stroke:rgb(143, 143, 143);stroke-width:1px;stroke-linecap:round;stroke-linejoin:round;}#chatgpt-mermaid-_r_qg_ .marker{fill:rgb(143, 143, 143);stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_qg_ :root{–mermaid-font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;}Claude analyzesperformancePrepare proposed changesShow current vs proposedsettingsHuman approves?No changesUse authorized MCP writeoperationVerify results in Meta AdsManagerCheck delivery, budget andchange historyNoYes

For the safest setup, require human approval through both Claude’s tool-permission controls and Meta’s account-level restrictions, where available.

9.3 Example: Request a campaign change without executing it

Analyze my active Meta advertising campaigns.

Identify the campaign with the highest cost per lead
during the last 14 days.

Recommend whether I should retain, reduce, or pause
its spending based on the available evidence.

Show:
1. Campaign name and ID
2. Current delivery status and budget
3. Current spend and results
4. Proposed change
5. Expected benefits and risks
6. Evidence supporting the recommendation

Do not invoke any write tools.

Ask for my explicit approval before attempting any change.Code language: JavaScript (javascript)

This kind of two-stage workflow is preferable to immediately instructing Claude to optimize every campaign.

10. Advanced AI-Powered Advertising Use Cases

Once basic reporting works, the integration becomes useful for investigating problems and developing campaign improvement plans.

Use case 1: Diagnose campaigns with zero spending

Suppose an Instagram Reels campaign shows zero results and zero expenditure.

You can ask Claude:

Investigate my Instagram Reels advertising campaigns
that recorded zero spending over the last seven days.

For each campaign, inspect the available:
- Campaign, ad set and ad delivery statuses
- Scheduled start and end dates
- Budget configuration
- Available delivery diagnostics
- Account restrictions
- Performance and spend data

Identify possible reasons for zero delivery.

Separate confirmed findings from possible explanations.
Tell me which checks must be performed manually in
Meta Ads Manager.

Do not modify any settings.Code language: JavaScript (javascript)

This is particularly useful because zero expenditure is not necessarily evidence of poor advertising performance. It can indicate that the campaign never delivered.

Claude may help narrow the investigation, but billing problems, account restrictions, review status, or other delivery conditions might require direct inspection in Ads Manager.

Use case 2: Optimize advertising budgets

A marketing manager can ask Claude to compare campaigns with the same business objective and prepare a budget allocation proposal.

For example, imagine these fictional performance figures:

Claude might recommend investigating whether the Instagram Feed campaign deserves additional investment.

However, lower CPL does not automatically mean higher profitability. Lead quality, conversion delays, attribution, and delivery scalability matter.

The right approach is to request a recommendation, review the evidence, and apply a controlled budget experiment.

Use case 3: Evaluate advertising creatives

Claude can help identify whether video advertisements, static images, or particular creative variations correlate with stronger outcomes.

A useful analysis should group comparable advertisements, account for differences in audience and objectives, and highlight insufficient data rather than declaring a winner from a handful of clicks.

Use case 4: Analyze conversion funnel problems

A campaign can generate many clicks but very few sales or leads.

Claude can examine available advertising metrics and identify where the performance changes occur.

However, Meta Ads MCP does not automatically gain access to your website analytics, CRM, payment system, or lead qualification data.

If you need actual customer revenue, lead quality, or lifetime-value reporting, those sources must be connected separately and their measurements reconciled.

Use case 5: Generate management reports

A weekly reporting workflow might include:

#chatgpt-mermaid-_r_rg_{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:16px;fill:rgb(13, 13, 13);}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#chatgpt-mermaid-_r_rg_ .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#chatgpt-mermaid-_r_rg_ .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#chatgpt-mermaid-_r_rg_ .error-icon{fill:rgb(243, 243, 243);}#chatgpt-mermaid-_r_rg_ .error-text{fill:rgb(13, 13, 13);stroke:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ .edge-thickness-normal{stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .edge-thickness-thick{stroke-width:3.5px;}#chatgpt-mermaid-_r_rg_ .edge-pattern-solid{stroke-dasharray:0;}#chatgpt-mermaid-_r_rg_ .edge-thickness-invisible{stroke-width:0;fill:none;}#chatgpt-mermaid-_r_rg_ .edge-pattern-dashed{stroke-dasharray:3;}#chatgpt-mermaid-_r_rg_ .edge-pattern-dotted{stroke-dasharray:2;}#chatgpt-mermaid-_r_rg_ .marker{fill:rgb(143, 143, 143);stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_rg_ .marker.cross{stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_rg_ svg{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:16px;}#chatgpt-mermaid-_r_rg_ p{margin:0;}#chatgpt-mermaid-_r_rg_ .label{font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ .cluster-label text{fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ .cluster-label span{color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ .cluster-label span p{background-color:transparent;}#chatgpt-mermaid-_r_rg_ .label text,#chatgpt-mermaid-_r_rg_ span{fill:rgb(13, 13, 13);color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ .node rect,#chatgpt-mermaid-_r_rg_ .node circle,#chatgpt-mermaid-_r_rg_ .node ellipse,#chatgpt-mermaid-_r_rg_ .node polygon,#chatgpt-mermaid-_r_rg_ .node path{fill:rgb(222, 234, 251);stroke:rgb(83, 154, 248);stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .rough-node .label text,#chatgpt-mermaid-_r_rg_ .node .label text,#chatgpt-mermaid-_r_rg_ .image-shape .label,#chatgpt-mermaid-_r_rg_ .icon-shape .label{text-anchor:middle;}#chatgpt-mermaid-_r_rg_ .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .rough-node .label,#chatgpt-mermaid-_r_rg_ .node .label,#chatgpt-mermaid-_r_rg_ .image-shape .label,#chatgpt-mermaid-_r_rg_ .icon-shape .label{text-align:center;}#chatgpt-mermaid-_r_rg_ .node.clickable{cursor:pointer;}#chatgpt-mermaid-_r_rg_ .root .anchor path{fill:rgb(143, 143, 143)!important;stroke-width:0;stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_rg_ .arrowheadPath{fill:rgb(143, 143, 143);}#chatgpt-mermaid-_r_rg_ .edgePath .path{stroke:rgb(143, 143, 143);stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .flowchart-link{stroke:rgb(143, 143, 143);fill:none;}#chatgpt-mermaid-_r_rg_ .edgeLabel{background-color:rgb(252, 252, 252);text-align:center;}#chatgpt-mermaid-_r_rg_ .edgeLabel p{background-color:rgb(252, 252, 252);}#chatgpt-mermaid-_r_rg_ .edgeLabel rect{opacity:0.5;background-color:rgb(252, 252, 252);fill:rgb(252, 252, 252);}#chatgpt-mermaid-_r_rg_ .labelBkg{background-color:rgba(252, 252, 252, 0.5);}#chatgpt-mermaid-_r_rg_ .cluster rect{fill:rgb(243, 243, 243);stroke:rgba(0, 0, 0, 0.1);stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .cluster text{fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ .cluster span{color:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;font-size:12px;background:rgb(243, 243, 243);border:1px solid rgba(0, 0, 0, 0.1);border-radius:2px;pointer-events:none;z-index:100;}#chatgpt-mermaid-_r_rg_ .flowchartTitleText{text-anchor:middle;font-size:18px;fill:rgb(13, 13, 13);}#chatgpt-mermaid-_r_rg_ rect.text{fill:none;stroke-width:0;}#chatgpt-mermaid-_r_rg_ .icon-shape,#chatgpt-mermaid-_r_rg_ .image-shape{background-color:rgb(252, 252, 252);text-align:center;}#chatgpt-mermaid-_r_rg_ .icon-shape p,#chatgpt-mermaid-_r_rg_ .image-shape p{background-color:rgb(252, 252, 252);padding:2px;}#chatgpt-mermaid-_r_rg_ .icon-shape .label rect,#chatgpt-mermaid-_r_rg_ .image-shape .label rect{opacity:0.5;background-color:rgb(252, 252, 252);fill:rgb(252, 252, 252);}#chatgpt-mermaid-_r_rg_ .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#chatgpt-mermaid-_r_rg_ .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#chatgpt-mermaid-_r_rg_ .node .neo-node{stroke:rgb(83, 154, 248);}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node rect,#chatgpt-mermaid-_r_rg_ [data-look=”neo”].cluster rect,#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node polygon{stroke:url(#chatgpt-mermaid-_r_rg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].swimlane.cluster rect{filter:none;}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node path{stroke:url(#chatgpt-mermaid-_r_rg_-gradient);stroke-width:1px;}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node .outer-path{filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node .neo-line path{stroke:rgb(83, 154, 248);filter:none;}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node circle{stroke:url(#chatgpt-mermaid-_r_rg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].node circle .state-start{fill:#000000;}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].icon-shape .icon{fill:url(#chatgpt-mermaid-_r_rg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_rg_ [data-look=”neo”].icon-shape .icon-neo path{stroke:url(#chatgpt-mermaid-_r_rg_-gradient);filter:drop-shadow( 1px 2px 2px rgba(185,185,185,1));}#chatgpt-mermaid-_r_rg_ .node text{font-size:14px;font-weight:600;letter-spacing:normal;fill:rgb(0, 79, 153);}#chatgpt-mermaid-_r_rg_ .edgeLabels text{font-size:13px;font-weight:600;letter-spacing:-0.08px;fill:rgb(0, 79, 153);}#chatgpt-mermaid-_r_rg_ .node tspan[font-weight=”normal”],#chatgpt-mermaid-_r_rg_ .edgeLabels tspan[font-weight=”normal”]{font-weight:600;}#chatgpt-mermaid-_r_rg_ .edgeLabel .label rect{opacity:1;rx:13px;ry:13px;fill:rgb(245, 250, 255);stroke:rgb(206, 219, 229);stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .node rect,#chatgpt-mermaid-_r_rg_ .node circle,#chatgpt-mermaid-_r_rg_ .node ellipse,#chatgpt-mermaid-_r_rg_ .node polygon,#chatgpt-mermaid-_r_rg_ .node path{fill:rgb(229, 243, 255);stroke:rgba(0, 0, 0, 0.1);stroke-width:1px;}#chatgpt-mermaid-_r_rg_ .node rect{rx:16px;ry:16px;}#chatgpt-mermaid-_r_rg_ .mermaid-decision .label-container{fill:rgb(245, 250, 255);stroke:rgb(206, 219, 229);stroke-dasharray:2,2;}#chatgpt-mermaid-_r_rg_ .edgePaths .flowchart-link{stroke:rgb(143, 143, 143);stroke-width:1px;stroke-linecap:round;stroke-linejoin:round;}#chatgpt-mermaid-_r_rg_ .marker{fill:rgb(143, 143, 143);stroke:rgb(143, 143, 143);}#chatgpt-mermaid-_r_rg_ :root{–mermaid-font-family:-apple-system-body,ui-sans-serif,-apple-system,system-ui,”Segoe UI”,Helvetica,”Apple Color Emoji”,Arial,sans-serif,”Segoe UI Emoji”,”Segoe UI Symbol”;}Meta Ads dataClaude via MCPPerformance analysisWeekly management reportHuman reviewApproved actions

Claude can produce a report when requested. The MCP connection alone does not establish automatic scheduling or continuous monitoring. Recurring execution requires a separately supported scheduling or orchestration mechanism.

11. Troubleshooting Meta Ads MCP Integration

Common problems and solutions

Account-level rollout failures and Claude Code OAuth compatibility errors have been reported in October 2026 troubleshooting guides. These should not be treated as problems that can always be solved by changing local configuration. AdChat

A systematic troubleshooting process

When the connection fails, diagnose it in this order:

1. Client: Can Claude open the connector configuration?
2. Transport: Is the exact MCP endpoint configured correctly?
3. Authentication: Did OAuth complete successfully?
4. Eligibility: Has Meta enabled Ads MCP for the account?
5. Authorization: Does your Meta login have access to the required advertising assets?
6. Tool discovery: Does Claude see the required MCP reporting tool?
7. Data retrieval: Can a simple account-list request succeed?
8. Operation authorization: Are the necessary read or write tools allowed?

Do not start troubleshooting an advertising metric query until basic account retrieval succeeds.

Also, do not test the MCP URL by expecting it to display a website. An MCP endpoint can reject an ordinary browser GET request while still supporting the appropriate protocol requests.

12. Security Best Practices

Because an AI assistant may receive access to advertising accounts with real spending budgets, security needs to be configured before advanced workflows are introduced.

Practical security checklist

• Use Meta’s official endpoint rather than an unverified third-party server.
• Enable multi-factor authentication on relevant business accounts.
• Connect only approved business portfolios and advertising assets.
• Disable unnecessary write and delete tools.
• Configure Meta Ads MCP server rules for each account where available.
• Require explicit review of proposed campaign and budget changes.
• Set and monitor suitable advertising spending limits.
• Avoid granting unrestricted access across client advertising accounts.
• Review Ads Manager activity history after changes.
• Never paste passwords, OAuth tokens, or client secrets into prompts.
• Remove unused connectors and revoke their authorization.
• Periodically review available MCP tools because server capabilities may evolve.

Anthropic warns that remote MCP servers can execute actions within the permissions granted to them. It also recommends careful tool approval, verifying server trust, and reviewing connector access. Claude Help Center

For agencies, a useful access model is to separate reporting users from people authorized to publish advertising changes.

Recommended operating policy: AI may inspect and recommend by default. An authorized person must approve any account modification, and the resulting state must be verified in Meta Ads Manager.

13. Limitations and Important Considerations

Meta’s October 2026 announcement described expanded draft-based workflows and approvals, but it did not establish that every advertising account receives identical behavior. Acerca de Meta

This guide does not claim to have completed an authenticated test against a live Meta ad account. The integration instructions are grounded in published documentation; the precise tools and permissions must be verified in your own connected environment.

14. Claude Web vs Claude Desktop vs Claude Code

Which method should you choose?

For most business owners and digital marketers, Claude Web is the best starting point. It requires the fewest setup steps and provides an accessible way to inspect advertising performance.

Claude Desktop is an excellent alternative for people who prefer a dedicated application.

Claude Code is best suited to technical users, particularly those who need command-line workflows or want to integrate Meta advertising analysis into a broader development process.

15. Frequently Asked Questions

1. Can Claude connect directly to Meta Ads?

Yes, through Meta’s official remote Ads MCP server, subject to account eligibility and connector authorization.

2. What is Meta Ads MCP?

It is Meta’s hosted MCP interface for exposing supported advertising reporting and management tools to authorized AI applications.

3. Is Meta Ads MCP free?

Meta has not published a separate general connector fee in the official announcements reviewed. Beta availability, Claude subscription costs, and normal advertising expenditure are separate considerations.

4. Do I need Claude Pro?

Not for a single custom remote connector on Claude Web or Desktop. Claude Code requires an eligible paid or API/provider arrangement.

5. Can I use Claude Desktop?

Yes. Configure the remote connector through the Claude account’s connector management interface.

6. Can I use Claude Code?

Yes. It supports remote MCP over HTTP, though Meta OAuth compatibility may require using the connector established through Claude Web.

7. Do I need a Meta Developer account?

Not for the standard Meta-hosted OAuth integration. Developer-app registration is a separate advanced approach.

8. Is Facebook OAuth required?

The normal connection uses Meta authorization. You should complete it through the supported sign-in process.

9. Can Claude access multiple advertising accounts?

Potentially, if your Meta login has access and MCP is enabled for the relevant accounts. Review account scope carefully.

10. Can Claude retrieve advertising expenditure?

Yes, when the applicable reporting tools, permissions, and data are available.

11. Can Claude calculate ROAS?

Yes, if attributed purchase value and spend are available for a consistent reporting period.

12. Can Claude create Facebook campaigns?

Meta documents campaign creation capabilities, but actual execution depends on tool availability, permissions, and approval behavior.

13. Can Claude pause advertisements?

Potentially, through supported entity-management operations. Check the exact tool and its authorization before allowing changes.

14. Can Claude change campaign budgets?

Potentially, when the account and tool permit it. Budget changes should require explicit review.

15. Is the integration secure?

It uses supported authentication and access controls, but security depends on permissions, trusted endpoints, approval rules, and ongoing review.

16. Can I disconnect the integration?

Yes. Remove or disconnect the connector in Claude and revoke the relevant authorization in Meta when necessary.

17. What should I do if authentication fails?

Check the Meta account, OAuth error, client compatibility, and account eligibility. Prefer the supported Claude Web connection when direct CLI authentication fails.

16. Screenshot Plan for the Published Tutorial

Screenshots are valuable for a beginner-focused implementation guide, but they should show genuine interfaces captured from the author’s account. No synthetic application screenshots are presented as real configuration evidence here.

Use the following placeholders when preparing the WordPress article.

For each screenshot, include a caption identifying the step and explain the relevant visual elements. Mask personal details, business identifiers, confidential budgets, and any other information you are not authorized to publish.

17. SEO, Internal Links, and Structured Data

Recommended article structure

The tutorial is organized around the primary keyword Meta Ads Integration with Claude, with secondary phrases naturally distributed among the relevant sections.

Potential internal links for a digital marketing or technology education website include:

• Meta Ads Manager beginner tutorial
• Facebook Ads campaign optimization guide
• Instagram Reels advertising tutorial
• Model Context Protocol (MCP) beginner’s guide
• Claude AI tutorial for beginners
• Meta Pixel and Conversions API setup
• Facebook Ads ROAS, CPA, and CTR explained

FAQ schema recommendation

For sites that support structured data, you may add FAQPage JSON-LD matching questions and answers actually visible in the published page.

For example:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Can Claude connect directly to Meta Ads?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. Claude can connect through Meta's official Ads MCP server when the account is eligible and properly authorized."
      }
    },
    {
      "@type": "Question",
      "name": "Do I need a Meta Developer account?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A developer application is not required for the standard Meta-hosted OAuth connector."
      }
    }
  ]
}Code language: JSON / JSON with Comments (json)

Structured data should match the visible content exactly. Implementing FAQ schema does not guarantee a special search-result appearance.

18. Official Documentation and References

These are the primary references for validating and maintaining this tutorial.

Documentation verification note: The Anthropic configuration instructions and Meta’s October newsroom announcement were accessible for direct verification. Some Meta Business and developer documentation pages required login or returned access restrictions, so the detailed tool examples were additionally cross-checked against public documentation inventories. A live authenticated tool inventory is still necessary before enabling advanced write operations.

19. Conclusion

Meta Ads MCP represents a significant improvement in how advertisers can interact with their advertising accounts.

Instead of relying entirely on dashboards and exported spreadsheets, advertisers can use Claude AI to request campaign reports, compare results, investigate delivery problems, and develop advertising optimization plans in natural language.

For beginners, the most practical implementation is straightforward:

1. Verify your Meta advertising account and permissions.
2. Check whether Ads MCP is enabled for the account.
3. Add https://mcp.facebook.com/ads in Claude Web as a custom remote connector.
4. Complete Meta OAuth authentication.
5. Enable the connector and verify read access using a simple account-listing query.
6. Begin with reporting and analysis before considering campaign changes.
7. Configure permission restrictions and require human approval for consequential actions.

The most valuable use of this integration is not to let an AI assistant make every advertising decision automatically. It is to help advertisers understand campaign performance faster, investigate issues systematically, and make better-informed decisions while retaining control of their advertising budgets.

Rajesh Kumar

I’m Rajesh Kumar, a DevOps, SRE, DevSecOps, Cloud, and Platform Engineering expert passionate about sharing practical knowledge, real-world experiences, and industry best practices. I have worked at Cotocus and regularly write about technology, travel, investing, health, product reviews, and digital marketing through my various platforms.

I publish technical articles at DevOps School, travel stories at Holiday Landmark, stock market insights at Stocks Mantra, health and fitness guidance at My Medic Plus, product reviews at TrueReviewNow, and SEO and digital marketing strategies at Wizbrand.