Meta Ads MCP by Markifact

Meta Ads MCP 服务

适用于 Claude、ChatGPT、Codex、Cursor 和任何 MCP 客户端的 Meta Ads MCP 服务。提供 85 项 Meta Ads 操作：40 项可即时运行的读取操作，以及 45 项需等待你批准的写入操作。托管式服务，只需登录一次 OAuth，无需在本地安装。

• 设置指南： markifact.com/meta-ads-mcp
• 端点： https://api.markifact.com/mcp/meta-ads

这是 Markifact MCP 服务的 Meta Ads 端点。它是完整的 Markifact 服务，以 Meta Ads 作为入口，因此使用同一登录也能访问 Markifact 连接的所有其他平台，从 Meta 和 Google Analytics 到 Sheets 和 Slack。如果你只使用 Meta Ads，这就是你需要安装的服务。

你可以做什么

• 报告。 按版位、设备、年龄、性别、国家和小时细分的广告系列、广告组和广告效果；归因窗口；ROAS 和频次等计算指标；以及目标结果。
• 更改。 创建和更新广告系列、广告组和广告，包括 Advantage+ 设置。支持单图、视频、轮播、目录和 Instagram 帖子素材，并可上传媒体。可设置预算、出价、状态、排期、定向和地区法规字段。
• 受众和素材。 自定义受众、类似受众和已保存受众、潜在客户表单、目录和商品集、媒体库、广告审核反馈，以及与广告账户关联的主页和 Instagram 账户。
• 诊断。 Pixel 和 Conversions API 设置检查、未获批准的原因、广告级审核反馈，以及用于竞品调研的 Meta Ad Library。

安装

先在 markifact.com 注册（包含免费额度），然后在连接页面连接 Meta Ads，最后将服务添加到你的客户端。Meta Ads MCP 设置指南也提供了相同步骤和截图。

客户端	步骤
Claude（网页版和桌面版）	Settings → Connectors → Add custom connector → URL https://api.markifact.com/mcp/meta-ads → Connect，然后登录
Claude Code	执行 claude mcp add --transport http meta-ads https://api.markifact.com/mcp/meta-ads，或先执行 claude plugin marketplace add markifact/markifact-mcp，再执行 /plugin install meta-ads@markifact
ChatGPT 和 Codex	从 Plugin Directory 安装 Markifact 插件，然后使用 @Markifact 调用
Cursor	Settings → MCP → Add server → URL https://api.markifact.com/mcp/meta-ads（或将此仓库中的 mcp.json 复制到 ~/.cursor/mcp.json）
Codex CLI	添加到 ~/.codex/config.toml：[mcp_servers.meta_ads]，然后添加 url = "https://api.markifact.com/mcp/meta-ads"
Gemini CLI	执行 gemini extensions install github.com/markifact/meta-ads-mcp
Windsurf	将 mcp.json 中的代码片段添加到你的 MCP 配置中
任何 MCP 客户端	使用 https://api.markifact.com/mcp/meta-ads 的 Streamable HTTP；支持使用 PKCE 的 OAuth 2.1 和动态客户端注册

各客户端的详细说明见 docs/clients.md。每个客户端都通过同一个浏览器登录流程完成登录；服务绝不会在聊天中向你索要 API 密钥或令牌。

可用的提示词

按广告组查看每周效果

Pull Meta Ads performance by ad set for the last 7 days versus the previous 7. Include spend, impressions, CPM, CTR, results, cost per result and ROAS. Flag anything with cost per result up more than 25%. Do not make changes.

素材疲劳度

Which ads in the "Prospecting" campaign have frequency above 3 and CTR down more than 20% over the last 14 days? List them with spend and results.

版位细分

Break down last month's spend and results by placement for the whole account. Which placements have the worst cost per result?

创建广告系列并暂停

Create a Meta Advantage+ sales campaign for our Black Friday creative. Budget $200 a day, target US, use the uploaded video, and leave it paused so I can review it before it goes live.

预览后暂停

List active ad sets with cost per result above $80 over the last 14 days, then pause them. Show me the list and wait for my approval before pausing anything.

请说明账户、日期范围和指标；写入前先要求读取，并明确是否允许进行更改。

写入操作的工作方式

每项写入操作都必须经过审批。客户端请求更改后，服务会准备更改并显示确切的目标（账户、广告系列 ID、当前值、拟议值）；只有在你确认后，操作才会执行。读取操作无需确认。服务只能访问已获授权的 Meta Ads 登录账号所能查看的账户。

操作（85）

根据 Markifact 操作注册表生成。

