使用说明

元广告MCP

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

免责声明： 这是一个非官方的第三方工具，与Meta没有任何关联、认可或附属关系。该项目独立维护，并根据Meta的服务条款使用Meta的公共API。Meta、Facebook、Instagram和其他Meta品牌名称是其各自所有者的商标。

社区与支持

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广告活动，获取绩效见解，并管理您的广告。

对于游标用户

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

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

对于其他MCP客户端

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

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

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

如果您是开发人员或需要自定义安装，可以在本地运行Meta Ads MCP。 大多数营销人员应该使用上面的远程MCP！ 有关完整的技术设置说明，请参阅我们的 本地安装指南.

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

快速本地设置

# Install via uvx (recommended)
uvx meta-ads-mcp

# Set your Pipeboard token
export PIPEBOARD_API_TOKEN=your_pipeboard_token

# Add to your MCP client configuration

有关详细的分步说明、身份验证设置、调试和故障排除，请访问 位置_安装.md.

特性

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

配置

远程MCP（推荐）

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

本地安装（技术用户）

有关本地安装配置、身份验证选项和高级技术设置，请参阅我们的 本地安装指南.

可用的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：以账户货币表示的投标金额（美分）
  - bid_strategy：投标策略（例如“LOWEST_COST”）
  - 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”）
  - bid_amount：以账户货币表示的投标金额（美元以美分表示）
  - status：更新广告集状态（活动、暂停等）
  - targeting：目标设定规范，包括目标设定_自动化
  - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌）
- 返回：带有更新的广告集详细信息和确认链接的确认
mcp_meta_ads_get_insights
- 获取活动、广告集、广告或帐户的性能见解
- 输入：
  - access_token （可选）：Meta API访问令牌（如果未提供，将使用缓存令牌）
  - object_id：活动、广告集、广告或帐户的ID
  - time_range：洞察的时间范围（默认值：最大值）
  - breakdown：可选细分维度（例如，年龄、性别、国家）
  - level：聚合级别（广告、广告集、活动、帐户）
- 返回：指定对象的性能指标
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.无需下载，无需配置-只需连接您的广告帐户，即可立即开始获取有关您的广告系列的人工智能见解！

本地安装问题

有关全面的故障排除、调试和本地安装问题，请参阅我们的 本地安装指南 其中包括：

身份验证故障排除
安装问题和解决方案
API错误解析
调试日志和诊断命令
性能优化提示

Meta广告管理协议服务器

使用说明

元广告MCP

社区与支持

目录

远程MCP入门（推荐）

适用于Claude Pro/Max用户

对于游标用户

对于其他MCP客户端

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

快速本地设置

特性

配置

远程MCP（推荐）

本地安装（技术用户）

可用的MCP工具

许可

隐私与安全

测试

基本测试

故障排除

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

本地安装问题

使用说明

元广告MCP

社区与支持

目录

远程MCP入门（推荐）

适用于Claude Pro/Max用户

对于游标用户

对于其他MCP客户端

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

快速本地设置

特性

配置

远程MCP（推荐）

本地安装（技术用户）

可用的MCP工具

许可

隐私与安全

测试

基本测试

故障排除

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

本地安装问题

相关 MCP

实时金融新闻分析服务

梦幻足球分析服务器

浏览器调试协议服务

报告生成服务

Meta广告管理MCP服务

Kubernetes调试服务