元广告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
本地安装（仅限技术用户）
如果您是开发人员或需要自定义安装，可以在本地运行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错误解析
- 调试日志和诊断命令
- 性能优化提示