操作	功能说明	类型
meta_ads_check_catalog_diagnostics	检查 Meta 目录的数据质量、政策和 Feed 问题，并返回按严重程度和受影响对象汇总的诊断问题组…	读取
meta_ads_create_ad_creative	根据原始创意载荷创建 Meta 广告创意，并返回新的 creative_id。	写入，需审批
meta_ads_create_ad_from_creative	根据现有广告创意 ID 创建新的 Meta 广告。	写入，需审批
meta_ads_create_ad_from_post	根据现有 Facebook 公共主页帖子或 Instagram 媒体创建 Meta 广告（不上传媒体，不撰写文案）。	写入，需审批
meta_ads_create_adset	在 Meta Ads 中创建新的广告组，并设置预算、定向、优化和推广对象。	写入，需审批
meta_ads_create_campaign	在 Meta Ads 中创建新的广告系列，可自定义目标、预算、定向和排期等设置。	写入，需审批
meta_ads_create_carousel_ad	创建新的 Meta 轮播广告，包含 2-10 张图片或视频卡片（仅批量模式）。	写入，需审批
meta_ads_create_catalog_ad	通过商品集创建 Advantage+ Catalog / 动态广告（轮播或单图）（批量模式）。	写入，需审批
meta_ads_create_experiment	使用现有广告系列/广告组变体创建原生 Meta A/B 拆分测试或广告研究，包括即时表单。	写入，需审批
meta_ads_create_flexible_ad	创建包含多种媒体（最多 10 个）和多种文案（每种最多 5 条）的灵活广告。	写入，需审批
meta_ads_create_product_set	低级工具，根据原始 Meta 筛选条件在目录中创建 Meta 商品集，并将筛选条件原样传递给 Meta。	写入，需审批
meta_ads_create_single_image_ad	使用单张图片创意素材创建新的 Meta 广告。	写入，需审批
meta_ads_create_single_video_ad	使用单个视频创意素材创建新的 Meta 广告。	写入，需审批
meta_ads_delete_product_set	永久删除目录中的 Meta 商品集。	写入，需审批
meta_ads_duplicate_ad	复制现有 Meta 广告，可选创意增强控制，并可将副本移至其他广告组。	写入，需审批
meta_ads_duplicate_adset	通过复制现有广告组创建新的 Meta Ads 广告组，可选择复制关联广告或移至其他广告系列。	写入，需审批
meta_ads_duplicate_campaign	通过复制现有广告系列创建新的 Meta Ads 广告系列，可选择复制关联广告组和广告。	写入，需审批
meta_ads_generate_ad_previews	生成 Meta 广告系列和广告创意的预览 iframe URL，适用于所选版位，如 INSTAGRAM_FEED、FACEBOOK_FEED、…	读取
meta_ads_get_account_details	获取 Meta Ads 账户详细信息，包括状态、时区、货币、企业信息、支出限额和设置。	读取
meta_ads_get_account_history	获取 Meta 广告账户的历史活动和更改记录。	读取
meta_ads_get_ad	按 ID 获取一条 Meta 广告及其状态、审核反馈（按政策和版位列出的拒登原因）、投放问题、…	读取
meta_ads_get_ad_creative	按 ad_id 或 creative_id 获取 Meta 广告创意，并返回原始创意载荷。	读取
meta_ads_get_adset_settings	获取 Meta Ads 广告组设置和配置，包括预算、定向、优化、出价策略以及所有广告组级别的…	读取
meta_ads_get_campaign_settings	获取 Meta Ads 广告系列设置和配置，包括预算、状态、目标、出价策略以及所有广告系列级别的…	读取
meta_ads_get_experiment	读取原生 Meta A/B 实验或广告研究、测试单元及可用的衡量结果。	读取
meta_ads_get_media_details	使用 image_hash 或 video_id 获取 Meta 图片和视频的媒体详细信息。	读取
meta_ads_get_product_details	按零售商 ID（SKU）或 Meta 商品 ID 获取单个 Meta 目录商品的完整详细信息，包括审核状态和拒绝原因。	读取
meta_ads_get_report	获取 Meta Ads（Facebook/Instagram）数据，可自定义指标、维度、筛选条件、日期范围、排序选项和内置…	读取
meta_ads_library	搜索并获取 Meta 广告资料库中的广告，以监测竞争对手。	读取
meta_ads_list_account_block_lists	获取 Meta Ads 账户的发布商屏蔽名单，并可筛选已应用的名单。	读取
meta_ads_list_ads	列出 Meta 广告账户中的广告，可选择仅列出某个广告组或广告系列中的广告；涵盖所有状态，包括已暂停广告，并包含创意…	读取
meta_ads_list_adsets	列出广告账户中的所有广告组及其状态和日期。	读取
meta_ads_list_campaigns	列出广告账户中的所有广告系列及其状态和日期。	读取
meta_ads_list_catalogs	列出已连接用户可访问的 Meta 目录。	读取
meta_ads_list_experiments	列出企业组合拥有的原生 Meta A/B 测试、拆分测试和广告研究。	读取
meta_ads_list_instagram_accounts	列出 Meta Ads 连接中关联到 Facebook 公共主页的 Instagram 账户，以及每个账户关联的公共主页。	读取
meta_ads_list_instagram_media	列出 Meta Ads 连接中 Instagram 账户的帖子（Reels、动态帖子、快拍），包括永久链接、短代码和媒体 ID、…	读取
meta_ads_list_media	列出 Meta 广告账户的媒体库（视频和图片），可选择由 Meta 在源端按名称/文件名搜索。	读取
meta_ads_list_pages	列出 Meta Ads 连接中可用的 Facebook 公共主页及其 ID。	读取
meta_ads_list_product_sets	列出 Meta 目录中的商品集及其筛选条件和商品数量。	读取
meta_ads_list_products	列出或搜索 Meta 目录中的商品，可选原始 Meta 筛选条件。	读取
meta_ads_list_report_fields	在运行报告前搜索并浏览可用的 Meta Ads 报告指标和维度。	读取
meta_ads_rename_ad	重命名 Meta Ads 广告以更新其显示名称。	写入，需审批
meta_ads_rename_adset	重命名 Meta Ads 广告组以更新其显示名称。	写入，需审批
meta_ads_rename_campaign	重命名 Meta Ads 广告系列以更新其显示名称。	写入，需审批
meta_ads_replace_ad_creative	将现有创意（按 creative_id）附加到现有广告（按 ad_id），替换之前附加的创意。	写入，需审批
meta_ads_search_targeting	搜索 Meta Ads 定向选项：地理位置（国家、城市、地区、邮编）、语言、兴趣、教育…	读取
meta_ads_select_accounts	选择 Meta Ads 账户一次，并在多个 meta_ads_get_report 节点中重复使用，无需重复选择账户。	读取
meta_ads_update_ad	Meta Ads 广告补丁备用工具，用于广告级别的高级或不受支持的操作，例如重命名广告、更改…	写入，需审批
meta_ads_update_ad_status	更新 Meta Ads 广告的状态（有效、已暂停或已删除），以便管理广告。	写入，需审批
meta_ads_update_adset	Meta Ads 广告组补丁备用工具，用于高级或不受支持的操作。	写入，需审批
meta_ads_update_adset_audiences	更新 Meta Ads 广告组的受众定向：自定义受众、类似受众、兴趣、行为、教育、工作、收入、…	写入，需审批
meta_ads_update_adset_bid_value	更新 Meta Ads 广告组的出价金额（Bid Cap / Cost Cap）或最低 ROAS。	写入，需审批
meta_ads_update_adset_budget	更新 Meta Ads 广告组的预算（日预算或总预算），以便管理预算。	写入，需审批
meta_ads_update_adset_language	更新 Meta Ads 广告组的语言定向（地区设置）。	写入，需审批
meta_ads_update_adset_locations	为 Meta Ads 广告组添加或排除地理位置定向。	写入，需审批
meta_ads_update_adset_placements	更新 Meta Ads 广告组的版位定向。	写入，需审批
meta_ads_update_adset_schedule	更新 Meta Ads 广告组的 start_time 和/或 end_time（排期）。	写入，需审批
meta_ads_update_adset_status	更新 Meta Ads 广告组的状态（有效、已暂停或已删除），以便管理广告组。	写入，需审批
meta_ads_update_campaign	Meta Ads 广告系列补丁备用工具，用于高级或不受支持的操作，例如支出上限、特殊广告类别、推广对象或单个广告…	写入，需审批
meta_ads_update_campaign_bidding_strategy	更新 Meta Ads 广告系列的出价策略。	写入，需审批
meta_ads_update_campaign_budget	更新 Meta Ads 广告系列的预算（日预算或总预算），以便管理预算。	写入，需审批
meta_ads_update_campaign_status	更新 Meta Ads 广告系列的状态（有效、已暂停或已删除），以便管理广告系列。	写入，需审批
meta_ads_update_experiment	使用 Meta 的更新参数更新原生 Meta A/B 实验或广告研究，例如名称、排期、测试单元或目标。	写入，需审批
meta_ads_update_product_set	更新 Meta 商品集的名称、原始 Meta 筛选条件或两者。	写入，需审批
meta_ads_update_products	低级批量工具，通过原样发送原始 Meta items_batch 请求来创建、更新或删除目录商品。	写入，需审批
meta_ads_upload_media	将单张图片或视频上传到 Meta 广告账户，并返回其媒体引用（图片为 image_hash，视频为 video_id 和自动生成的…）	写入，需审批
meta_check_capi_health	检查 Meta Ads 像素的 Conversions API（CAPI）健康指标，包括事件匹配质量、服务器端跟踪、覆盖率、…	读取
meta_create_custom_audience	在广告账户中创建 Meta 自定义受众。	写入，需审批
meta_create_custom_conversion	在广告账户中创建 Meta 自定义转化，由像素事件或 URL 规则定义（例如	写入，需审批
meta_create_lead_form	在 Facebook 公共主页上创建 Meta 即时表单（潜在客户开发表单），用于潜在客户广告系列，包含联系字段、自定义资格问题、…	写入，需审批
meta_create_lookalike_audience	根据现有来源自定义受众创建 Meta 类似受众。	写入，需审批
meta_get_custom_audience	按 ID 获取单个 Meta 自定义受众或类似受众及其完整定义：网站或互动规则、类似受众规格和…	读取
meta_get_lead_form	获取单个 Meta 即时表单（潜在客户开发表单）的完整配置：问题、介绍卡片、感谢页面、隐私政策、…	读取
meta_get_pixel_details	获取特定 Meta Ads 跟踪像素的详细信息，包括配置。	读取
meta_get_pixel_stats	获取 Meta Ads 像素的统计数据，支持多种聚合类型和可选日期筛选。	读取
meta_list_account_pixels	列出连接到 Meta Ads 账户的所有像素及其跟踪和配置信息。	读取
meta_list_custom_audiences	列出 Meta Ads 账户中的自定义受众和类似受众。	读取
meta_list_custom_conversions	列出 Meta Ads 账户中配置的所有自定义转化。	读取
meta_list_lead_forms	列出 Facebook 公共主页中的所有潜在客户开发表单。	读取
meta_list_promotable_apps	列出 Meta Ads 账户可推广的应用（ID、名称、平台、商店 URL、应用事件）。	读取
meta_list_saved_audiences	列出 Meta Ads 账户中已保存的受众（可重复使用的定向预设），包括完整的定向规格、可读的定向…	读取
meta_retrieve_leads	获取 Meta Ads（Facebook 和 Instagram）潜在客户开发广告系列的潜在客户表单提交内容。	读取
meta_update_custom_audience	更新 Meta 自定义受众（重命名、描述、网站规则、保留期限、退出链接、客户文件来源、类似受众规格、…）	写入，需审批
meta_update_lead_form_status	更新 Meta 即时表单（潜在客户开发表单）的状态：ACTIVE、ARCHIVED、DELETED 或 DRAFT。	写入，需审批
该服务公开了十个 MCP 工具。find_operations 用于搜索此列表，get_operation_inputs 返回确切的输入架构，run_operation 执行读取操作，run_write_operation 执行需经批准的写入操作。其余工具用于处理连接、文件和媒体上传。架构说明见主仓库。

