元广告MCP

A. 模型上下文协议（MCP）用于与元广告交互的服务器。通过人工智能界面分析、管理和优化元广告活动。使用LLM检索性能数据，可视化广告创意，并为您在Facebook、Instagram和其他Meta平台上的广告提供战略见解。

注：这是一个独立的开源项目，使用Meta的公共API。如果您正在寻找官方批准的Meta应用程序，请查看管道板.Meta、Facebook、Instagram和其他Meta品牌名称是其各自所有者的商标。

![Meta Ads MCP Server Demo](https://github.com/user-attachments/assets/3e605cee-d289-414b-814c-6299e7f3383e)

](https://lobehub.com/mcp/nictuku-meta-ads-mcp)

mcp名称：co.pipeboard/meta-ads-mcp

社区与支持

Discord 的中文翻译是“不和谐”或“纷争”。.加入社区。
电子邮件支持给我们发电子邮件寻求支持。

远程MCP入门（推荐）

最快、最可靠的开始方式是 🚀 开始使用我们的元广告远程MCP我们的云服务使用流式HTTP传输来可靠、可扩展地访问Meta Ads数据。无需技术设置-只需连接并开始使用AI分析您的广告活动！

适用于Claude Pro/Max用户

首选 claude.ai/设置/集成（需要Claude Pro或Max）
点击“添加集成”并输入：

- 名字：“Pipeboard元广告”（或您喜欢的任何名称） - 集成URL: https://mcp.pipeboard.co/meta-ads-mcp

单击集成旁边的“连接”，然后按照提示进行操作：

- 登录Pipeboard - 连接您的Facebook广告帐户

就是这样！现在，您可以让Claude分析您的Meta广告活动，获取绩效见解，并管理您的广告。

高级：直接令牌身份验证（Claude）

对于没有交互流的直接基于令牌的身份验证，在添加集成时使用此URL格式：

https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN

获取您的代币 pipeboard.co/api-tokens.

对于游标用户

将以下内容添加到您的 ~/.cursor/mcp.json。启用远程MCP后，单击“需要登录”以完成登录过程。

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://mcp.pipeboard.co/meta-ads-mcp"
    }
  }
}

高级：直接令牌身份验证（游标）

如果您喜欢在不使用交互式登录流的情况下进行身份验证，您可以将Pipeback API令牌直接包含在URL中：

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN"
    }
  }
}

获取您的代币 pipeboard.co/api-tokens.

对于其他MCP客户端

使用远程MCP URL： https://mcp.pipeboard.co/meta-ads-mcp

📖 在此处获取您的AI客户端的详细设置说明

高级：直接令牌身份验证（OpenClaw和其他客户端）

对于支持基于令牌的身份验证的MCP客户端，您可以将Pipeback API令牌附加到URL：

https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN

这绕过了交互式登录流，并立即进行身份验证。获取您的代币 pipeboard.co/api-tokens.

还有：谷歌广告和TikTok广告

Pipeboard还提供远程MCP服务器 Google广告 和 集中广告，设置方式相同：

平台	远程MCP URL
元广告	`https://mcp.pipeboard.co/meta-ads-mcp`
谷歌广告	`https://mcp.pipeboard.co/google-ads-mcp`
tiktok广告	`https://mcp.pipeboard.co/tiktok-ads-mcp`

将您的广告帐户连接到 pipeboard.co 并将它们中的任何一个与Claude、Cursor或任何MCP客户端一起使用。

Pipeboard CLI（MCP的替代品）

Pipeboard命令行界面 是一个命令行工具，您可以通过一个二进制文件访问所有Pipeboard广告平台——Meta Ads、Google Ads和TikTok Ads。它是为AI编码代理（Claude Code、Cline、OpenClaw）和更喜欢shell命令而不是MCP的自动化脚本而构建的。

为什么使用CLI而不是MCP：

一个工具中的所有平台 --Meta、谷歌和TikTok广告，无需配置单独的MCP服务器
更多命令 --包括Pipeboard的全套工具，比开源本地MCP更大
代理人更快 --启动时间低于50ms，无JSON-RPC开销。特工们只是掏腰包 pipeboard
单一二进制，零依赖 — brew install pipeboard-co/tap/pipeboard 你完了

