{"id":79695,"date":"2026-10-31T13:19:06","date_gmt":"2026-10-31T13:19:06","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=79695"},"modified":"2026-10-31T13:19:09","modified_gmt":"2026-10-31T13:19:09","slug":"how-to-integrate-meta-facebook-instagram-ads-with-claude-ai-using-mcp-a-complete-step-by-step-guide","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/how-to-integrate-meta-facebook-instagram-ads-with-claude-ai-using-mcp-a-complete-step-by-step-guide\/","title":{"rendered":"How to Integrate Meta (Facebook & Instagram) Ads with Claude AI Using MCP: A Complete Step-by-Step Guide"},"content":{"rendered":"\n

Updated: October 31, 2026 | Beginner to Intermediate | Technical Tutorial<\/p>\n\n\n\n

SEO Title: Meta Ads Integration with Claude AI Using MCP<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

URL Slug: meta-ads-integration-with-claude-ai-mcp<\/code><\/p>\n\n\n\n

Primary Keyword: Meta Ads Integration with Claude<\/p>\n\n\n\n

1. Introduction<\/h2>\n\n\n\n

Imagine managing your Facebook and Instagram advertising campaigns simply by having a conversation with an AI assistant.<\/p>\n\n\n\n

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

\n

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.<\/p>\n<\/blockquote>\n\n\n\n

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

This is possible through Meta Ads AI Connectors, powered by the Model Context Protocol (MCP).<\/p>\n\n\n\n

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<\/p>\n\n\n\n

Official Meta Ads MCP endpoint<\/p>\n\n\n\n

\nhttps:\/\/mcp.facebook.com\/ads Copy\n<\/div><\/figure>\n\n\n\n

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<\/p>\n\n\n\n

What you will learn<\/h3>\n\n\n\n

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.<\/p>\n\n\n\n

We will also explore practical marketing workflows, including advertising performance reports, budget analysis, creative comparisons, and campaign optimization.<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

2. Understanding the Technologies<\/h2>\n\n\n\n

Before configuring anything, let’s understand the three important technologies involved.<\/p>\n\n\n\n

2.1 What is Meta Ads?<\/h3>\n\n\n\n

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.<\/p>\n\n\n\n

Its basic advertising structure has three levels:<\/p>\n\n\n\n

Level<\/th>What it controls<\/th>Example<\/th><\/tr>
Campaign<\/td>Main advertising objective<\/td>Generate leads<\/td><\/tr>
Ad set<\/td>Audience, schedule, placement, budget configuration<\/td>Target professionals in India<\/td><\/tr>
Ad<\/td>Actual creative and message<\/td>Instagram Reel promoting a free demo<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

A business might run several campaigns simultaneously, making it difficult to compare advertising results manually.<\/p>\n\n\n\n

2.2 What is Claude AI?<\/h3>\n\n\n\n

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.<\/p>\n\n\n\n

In this tutorial, Claude acts as the intelligent interface for your Meta advertising data.<\/p>\n\n\n\n

It does not automatically know your campaign performance. It must first receive authorized access to the relevant information through a connector.<\/p>\n\n\n\n

2.3 What is Model Context Protocol (MCP)?<\/h3>\n\n\n\n

MCP is an open protocol that standardizes communication between AI applications and external tools or data sources.<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

There are three basic components:<\/p>\n\n\n\n

Component<\/th>Responsibility<\/th><\/tr>
MCP Host<\/td>Runs the AI experience, such as Claude<\/td><\/tr>
MCP Client<\/td>Manages communication with an MCP server<\/td><\/tr>
MCP Server<\/td>Exposes external data and operations as tools<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

The protocol allows an assistant to discover which tools a server provides and invoke them using structured requests.<\/p>\n\n\n\n

Anthropic documents MCP as an open standard for connecting AI applications with tools and information sources. Anthropic<\/p>\n\n\n\n

2.4 Why did Meta introduce an MCP server?<\/h3>\n\n\n\n

Traditionally, accessing advertising information programmatically required working with the Meta Marketing API, authentication tokens, permissions, API endpoints, and custom application code.<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

Importantly, Meta Ads MCP complements the Marketing API; it does not replace every Marketing API feature.<\/p>\n\n\n\n

3. Prerequisites<\/h2>\n\n\n\n

3.1 Requirements checklist<\/h3>\n\n\n\n

Before you begin<\/p>\n\n\n\n

0 of 8 ready<\/p>\n\n\n\n

Facebook account<\/p>\n\n\n\n

A personal Facebook login authorized to access the business<\/p>\n\n\n\n

Meta business portfolio<\/p>\n\n\n\n

A business portfolio containing or granting access to the advertising account<\/p>\n\n\n\n

Meta Ads account<\/p>\n\n\n\n

An advertising account you can inspect in Ads Manager<\/p>\n\n\n\n

Account permissions<\/p>\n\n\n\n

Appropriate access for reporting; additional permissions for management operations<\/p>\n\n\n\n

Claude account<\/p>\n\n\n\n

A supported account with custom connector availability<\/p>\n\n\n\n

Internet access<\/p>\n\n\n\n

Connectivity for Claude, Meta authentication, and the remote MCP server<\/p>\n\n\n\n

Eligible Ads MCP access<\/p>\n\n\n\n

Meta must enable the integration for the relevant advertising account<\/p>\n\n\n\n

Approval policy<\/p>\n\n\n\n

Decide whether Claude can only read data or may propose account changes<\/p>\n\n\n\n

3.2 Claude subscription requirements<\/h3>\n\n\n\n

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

However, Free users are limited to one custom connector, and Claude Code is not available through the Free plan.<\/p>\n\n\n\n

Claude product<\/th>Requirements<\/th><\/tr>
Claude Web<\/td>Free or supported paid plan; one custom connector on Free<\/td><\/tr>
Claude Desktop<\/td>Free or supported paid plan for chat and remote connectors<\/td><\/tr>
Claude Code<\/td>Pro, Max, Ultra, Team, Enterprise, or supported API\/provider access<\/td><\/tr>
Team<\/td>Organization Owner or Primary Owner must add custom connectors<\/td><\/tr>
Enterprise<\/td>Authorized administrator or appropriately privileged custom role must add connectors<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

These distinctions are documented by Anthropic. Claude Help Center+2<\/p>\n\n\n\n

3.3 Choose your integration method<\/h3>\n\n\n\n

File:Claude-ai-icon.svg – Wikimedia Commons<\/a><\/p>\n\n\n\n

Method 1: Claude Web<\/p>\n\n\n\n

Best for beginners, digital marketers, and business owners. No software installation is required.<\/p>\n\n\n\n

Claude<\/a><\/p>\n\n\n\n

Method 2: Claude Desktop<\/p>\n\n\n\n

Best for professionals who prefer a dedicated desktop application for daily marketing analysis.<\/p>\n\n\n\n

Claude Code Auto Mode Pricing, Availability<\/a><\/p>\n\n\n\n

Method 3: Claude Code<\/p>\n\n\n\n

Best for developers and technically experienced marketers who work in a terminal.<\/p>\n\n\n\n

4. Meta Ads MCP Architecture<\/h2>\n\n\n\n

The following diagram illustrates the main connection and authorization components.<\/p>\n\n\n\n

#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<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

Request and response lifecycle<\/h3>\n\n\n\n

Consider this example request:<\/p>\n\n\n\n

\n

Show the advertising spend and leads generated by my active campaigns during the last seven days.<\/p>\n<\/blockquote>\n\n\n\n

The process works as follows:<\/p>\n\n\n\n

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

    OAuth handles authorization. MCP handles tool discovery and invocation. Claude handles interpretation and presentation.<\/p>\n\n\n\n

    The important distinction is that the advertising figures originate from Meta’s data, not from Claude inventing campaign results.<\/p>\n\n\n\n

    5. Method One: Integrate Meta Ads with Claude Web<\/h2>\n\n\n\n

    Recommended for beginners<\/p>\n\n\n\n

    This approach requires no coding, Node.js installation, API token copying, or locally hosted server.<\/p>\n\n\n\n

    Step 1: Prepare your Meta business account<\/h3>\n\n\n\n

    Objective: Confirm you can access the advertising account before connecting it to Claude.<\/p>\n\n\n\n

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

      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_<\/code> prefix followed by that numeric ID.<\/p>\n\n\n\n

      Expected result: The relevant account is visible, and you can read its campaign information.<\/p>\n\n\n\n

      Common issues: The wrong business portfolio is selected, your Facebook login has insufficient access, or the account is disabled.<\/p>\n\n\n\n

      Troubleshooting: Ask the portfolio administrator to verify your assigned advertising permissions. Use the account selector to confirm you are checking the intended account.<\/p>\n\n\n\n

      Step 2: Review Ads MCP access and restrictions<\/h3>\n\n\n\n

      Objective: Check whether Meta has enabled Ads MCP and whether account-level controls are available.<\/p>\n\n\n\n

      Where the feature is visible, go to:<\/p>\n\n\n\n

      Meta Business Suite \u2192 Settings \u2192 Integrations \u2192 Ads MCP Server<\/code><\/p>\n\n\n\n

      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<\/p>\n\n\n\n

      Before connecting Claude, review which advertising accounts and catalogs are exposed and disable unnecessary modification capabilities.<\/p>\n\n\n\n

      Expected result: You can inspect any available MCP access and action restrictions.<\/p>\n\n\n\n

      Common issue: The Ads MCP Server option is missing.<\/p>\n\n\n\n

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

      Step 3: Open Claude Web<\/h3>\n\n\n\n

      Objective: Access the Claude account that will host the connector.<\/p>\n\n\n\n

        \n
      1. Open Claude Web<\/a>.<\/li>\n\n\n\n
      2. Log in with your Claude account.<\/li>\n\n\n\n
      3. Open your account settings.<\/li>\n\n\n\n
      4. Navigate to Customize \u2192 Connectors.<\/li>\n<\/ol>\n\n\n\n

        You may also access connector management from a conversation using the +<\/code> menu, followed by Connectors and Manage connectors.<\/p>\n\n\n\n

        Expected result: Claude displays available and previously configured connectors.<\/p>\n\n\n\n

        Common issue: Connector management is missing or restricted.<\/p>\n\n\n\n

        Troubleshooting: Confirm you are using a supported account and that your organization’s administrator permits custom connectors. Claude Help Center<\/p>\n\n\n\n

        Step 4: Add Meta Ads as a custom connector<\/h3>\n\n\n\n

        Objective: Register Meta’s official remote MCP endpoint.<\/p>\n\n\n\n

        Anthropic’s current custom connector workflow is:<\/p>\n\n\n\n

          \n
        1. Open Customize \u2192 Connectors.<\/li>\n\n\n\n
        2. Click Add or + Add.<\/li>\n\n\n\n
        3. Choose Custom \u2192 Web or the equivalent Add custom connector entry.<\/li>\n\n\n\n
        4. Enter the connector name and server URL.<\/li>\n\n\n\n
        5. Click Continue.<\/li>\n<\/ol>\n\n\n\n

          Use this configuration:<\/p>\n\n\n\n

          Setting<\/th>Value<\/th><\/tr>
          Connector name<\/td>Meta Ads<\/code><\/td><\/tr>
          Remote MCP server URL<\/td>https:\/\/mcp.facebook.com\/ads<\/code><\/td><\/tr>
          Server type<\/td>Remote MCP<\/td><\/tr>
          Transport<\/td>HTTP-based MCP<\/td><\/tr>
          Authentication<\/td>Meta OAuth sign-in<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Do not enter a random API key or select a local command-based server.<\/p>\n\n\n\n

          Expected result: Claude recognizes the remote server configuration and proceeds to authentication settings.<\/p>\n\n\n\n

          Common issues: Invalid server URL, connectivity failure, or unsupported connector configuration.<\/p>\n\n\n\n

          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.<\/p>\n\n\n\n

          Anthropic documents this connector workflow in its official support guide. Claude Help Center<\/p>\n\n\n\n

          Step 5: Configure OAuth authentication<\/h3>\n\n\n\n

          Objective: Allow Claude to connect to Meta without exposing your Facebook password.<\/p>\n\n\n\n

          Claude’s current custom connector workflow includes authentication settings. The available controls can include:<\/p>\n\n\n\n

          Claude setting<\/th>Guidance<\/th><\/tr>
          Authentication<\/td>Select Sign in now for immediate authorization<\/td><\/tr>
          OAuth client<\/td>Start with Use Claude’s published identity (Recommended)<\/td><\/tr>
          Automatic registration<\/td>Use only when supported by the server<\/td><\/tr>
          Own OAuth client<\/td>Intended for separately configured applications<\/td><\/tr>
          Request headers<\/td>Do not add an invented Meta API key<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Review Claude’s detected settings and click Continue or Add, as appropriate.<\/p>\n\n\n\n

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

          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.<\/p>\n\n\n\n

          Expected result: Claude initiates the Meta account authorization process.<\/p>\n\n\n\n

          Common issues: invalid_client<\/code>, dynamic registration failures, or an OAuth callback mismatch.<\/p>\n\n\n\n

          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<\/p>\n\n\n\n

          Step 6: Authorize the correct Meta business assets<\/h3>\n\n\n\n

          Objective: Grant the minimum access necessary for your marketing workflow.<\/p>\n\n\n\n

          During the Meta sign-in process:<\/p>\n\n\n\n

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

            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<\/p>\n\n\n\n

            Expected result: Claude displays Meta Ads as connected.<\/p>\n\n\n\n

            Common issue: You authenticate successfully but cannot see the desired advertising account.<\/p>\n\n\n\n

            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.<\/p>\n\n\n\n

            Step 7: Enable Meta Ads in a Claude conversation<\/h3>\n\n\n\n

            Objective: Make the connected advertising tools available to Claude.<\/p>\n\n\n\n

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

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

              Expected result: Claude can discover authorized Meta Ads tools during the conversation.<\/p>\n\n\n\n

              Common issue: The connector exists in settings but is unavailable in the chat.<\/p>\n\n\n\n

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

              Step 8: Verify the integration<\/h3>\n\n\n\n

              Start with a read-only prompt:<\/p>\n\n\n\n

              COPY-AND-PASTE TEST PROMPT<\/p>\n\n\n\n

              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.<\/p>\n\n\n\n

              Copy prompt<\/p>\n\n\n\n

              If successful, Claude should return actual account information. A response such as the following is illustrative only:<\/p>\n\n\n\n

              Advertising account<\/th>Currency<\/th>Status<\/th><\/tr>
              Example Business Ads<\/td>INR<\/td>Active<\/td><\/tr>
              Example Test Ads<\/td>USD<\/td>Active<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              These are fictional examples, not live results.<\/p>\n\n\n\n

              Expected result: Claude invokes a Meta Ads MCP reporting tool and returns your authorized account information.<\/p>\n\n\n\n

              Common issue: Claude responds with general instructions instead of actual data.<\/p>\n\n\n\n

              Troubleshooting: Explicitly ask Claude to use the connected Meta Ads tools, inspect the tool invocation, and confirm the connection is authenticated and active.<\/p>\n\n\n\n

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

              6. Method Two: Integrate Meta Ads with Claude Desktop<\/h2>\n\n\n\n

              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.<\/p>\n\n\n\n

              Step 1: Download and install Claude Desktop<\/h3>\n\n\n\n

              Visit the official Claude download page<\/a>.<\/p>\n\n\n\n

              Mac\u306f\u521d\u3081\u3066\u3067\u3059\u304b? – Apple \u30b5\u30dd\u30fc\u30c8 (\u65e5\u672c)<\/a><\/p>\n\n\n\n

              macOS<\/p>\n\n\n\n

              Download the macOS application, install it, and launch Claude from Applications.<\/p>\n\n\n\n

              Announcing the first Insider Preview for Windows 11 | Windows Insider Blog<\/a><\/p>\n\n\n\n

              Windows<\/p>\n\n\n\n

              Download the Windows installer, complete installation, and launch Claude from the Start menu.<\/p>\n\n\n\n

              Anthropic also offers a Linux desktop application in beta, although this tutorial focuses on macOS and Windows. Claude Help Center<\/p>\n\n\n\n

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

                Expected result: Claude Desktop discovers the authorized Meta Ads MCP tools and can retrieve permitted advertising information.<\/p>\n\n\n\n

                Common errors: The connector does not appear, the authorization has expired, the Meta account is not eligible, or the wrong business account is selected.<\/p>\n\n\n\n

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

                Should you edit claude_desktop_config.json<\/code>?<\/h3>\n\n\n\n

                Not for the standard remote Meta Ads integration described here.<\/p>\n\n\n\n

                claude_desktop_config.json<\/code> 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<\/p>\n\n\n\n

                For Meta’s hosted server, use the remote connector UI rather than inventing an npx<\/code> package, executable path, or local server command.<\/p>\n\n\n\n

                7. Method Three: Integrate Meta Ads with Claude Code<\/h2>\n\n\n\n

                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.<\/p>\n\n\n\n

                Step 1: Install Claude Code<\/h3>\n\n\n\n

                The current official native installer does not require Node.js.<\/p>\n\n\n\n

                For macOS, Linux, or Windows Subsystem for Linux:<\/p>\n\n\n

                curl -fsSL https:\/\/claude.ai\/install.sh | bash<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                For Windows PowerShell:<\/p>\n\n\n
                irm https:\/\/claude.ai\/install.ps1 | iex<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                Alternatively, on Windows with WinGet:<\/p>\n\n\n
                winget<\/span> install<\/span> Anthropic<\/span>.ClaudeCode<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
                These are documented Anthropic installation methods. Use only installation commands from its official site. Claude Code Docs<\/p>\n\n\n\n
                Verify the installation:<\/p>\n\n\n
                claude --version\nclaude doctor<\/code><\/span><\/pre>\n\n\n
                Expected result: Claude Code reports its installed version and passes the relevant setup checks.<\/p>\n\n\n\n
                Step 2: Register the Meta Ads MCP server<\/h3>\n\n\n\n
                Open a terminal and run:<\/p>\n\n\n
                claude mcp add --transport http meta-ads https:\/\/mcp.facebook.com\/ads<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                This command:<\/p>\n\n\n\n
                  \n
                • Uses claude mcp add<\/code> to register a new MCP server.<\/li>\n\n\n\n
                • Uses --transport http<\/code> for the remote HTTP transport.<\/li>\n\n\n\n
                • Names the server meta-ads<\/code>.<\/li>\n\n\n\n
                • Sets the endpoint to Meta’s official server.<\/li>\n<\/ul>\n\n\n\n
                  The command syntax is confirmed by Anthropic’s Claude Code MCP documentation. Claude Code Docs<\/p>\n\n\n\n
                  Expected result: Claude Code reports that the MCP server configuration was added.<\/p>\n\n\n\n
                  An important distinction: registering the server does not mean you have successfully authenticated or retrieved advertising data.<\/p>\n\n\n\n
                  Step 3: Check the configuration<\/h3>\n\n\n\n
                  Run:<\/p>\n\n\n
                  claude mcp list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                  Then:<\/p>\n\n\n
                  claude mcp get<\/span> meta-ads<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                  These commands inspect configured servers and their connection status.<\/p>\n\n\n\n
                  Possible statuses include:<\/p>\n\n\n\n
                  Status<\/th>Meaning<\/th><\/tr>
                  Connected<\/td>MCP connection established<\/td><\/tr>
                  Needs authentication<\/td>Sign-in is required<\/td><\/tr>
                  Failed to connect<\/td>Transport, authentication, or server problem<\/td><\/tr>
                  Blocked by policy<\/td>Workspace security settings prevent use<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                  Step 4: Authenticate Meta Ads<\/h3>\n\n\n\n
                  Start Claude Code:<\/p>\n\n\n
                  claude<\/code><\/span><\/pre>\n\n\n
                  Inside the interactive Claude Code session, type:<\/p>\n\n\n
                  \/mcp<\/code><\/span><\/pre>\n\n\n
                  Select the Meta Ads server and initiate authentication if that option is available.<\/p>\n\n\n\n
                  Claude Code normally opens a browser for OAuth authorization. Complete Meta sign-in and approve the requested permissions.<\/p>\n\n\n\n
                  You can also attempt direct OAuth login from a terminal:<\/p>\n\n\n
                  claude mcp login meta-ads<\/code><\/span><\/pre>\n\n\n
                  Expected result: The server becomes connected, and its authorized tools are available.<\/p>\n\n\n\n
                  Step 5: Address OAuth compatibility problems<\/h3>\n\n\n\n
                  There is an important practical limitation.<\/p>\n\n\n\n
                  Although Claude Code supports OAuth, individual remote servers may require particular OAuth client identities, redirect URIs, or registration mechanisms.<\/p>\n\n\n\n
                  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<\/p>\n\n\n\n
                  Recommended alternative when direct authentication fails:<\/p>\n\n\n\n
                    \n
                  1. Configure and authenticate the Meta Ads connector in Claude Web first.<\/li>\n\n\n\n
                  2. Sign into Claude Code using the same Claude account through a Claude subscription login.<\/li>\n\n\n\n
                  3. Start Claude Code.<\/li>\n\n\n\n
                  4. Run \/mcp<\/code>.<\/li>\n\n\n\n
                  5. Look for the Meta Ads connector imported from claude.ai.<\/li>\n\n\n\n
                  6. Use the imported connection rather than registering an additional conflicting server.<\/li>\n<\/ol>\n\n\n\n
                    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<\/p>\n\n\n\n
                    If your directly registered meta-ads<\/code> server conflicts with the imported connector, inspect both entries and remove the unwanted direct configuration:<\/p>\n\n\n
                    claude mcp remove meta-ads<\/code><\/span><\/pre>\n\n\n
                    Step 6: Run a basic advertising query<\/h3>\n\n\n\n
                    Inside Claude Code, enter:<\/p>\n\n\n
                    Use<\/span> the<\/span> authenticated<\/span> Meta<\/span> Ads<\/span> MCP<\/span> connection<\/span> to<\/span> list<\/span>\nmy<\/span> available<\/span> advertising<\/span> accounts<\/span>.\n\nShow<\/span>:\n- Account<\/span> name<\/span>\n- Account<\/span> ID<\/span>\n- Account<\/span> status<\/span>\n- Currency<\/span>\n- Time<\/span> zone<\/span>\n\nDo<\/span> not<\/span> modify<\/span> any<\/span> campaigns<\/span> or<\/span> account<\/span> settings<\/span>.\nIf<\/span> the<\/span> connector<\/span> is<\/span> unavailable<\/span>, report<\/span> the<\/span> tool<\/span> error<\/span>.<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                    A successful response containing actual account details confirms that the relevant reporting tools work.<\/p>\n\n\n\n
                    Step 7: Remove the integration safely<\/h3>\n\n\n\n
                    For a directly configured Claude Code MCP server:<\/p>\n\n\n
                    claude mcp logout meta-ads\nclaude mcp remove meta-ads<\/code><\/span><\/pre>\n\n\n
                    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<\/p>\n\n\n\n
                    8. Testing Meta Ads Integration: 15 Practical Claude Prompts<\/h2>\n\n\n\n
                    Once your connection is working, use the following prompts to test common advertising operations.<\/p>\n\n\n\n
                    Before asking Claude to compare numbers, understand these basic metrics:<\/p>\n\n\n\n
                    Metric<\/th>Meaning<\/th>Calculation<\/th><\/tr>
                    Spend<\/td>Amount spent on advertising<\/td>Reported by Meta<\/td><\/tr>
                    Impressions<\/td>Number of ad displays<\/td>Reported by Meta<\/td><\/tr>
                    Reach<\/td>Number of unique people reached<\/td>Reported by Meta<\/td><\/tr>
                    CTR<\/td>Click-through rate<\/td>Clicks \u00f7 Impressions \u00d7 100<\/td><\/tr>
                    CPC<\/td>Cost per click<\/td>Spend \u00f7 Clicks<\/td><\/tr>
                    CPM<\/td>Cost per thousand impressions<\/td>Spend \u00f7 Impressions \u00d7 1,000<\/td><\/tr>
                    CPA<\/td>Cost per defined acquisition<\/td>Spend \u00f7 Acquisitions<\/td><\/tr>
                    ROAS<\/td>Return on advertising spend<\/td>Attributed revenue \u00f7 Spend<\/td><\/tr>
                    Conversion rate<\/td>Percentage completing the chosen action<\/td>Conversions \u00f7 Defined denominator \u00d7 100<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    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.<\/p>\n\n\n\n
                    Account management prompts<\/h3>\n\n\n\n
                    PROMPT 01 \u00b7 List all advertising accounts Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 02 \u00b7 Show account details Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 03 \u00b7 Check currency and time zone Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 04 \u00b7 List active campaigns Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    Campaign analytics prompts<\/h3>\n\n\n\n
                    PROMPT 05 \u00b7 Last 30 days Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 06 \u00b7 Compare advertising spend Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 07 \u00b7 Find high-CPC campaigns Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 08 \u00b7 Calculate CPA and ROAS Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 09 \u00b7 Analyze reach and engagement Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 10 \u00b7 Find low-conversion campaigns Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    Advertising optimization prompts<\/h3>\n\n\n\n
                    PROMPT 11 \u00b7 Identify wasted expenditure Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 12 \u00b7 Recommend budget optimization Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 13 \u00b7 Facebook versus Instagram Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 14 \u00b7 Identify winning advertisements Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    PROMPT 15 \u00b7 Generate a weekly report Copy<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    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.<\/p>\n\n\n\n
                    9. Campaign Management: Read Operations Versus Write Operations<\/h2>\n\n\n\n
                    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.<\/p>\n\n\n\n
                    However, different operations carry different levels of risk.<\/p>\n\n\n\n
                    9.1 Supported tool categories<\/h3>\n\n\n\n
                    Category<\/th>Example MCP tool<\/th>Operation<\/th><\/tr>
                    Accounts<\/td>ads_get_ad_accounts<\/code><\/td>Read<\/td><\/tr>
                    Campaign reporting<\/td>ads_get_ad_entities<\/code><\/td>Read<\/td><\/tr>
                    Performance trends<\/td>ads_insights_performance_trend<\/code><\/td>Read<\/td><\/tr>
                    Opportunity score<\/td>ads_get_opportunity_score<\/code><\/td>Read<\/td><\/tr>
                    Campaign creation<\/td>ads_create_campaign<\/code><\/td>Write<\/td><\/tr>
                    Ad set creation<\/td>ads_create_ad_set<\/code><\/td>Write<\/td><\/tr>
                    Advertisement creation<\/td>ads_create_ad<\/code><\/td>Write<\/td><\/tr>
                    Campaign modification<\/td>ads_update_entity<\/code><\/td>Write<\/td><\/tr>
                    Campaign activation<\/td>ads_activate_entity<\/code><\/td>Write<\/td><\/tr>
                    Creative inspection<\/td>ads_get_creatives<\/code><\/td>Read<\/td><\/tr>
                    Custom audiences<\/td>ads_create_custom_audience<\/code><\/td>Write<\/td><\/tr>
                    Product catalogs<\/td>ads_catalog_create<\/code><\/td>Write<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    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<\/p>\n\n\n\n
                    9.2 Can Claude change live advertising campaigns?<\/h3>\n\n\n\n
                    Potentially, yes, when the relevant tool is available and authorized.<\/p>\n\n\n\n
                    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.<\/p>\n\n\n\n
                    But there is an important 2026 update.<\/p>\n\n\n\n
                    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<\/p>\n\n\n\n
                    A safe workflow should therefore distinguish:<\/p>\n\n\n\n
                    #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<\/p>\n\n\n\n
                    For the safest setup, require human approval through both Claude’s tool-permission controls and Meta’s account-level restrictions, where available.<\/p>\n\n\n\n
                    9.3 Example: Request a campaign change without executing it<\/h3>\n\n\n
                    Analyze my active Meta advertising campaigns.\n\nIdentify the campaign with<\/span> the highest cost per lead\nduring the last 14<\/span> days.\n\nRecommend whether I should retain, reduce, or pause\nits spending based on the available evidence.\n\nShow:\n1.<\/span> Campaign name and ID\n2.<\/span> Current delivery status and budget\n3.<\/span> Current spend and results\n4.<\/span> Proposed change\n5.<\/span> Expected benefits and risks\n6.<\/span> Evidence supporting the recommendation\n\nDo not invoke any write tools.\n\nAsk for<\/span> my explicit approval before attempting any change.<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                    This kind of two-stage workflow is preferable to immediately instructing Claude to optimize every campaign.<\/p>\n\n\n\n
                    10. Advanced AI-Powered Advertising Use Cases<\/h2>\n\n\n\n
                    Once basic reporting works, the integration becomes useful for investigating problems and developing campaign improvement plans.<\/p>\n\n\n\n
                    Use case 1: Diagnose campaigns with zero spending<\/h3>\n\n\n\n
                    Suppose an Instagram Reels campaign shows zero results and zero expenditure.<\/p>\n\n\n\n
                    You can ask Claude:<\/p>\n\n\n
                    Investigate my Instagram Reels advertising campaigns\nthat recorded zero spending over the last seven days.\n\nFor each campaign, inspect the available:\n- Campaign, ad set<\/span> and ad delivery statuses\n- Scheduled start and end dates\n- Budget configuration\n- Available delivery diagnostics\n- Account restrictions\n- Performance and spend data\n\nIdentify possible reasons for zero delivery.\n\nSeparate confirmed findings from possible explanations.\nTell me which checks must be performed manually in\nMeta Ads Manager.\n\nDo not modify any settings.<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                    This is particularly useful because zero expenditure is not necessarily evidence of poor advertising performance. It can indicate that the campaign never delivered.<\/p>\n\n\n\n
                    Claude may help narrow the investigation, but billing problems, account restrictions, review status, or other delivery conditions might require direct inspection in Ads Manager.<\/p>\n\n\n\n
                    Use case 2: Optimize advertising budgets<\/h3>\n\n\n\n
                    A marketing manager can ask Claude to compare campaigns with the same business objective and prepare a budget allocation proposal.<\/p>\n\n\n\n
                    For example, imagine these fictional performance figures:<\/p>\n\n\n\n
                    Campaign<\/th>Spend<\/th>Leads<\/th>CPL<\/th><\/tr>
                    Facebook Lead Generation<\/td>\u20b910,000<\/td>100<\/td>\u20b9100<\/td><\/tr>
                    Instagram Reels<\/td>\u20b98,000<\/td>40<\/td>\u20b9200<\/td><\/tr>
                    Instagram Feed<\/td>\u20b96,000<\/td>75<\/td>\u20b980<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    Claude might recommend investigating whether the Instagram Feed campaign deserves additional investment.<\/p>\n\n\n\n
                    However, lower CPL does not automatically mean higher profitability. Lead quality, conversion delays, attribution, and delivery scalability matter.<\/p>\n\n\n\n
                    The right approach is to request a recommendation, review the evidence, and apply a controlled budget experiment.<\/p>\n\n\n\n
                    Use case 3: Evaluate advertising creatives<\/h3>\n\n\n\n
                    Claude can help identify whether video advertisements, static images, or particular creative variations correlate with stronger outcomes.<\/p>\n\n\n\n
                    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.<\/p>\n\n\n\n
                    Use case 4: Analyze conversion funnel problems<\/h3>\n\n\n\n
                    A campaign can generate many clicks but very few sales or leads.<\/p>\n\n\n\n
                    Claude can examine available advertising metrics and identify where the performance changes occur.<\/p>\n\n\n\n
                    However, Meta Ads MCP does not automatically gain access to your website analytics, CRM, payment system, or lead qualification data.<\/p>\n\n\n\n
                    If you need actual customer revenue, lead quality, or lifetime-value reporting, those sources must be connected separately and their measurements reconciled.<\/p>\n\n\n\n
                    Use case 5: Generate management reports<\/h3>\n\n\n\n
                    A weekly reporting workflow might include:<\/p>\n\n\n\n
                    #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<\/p>\n\n\n\n
                    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.<\/p>\n\n\n\n
                    11. Troubleshooting Meta Ads MCP Integration<\/h2>\n\n\n\n
                    Common problems and solutions<\/h3>\n\n\n\n
                    Problem<\/th>Possible cause<\/th>Recommended solution<\/th><\/tr>
                    MCP connection failure<\/td>Incorrect URL or transport<\/td>Use the official HTTPS URL with a supported remote MCP connection<\/td><\/tr>
                    OAuth login fails<\/td>Client compatibility or expired authorization<\/td>Retry sign-in using Claude Web’s supported connector flow<\/td><\/tr>
                    Invalid redirect URI<\/td>OAuth callback does not match the registered client<\/td>Avoid inventing callback URLs; use supported authentication<\/td><\/tr>
                    is_ads_mcp_enabled: false<\/code><\/td>Meta has not enabled MCP for the account<\/td>Check another eligible account or retry after rollout<\/td><\/tr>
                    Advertising account missing<\/td>Wrong Meta login or insufficient permissions<\/td>Verify the Facebook profile and business account role<\/td><\/tr>
                    Connector not visible<\/td>Workspace administration restriction<\/td>Ask the authorized Claude organization administrator<\/td><\/tr>
                    Tools are not loading<\/td>Server or tool-discovery failure<\/td>Reconnect, inspect tool permissions, and retry<\/td><\/tr>
                    Campaign data unavailable<\/td>Permissions, invalid request, or missing metric<\/td>Verify the account ID, requested fields, and reporting dates<\/td><\/tr>
                    Write operations fail<\/td>Tool restriction or insufficient Meta permissions<\/td>Inspect Claude tool approvals and Meta’s MCP account rules<\/td><\/tr>
                    Claude Code OAuth fails<\/td>Client registration or redirect incompatibility<\/td>Configure the connection in Claude Web and reuse it in Claude Code<\/td><\/tr>
                    Rate limiting<\/td>Repeated or costly reporting requests<\/td>Reduce query frequency and scope; retry appropriately<\/td><\/tr>
                    Reports show different totals<\/td>Different attribution windows, time zones, or metric definitions<\/td>Match the same reporting settings before comparing<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    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<\/p>\n\n\n\n
                    A systematic troubleshooting process<\/h3>\n\n\n\n
                    When the connection fails, diagnose it in this order:<\/p>\n\n\n\n
                      \n
                    1. Client: Can Claude open the connector configuration?<\/li>\n\n\n\n
                    2. Transport: Is the exact MCP endpoint configured correctly?<\/li>\n\n\n\n
                    3. Authentication: Did OAuth complete successfully?<\/li>\n\n\n\n
                    4. Eligibility: Has Meta enabled Ads MCP for the account?<\/li>\n\n\n\n
                    5. Authorization: Does your Meta login have access to the required advertising assets?<\/li>\n\n\n\n
                    6. Tool discovery: Does Claude see the required MCP reporting tool?<\/li>\n\n\n\n
                    7. Data retrieval: Can a simple account-list request succeed?<\/li>\n\n\n\n
                    8. Operation authorization: Are the necessary read or write tools allowed?<\/li>\n<\/ol>\n\n\n\n
                      Do not start troubleshooting an advertising metric query until basic account retrieval succeeds.<\/p>\n\n\n\n
                      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.<\/p>\n\n\n\n
                      12. Security Best Practices<\/h2>\n\n\n\n
                      Because an AI assistant may receive access to advertising accounts with real spending budgets, security needs to be configured before advanced workflows are introduced.<\/p>\n\n\n\n
                      Practical security checklist<\/h3>\n\n\n\n