相关内容

• Meta Ads MCP 设置指南
• 官方 Meta Ads MCP 与其他方案的对比
• 将 Meta Ads 连接到 Claude
• 将 Meta Ads 连接到 ChatGPT
• 在 Claude Code 中使用 Meta Ads MCP
• 在 Codex 中使用 Meta Ads MCP

常见问题

我需要 Meta 开发者应用或系统用户令牌吗？

不需要。Markifact 是 Meta 认可的技术服务提供商，服务运行在 Markifact 的基础设施上。你只需授权已能访问广告账户的 Facebook 登录账号，服务只能访问该账号可见的内容。

可以上传广告素材吗？

可以。通过客户端上传图片和视频，服务会将其添加到新广告或现有广告中。也支持目录和 Instagram 帖子素材。

可以更改我的广告系列吗？

可以，而且每项更改都会预览，并在聊天中等待你批准。读取操作会立即执行。未经确认，不会写入任何内容。

哪些 AI 客户端可用？

任何支持 OAuth 的 MCP 客户端都可以：Claude（网页、桌面、Code）、ChatGPT 和 Codex、Cursor、Windsurf、Gemini CLI 等。各客户端的安装步骤见上文。

费用是多少？

该服务可免费安装。使用时需要 Markifact 账户，账户初始提供免费额度。套餐详情见定价页面。

支持与政策

请发送邮件至 [email protected] 或提交 issue。另请参阅 SECURITY.md、PRIVACY.md 和 TERMS.md。本项目采用 MIT 许可证。