# Install
brew install pipeboard-co/tap/pipeboard

# Authenticate
export PIPEBOARD_API_TOKEN=  # get one at pipeboard.co/settings

# Use it
pipeboard meta-ads get-campaigns --account-id act_123
pipeboard google-ads get-campaigns --customer-id 1234567890
pipeboard meta-ads get-insights --object-id act_123 --date-preset last_30d

无需运行服务器——CLI与Pipeboard的云进行通信，与远程MCP相同。看管道板cli仓库获取完整文档。

本地安装（仅限高级技术用户）

🚀 我们强烈建议使用远程MCP 相反 -它更快、更可靠，不需要技术设置。

Meta Ads MCP还支持本地可流式HTTP传输，允许您将其作为独立的HTTP API运行，用于web应用程序和自定义集成。看 流式HTTP设置指南 获取完整说明。

特性

人工智能驱动的活动分析：让你最喜欢的法学硕士分析你的广告系列，并提供关于绩效的可操作见解
战略建议：接收数据支持的建议，以优化广告支出、定位和创意内容
自动化监控：要求任何与MCP兼容的LLM跟踪性能指标，并在重大变化时提醒您
预算优化：获取将预算重新分配到性能更好的广告集的建议
创造性改进：接收关于广告文案、图像和行动呼吁的反馈
动态创意测试：简单广告（单个标题/描述）和高级A/B测试（多个标题/描述
活动管理：请求更改活动、广告集和广告（所有更改都需要明确确认）
跨平台集成：适用于Facebook、Instagram和所有Meta广告平台
通用LLM支持：兼容任何MCP客户端，包括Claude Desktop、Cursor、Cherry Studio等
增强搜索：通用搜索功能包括当查询提到“页面”或“页面”时进行页面搜索
简单身份验证：通过安全的OAuth身份验证轻松设置
与跨平台支持：适用于Windows、macOS和Linux

配置

远程MCP（推荐）

✨ 在此处开始使用远程MCP -无需技术设置！只需连接您的Facebook广告帐户，并开始要求AI分析您的广告系列。

本地安装（高级技术用户）

对于需要自托管的高级用户，可以从源代码安装该软件包。本地安装需要创建自己的Meta Developer应用程序。 我们建议使用远程MCP 为了获得更简单的体验。

可用的MCP工具

mcp_meta_ads_get_ad_accounts

- 获取用户可访问的广告帐户 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - user_id：当前用户的元用户ID或“我” - limit：要返回的最大帐户数（默认值：200） - 返回：可访问的广告帐户列表及其详细信息

mcp_meta_ads_get_account_info

- 获取特定广告帐户的详细信息 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - 返回：指定帐户的详细信息

mcp_meta_ads_get_account_pages

- 获取与Meta Ads帐户关联的页面 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - account_id：当前用户页面的元广告帐户ID（格式：act_XXXXXXXXX）或“我” - 返回：与帐户关联的页面列表，可用于广告创建和管理

mcp_meta_ads_get_campaigns

- 通过可选过滤为Meta Ads帐户获取广告系列 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - limit：要返回的最大活动数（默认值：10） - status_filter：按状态筛选（全部为空，或“活动”、“已暂停”等） - 返回：符合条件的活动列表

mcp_meta_ads_get_campaign_details

- 获取特定活动的详细信息 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - campaign_id：元广告活动ID - 返回：指定活动的详细信息

mcp_meta_ads_create_campaign

- 在Meta Ads帐户中创建新活动

- 输入：

- access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌）

- account_id：元广告帐户ID（格式：act_XXXXXXXXX）

- name：活动名称

- objective：运动目标（ODAX，基于成果）。必须是以下之一：

- OUTCOME_AWARENESS - OUTCOME_TRAFFIC - OUTCOME_ENGAGEMENT - OUTCOME_LEADS - OUTCOME_SALES - OUTCOME_APP_PROMOTION

