AI导哈

Meta广告管理器MCP

一个用于从Claude直接创建和管理Meta（Facebook/Instagram）广告活动的开源MCP服务器，提供广告活动创建、报告、批量操作、预算控制和安全工具。

  • by attainmentlabs
  • Python
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 attainmentlabs/meta-ads-mcp

使用说明

元广告经理mcp

MCP服务器，用于直接从Claude创建和管理Meta（Facebook/Instagram）广告活动。告诉克劳德你想要什么。它部署。

建造于 成就实验室.

Meta Ads生态系统中的地位

这是一个早期的独立开源Meta Ads MCP服务器，首次发布于2026年2月，之后Meta推出了其官方的Ads AI连接器和托管的Ads MCP端点。

如果您希望Meta托管OAuth和第一方支持，请使用Meta的官方连接器。如果您想要一个轻量级的、自我管理的MCP服务器，您可以使用自己的Meta应用程序凭据进行检查、分叉和运行，请使用此项目。

相关：

它做什么

将此服务器添加到您的Claude配置中。您将获得活动创建、报告、批量操作、预算控制和安全工具：

工具 它做什么
create_meta_campaign 创建完整的活动：活动、广告集、创意和广告
get_ad_account_summary 确认已连接的广告帐户、货币、时区、支出、余额和状态
list_campaigns 列出配置的广告帐户中最近的活动
list_ad_sets 列出配置的广告帐户中最近的广告集
list_ads 在配置的广告帐户中列出最近的广告
get_campaign_status 检查活动的状态、广告集和广告
get_meta_insights 提取帐户、活动、广告集或广告效果见解
upload_ad_image 上传图像并返回创意的图像哈希值
update_daily_budget 更新活动或广告集每日预算
bulk_update_campaign_status 批量暂停、激活或删除活动
pause_campaign 暂停直播活动
activate_campaign 激活暂停的活动
delete_campaign 永久删除活动

所有活动都创建为 已暂停 默认情况下。你在消费前要进行审查。

安全控制：

  • dry_run=True 默认情况下，在活动创建、媒体上传、预算更新和批量状态更改时。
  • confirm=True 是实时活动创建、上传、预算更新、激活、删除和批量状态更改所必需的。
  • META_ADS_MAX_DAILY_BUDGET_CENTS 可以限制活动和广告设置的每日预算。
  • META_ADS_AUDIT_LOG_PATH 可以设置JSONL审计日志路径。默认值为 ~/.meta-ads-mcp/audit.jsonl.

安装

选项1：让克劳德为你设置（最简单）

如果你使用 克劳德代码，粘贴此提示：

“为我设置元广告mcp：https://github.com/attainmentlabs/meta-ads-mcp"

Claude将检查您的环境，逐步指导您获取Meta凭据，编辑您的 ~/.mcp.json，并确认何时完成。没有要阅读的文档。

选项2:uvx（推荐，无需安装）

# No setup required. uvx runs it directly

添加 ~/.mcp.json:

{
  "mcpServers": {
    "meta-ads": {
      "command": "uvx",
      "args": ["meta-ads-manager-mcp"],
      "env": {
        "META_ACCESS_TOKEN": "your-token-here",
        "META_AD_ACCOUNT_ID": "your-account-id",
        "META_PAGE_ID": "your-page-id",
        "META_ADS_MAX_DAILY_BUDGET_CENTS": "5000"
      }
    }
  }
}

选项2:pip安装

pip install meta-ads-manager-mcp

然后在 ~/.mcp.json:

{
  "mcpServers": {
    "meta-ads": {
      "command": "meta-ads-manager-mcp",
      "env": {
        "META_ACCESS_TOKEN": "your-token-here",
        "META_AD_ACCOUNT_ID": "your-account-id",
        "META_PAGE_ID": "your-page-id",
        "META_ADS_MAX_DAILY_BUDGET_CENTS": "5000"
      }
    }
  }
}

凭证

你需要Meta中的三个值。完整的分步演练： 设置.md

变量 在哪里可以找到它
META_ACCESS_TOKEN 图形API资源管理器。长寿命代币 ads_management 许可
META_AD_ACCOUNT_ID 业务经理：广告账户。只有数字，没有 act_ 前缀
META_PAGE_ID Facebook页面：关于→ 页面透明度→ 页面ID
META_ADS_MAX_DAILY_BUDGET_CENTS 可选每日预算护栏
META_ADS_AUDIT_LOG_PATH 可选JSONL审核日志路径

访问令牌将在60天后过期。看 设置.md 对于交换流。

用法示例

服务器连接后，只需描述您想要什么：

创建活动：

“针对25-40岁的美国健身爱好者创建一个Meta活动。每日预算30美元。请使用/Users/me/ads/hero.jpg上的图片。复制：“追踪每一个重复。击中每一个目标。标题：“FitCommit AI”。CTA：了解更多。链接到fitcommit.ai。”

检查状态：

“120243616427570285活动的状态如何？”

列出活动：

“列出我最近的Meta活动。”

获取见解：

“按广告系列显示过去7天的Meta广告帐户见解。”

安全更新预算：

“模拟预算更新，将广告集120243616427570285设置为每天30美元。”

批量暂停：

暂停这三个战役：111222333

暂停：

“暂停活动120243616427570285。”

激活

“启用活动120243616427570285。”

删除：

“删除活动120243616427570285。”

dry_run模式

create_meta_campaign, upload_ad_image, update_daily_budget，以及 bulk_update_campaign_status 默认为 dry_run=True。这模拟API调用并返回伪造的ID或计划的更改，而无需发出请求或花钱。

对于实时更改，请设置 dry_run=False 和 confirm=True.

activate_campaign 和 delete_campaign 还要求 confirm=True.

YAML工作流

更喜欢将活动编写为配置文件？使用 元广告cli，配套的CLI工具。

需求

  • Python 3.10+
  • uv 对于uvx安装路径
  • 具有广告帐户和Facebook页面的Meta Business Manager帐户

许可证

麻省理工学院

相关 MCP