注：遗留目标，如 BRAND_AWARENESS, LINK_CLICKS, CONVERSIONS, APP_INSTALLS等不再适用于新活动，并将导致400错误。使用上述基于结果的值。常见映射：

- BRAND_AWARENESS → OUTCOME_AWARENESS - REACH → OUTCOME_AWARENESS - LINK_CLICKS, TRAFFIC → OUTCOME_TRAFFIC - POST_ENGAGEMENT, PAGE_LIKES, EVENT_RESPONSES, VIDEO_VIEWS → OUTCOME_ENGAGEMENT - LEAD_GENERATION → OUTCOME_LEADS - CONVERSIONS, CATALOG_SALES, MESSAGES （以销售为重点的流量）→ OUTCOME_SALES - APP_INSTALLS → OUTCOME_APP_PROMOTION

- status：初始活动状态（默认值：PAUSED）

- special_ad_categories：特殊广告类别列表（如适用）

- daily_budget：以账户货币（美分）表示的每日预算

- lifetime_budget：以账户货币表示的终身预算（美分）

- bid_strategy：投标策略。必须是以下之一： LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS.

- 返回：确认新的活动详细信息

- 例子：

     {
       "name": "2025 - Bedroom Furniture - Awareness",
       "account_id": "act_123456789012345",
       "objective": "OUTCOME_AWARENESS",
       "special_ad_categories": [],
       "status": "PAUSED",
       "buying_type": "AUCTION",
       "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
       "daily_budget": 10000
     }

mcp_meta_ads_get_adsets

- 获取Meta Ads帐户的广告集，可选择按广告系列进行筛选 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - limit：要返回的最大广告集数（默认值：10） - campaign_id：要筛选的可选活动ID - 返回：符合条件的广告集列表

mcp_meta_ads_get_adset_details

- 获取特定广告集的详细信息 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - adset_id：元广告广告集ID - 返回：指定广告集的详细信息

mcp_meta_ads_create_adset

- 在Meta Ads帐户中创建新的广告集 - 输入： - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - campaign_id：此广告集所属的元广告活动ID - name：广告集名称 - status：初始广告集状态（默认值：PAUSED） - daily_budget：以账户货币（美分）表示的每日预算字符串 - lifetime_budget：以账户货币（以美分为单位）为字符串的终身预算 - targeting：目标规格（如年龄、地点、兴趣） - optimization_goal：转换优化目标（例如“LINK_CLICKS”） - billing_event：你如何被指控（例如，“印象”） - bid_amount：投标金额（美分）。LOWEST_COST_WIT_BID_CAP、COST_CAP、TARGET_COST都是必需的。 - bid_strategy：投标策略（例如，“LOWEST_COST_WITOUT_CAP”、“LOWESTI_COST_Wit_MIN_ROAS”） - bid_constraints：LOWEST_COST_WITH_MIN_ROAS所需的投标约束条件（例如。， {"roas_average_floor": 20000}) - start_time, end_time：可选开始/结束时间（ISO 8601） - access_token （可选）：Meta API访问令牌 - 返回：确认新的广告集详细信息

mcp_meta_ads_get_ads

- 通过可选过滤为Meta ads帐户获取广告 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - limit：要返回的最大广告数（默认值：10） - campaign_id：要筛选的可选活动ID - adset_id：可选择的广告集ID进行筛选 - 返回：符合条件的广告列表

mcp_meta_ads_create_ad

- 使用现有创意创建新广告 - 输入： - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - name：广告名称 - adset_id：放置此广告的广告集ID - creative_id：要使用的现有创意的ID - status：初始广告状态（默认值：PAUSED） - bid_amount：可选投标金额（美分） - tracking_specs：可选跟踪规范 - access_token （可选）：Meta API访问令牌 - 退货：确认新的广告详情

mcp_meta_ads_get_ad_details

- 获取特定广告的详细信息 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - ad_id：元广告广告ID - 返回：指定广告的详细信息

mcp_meta_ads_get_ad_creatives

- 获取特定广告的创意细节 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - ad_id：元广告广告ID - 返回：创意细节，包括文本、图像和URL

mcp_meta_ads_create_ad_creative

- 使用上传的图像哈希创建新的广告创意 - 输入： - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - name：创意名称 - image_hash：上传图像的哈希值 - page_id：广告的Facebook页面ID - link_url：目标URL - message：广告文案/文字 - headline：简单广告的单个标题（不能与标题一起使用） - headlines：动态创意测试的标题列表（不能与标题一起使用） - description：简单广告的单一描述（不能与描述一起使用） - descriptions：动态创意测试的描述列表（不能与描述一起使用） - dynamic_creative_spec：动态创意优化设置 - call_to_action_type：CTA按钮类型（例如“LEARN_MORE”） - instagram_actor_id：可选的Instagram帐户ID - access_token （可选）：Meta API访问令牌 - 退货：确认新的创意细节

mcp_meta_ads_update_ad_creative

- 用新内容或设置更新现有广告创意 - 输入： - creative_id：要更新的元广告创意ID - name：新创意名称 - message：新广告文案/文本 - headline：简单广告的单个标题（不能与标题一起使用） - headlines：动态创意测试的新标题列表（不能与标题一起使用） - description：简单广告的单一描述（不能与描述一起使用） - descriptions：动态创意测试的新描述列表（不能与描述一起使用） - dynamic_creative_spec：新的动态创意优化设置 - call_to_action_type：新的行动呼吁按钮类型 - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - 退货：确认并更新创意细节

mcp_meta_ads_upload_ad_image

- 上传图像以用于元广告创意 - 输入： - account_id：元广告帐户ID（格式：act_XXXXXXXXX） - image_path：要上传的图像文件的路径 - name：图像的可选名称 - access_token （可选）：Meta API访问令牌 - 返回：包含图像详细信息（包括哈希）的JSON响应

mcp_meta_ads_get_ad_image

- 一步完成Meta广告图像的获取、下载和可视化 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - ad_id：元广告广告ID - 返回：广告图像已准备好进行直接视觉分析

mcp_meta_ads_update_ad

- 使用新设置更新广告 - 输入： - ad_id：元广告广告ID - status：更新广告状态（活动、暂停等） - bid_amount：以账户货币表示的投标金额（美元以美分表示） - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - 返回：带有更新的广告详细信息和确认链接的确认

mcp_meta_ads_update_adset

- 使用包括频率上限在内的新设置更新广告集 - 输入： - adset_id：元广告广告集ID - frequency_control_specs：频率控制规范列表 - bid_strategy：投标策略（例如，“LOWEST_COST_WIT_Bid_CAP”、“LOWEST \_COST_Wit_MIN_ROAS”） - bid_amount：投标金额（美分）。LOWEST_COST_WIT_BID_CAP、COST_CAP、TARGET_COST都是必需的。 - bid_constraints：LOWEST_COST_WITH_MIN_ROAS所需的投标约束条件（例如。， {"roas_average_floor": 20000}) - status：更新广告集状态（活动、暂停等） - targeting：目标设定规范，包括目标设定_自动化 - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - 返回：带有更新的广告集详细信息和确认链接的确认

mcp_meta_ads_get_insights

- 获取活动、广告集、广告或帐户的性能见解 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - object_id：活动、广告集、广告或帐户的ID - time_range：洞察的时间范围（默认值：最大值） - breakdown：可选细分维度（例如，年龄、性别、国家） - level：聚合级别（广告、广告集、活动、帐户） - action_attribution_windows （可选）：转换数据的归因窗口列表（例如，\[“1d_click”、“1d_view”、“7d_click“、”7d_view“\]）。指定后，actions和cost_per_action_type将为每个窗口包含其他字段。“value”字段始终显示7d_click归因。 - 返回：指定对象的性能指标

mcp_meta_ads_get_login_link

- 获取可点击的登录链接以进行Meta Ads身份验证 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - 返回：用于元身份验证的可点击资源链接

mcp_meta_ads_create_budget_schedule

- 为元广告活动制定预算计划 - 输入： - campaign_id：元广告活动ID - budget_value：预算增加额 - budget_value_type：预算值类型（“绝对”或“倍数”） - time_start：高需求期开始的Unix时间戳 - time_end：高需求期结束的Unix时间戳 - access_token （可选）：Meta API访问令牌 - 返回：带有创建的预算计划ID的JSON字符串或错误消息

mcp_meta_ads_search_interests

- 按关键字搜索兴趣定位选项 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - query：兴趣搜索词（例如，“棒球”、“烹饪”、“旅行”） - limit：要返回的最大结果数（默认值：25） - 返回：带有id、name、audience_size和path字段的兴趣数据

mcp_meta_ads_get_interest_suggestions

- 根据现有兴趣获取兴趣建议 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - interest_list：获取建议的兴趣名称列表（例如，\[“篮球”、“足球”\]） - limit：要返回的最大建议数（默认值：25） - 返回：带有id、name、audience_size和描述字段的建议兴趣

mcp_meta_ads_validate_interests

- 验证目标的兴趣名称或ID - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - interest_list：要验证的兴趣名称列表（例如\[“日本”、“篮球”\]） - interest_fbid_list：要验证的兴趣ID列表（例如，\[“6003700426513”\]） - 返回：验证结果显示每个兴趣的有效状态和audience_size

mcp_meta_ads_search_behaviors

- 获取所有可用的行为定位选项 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - limit：要返回的最大结果数（默认值：50） - 返回：具有id、name、audience_size边界、路径和描述的行为定位选项

mcp_meta_ads_search_demographics

- 获取人口定位选项 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - demographic_class：人口统计类型（“人口统计学”、“生活事件”、“行业”、“收入”、“家庭状态”、“用户设备”、“用户名”） - limit：要返回的最大结果数（默认值：50） - 返回：具有id、名称、audience_size边界、路径和描述的人口统计目标选项

mcp_meta_ads_search_geo_locations

- 搜索地理定位位置 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - query：地点搜索词（例如，“纽约”、“加利福尼亚”、“日本”） - location_types：要搜索的地点类型（\[“国家”、“地区”、“城市”、“邮政编码”、“地理市场”、“electoral_district”\]） - limit：要返回的最大结果数（默认值：25） - 返回：包含键、名称、类型和地理层次信息的位置数据

mcp_meta_ads_search （增强）

- 跨帐户、活动、广告和页面的通用搜索 - 当查询提到“页面”或“页面”时，自动包括页面搜索 - 输入： - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌） - query：搜索查询字符串（例如，“伤害赔偿页面”、“活动活动”） - 返回：ChatGPT兼容格式的匹配记录ID列表

许可

Meta Ads MCP根据商业来源许可证1.1，这意味着：

✅ 免费使用 用于个人和商业目的
✅ 修改和自定义 根据需要
✅ 重新分配 其他人
✅ 完全开源 （Apache 2.0）2029年1月1日

唯一的限制是，您不能将其作为竞争性托管服务提供。有关商业许可的问题，请联系我们。

隐私与安全

Meta Ads MCP遵循安全令牌管理和自动身份验证处理的安全最佳实践。

远程MCP：所有身份验证都在云中安全处理，不需要本地令牌存储
本地安装：令牌安全地缓存在本地计算机上

测试

基本测试

测试您与任何MCP客户端的Meta Ads MCP连接：

验证帐户访问权限：请您的法学硕士使用 mcp_meta_ads_get_ad_accounts
检查帐户详细信息：使用 mcp_meta_ads_get_account_info 使用您的帐户ID
列出活动：试试 mcp_meta_ads_get_campaigns 查看您的广告活动

有关详细的本地安装测试，请参阅源代码存储库。

故障排除

💡 快速修复：跳过技术设置！

避免任何设置问题的最简单方法是 🎯 请改用我们的远程MCP.无需下载，无需配置-只需连接您的广告帐户，即可立即开始获取有关您的广告系列的人工智能见解！

本地安装问题

有关本地安装问题，请参阅源代码存储库。 为了获得最简单的体验，我们建议使用远程MCP 相反。

Meta Ads MCP

快速接入

详细介绍