最后更新:2026-11-16(Meta、Anthropic、OpenAI 官方文档均于当天查阅)
按 如何将 Claude 链接到 Facebook 广告 操作后,最常见的不是「不会接」,而是「接了用不了」。这篇把我们实际遇到的报错整理成清单,按「症状 → 原因 → 修复」逐项排查。
先看症状
| 症状 | 最可能的原因 | 怎么修 |
|---|---|---|
| OAuth 弹窗后报回调错误 | Meta 应用里没登记客户端的回调地址 | 在 Facebook 登录(企业版)设置里登记对应地址 |
| 401 / 认证失败 | 令牌过期、权限不全,或 headers 里变量没展开 | 检查令牌;用自定义变量名 |
| 系统用户令牌被拒 | 用了管理员角色系统用户 | 改用员工角色系统用户 |
| 看不到某个广告户 | 令牌或授权里没分配这个帐户 | 在企业管理平台给系统用户分配资产 |
| 工具很少或缺工具 | 权限不够,或该工具还在逐步开放 | 补充权限;问 Claude 当前有哪些工具 |
| 调用一半失败 / 613 | 触发 Marketing API 频率限制 | 放慢速度,按错误码退避 |

第 1 步:确认服务器能连通
Claude Code 里先跑:
claude mcp list # 看 meta-ads 是 ✔ Connected、! Needs authentication 还是 ✘ Failed to connect
claude mcp get meta-ads # 失败时 Issue: 行会显示 HTTP 状态码或错误码
# 交互模式里输入 /mcp,可以重新认证、查看工具数量claude mcp list 会显示每个服务器的健康状态;失败时会附上 HTTP 状态或错误码(Claude Code MCP)。用令牌方式时,也可以直接用 Meta 文档里的请求测试令牌本身是否有效(广告 MCP 入门):
curl -i -X POST "https://mcp.facebook.com/ads" \
-H "Authorization: Bearer $META_ADS_MCP_TOKEN" \
--data-raw '{"jsonrpc":"2.0","method":"tools/list","id":1}' 第 2 步:OAuth 回调地址
Meta 要求你的应用在「Facebook 登录(企业版)」设置里配置与所用 MCP 客户端对应的回调地址(广告 MCP 入门)。Claude 网页版/桌面版使用自有 OAuth 客户端时,要登记 https://claude.ai/api/mcp/auth_callback(Claude 自定义连接器)。另外检查:命令里的 --client-id 是不是 Meta 应用 ID,应用里是否已添加「Create & manage ads with ads MCP server」用例。
第 3 步:令牌与权限
| 权限 | 作用 |
|---|---|
| ads_mcp_management | 使用广告 MCP 服务器(必需) |
| ads_read 或 ads_management | 读取/管理广告(至少其一) |
| catalog_management | 目录相关工具 |
| business_management | 企业层级资产 |
| pages_show_list、instagram_basic | 主页与 Instagram 相关工具 |

来源:广告 MCP 入门。两个高频坑:
- 只支持员工角色的系统用户令牌,管理员角色系统用户令牌无法访问广告 MCP 服务器。
- 代理商用自己的应用替客户连接,需要为
ads_mcp_management申请高级访问并通过应用审核( - Meta 开发者博客
- )。
第 4 步:环境变量「读成空」
在 .mcp.json 的远程服务器 url 和 headers 里,Claude Code 会把 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、NPM_TOKEN 等凭证变量读成空值,服务器收到的是 Bearer ,通常返回 401。解决方法:把 Meta 令牌放进自己命名的变量,比如 META_ADS_MCP_TOKEN。变量没设置时,claude mcp list 会警告;粘贴令牌带了换行,也会提示「Leading or trailing whitespace」(Claude Code MCP)。
{
"mcpServers": {
"meta-ads": {
"type": "http",
"url": "https://mcp.facebook.com/ads",
"headers": { "Authorization": "Bearer ${META_ADS_MCP_TOKEN}" }
}
}
}第 5 步:工具不显示或不全
- 补全权限:更多权限会解锁更多工具(见上表)。
- Meta 表示会逐步向广告户开放工具,可以直接问 Claude「我现在能用哪些工具」(
- Meta 开发者博客
- )。
- 检查 Claude Code 权限规则是否把工具 deny 了,或 Agent SDK 用了 strict 配置。
第 6 步:超时、输出太长与限流
- 启动超时:
MCP_TIMEOUT=10000 claude可设置 10 秒启动超时。 - 输出过长:工具输出超过 1 万 token 会警告,默认上限 2.5 万,可用
MAX_MCP_OUTPUT_TOKENS调整( - Claude Code MCP
- )。报表类请求尽量缩小日期范围和字段。
- 频率限制:同一对象每 30 秒只能改一次,同一广告组预算每小时最多改 4 次,帐户级写入每秒 100 次(
- Rate limiting
- )。
第 7 步:「规则」相关报错
如果你的企业开通了广告 MCP 规则(ads MCP server rules),某些动作会被规则拒绝——这是预期行为,不是故障。规则目前为有限开放,未开通的企业通过 API 设置时会返回错误码 10(ads MCP rules)。
熊猫出海如何用 Claude、Codex 和 Facebook 广告户提升客户投放效率
这篇讲的是 Claude,但在实际服务中,熊猫出海会把 Claude、Codex 和 Facebook 企业广告户组合起来,帮助出海企业更快完成「建户 → 搭结构 → 上素材 → 看数据 → 调预算」这一整套重复工作,把投放团队的时间留给策略和素材判断。
- 广告户:使用企业自己的 Facebook 广告帐号,或通过熊猫出海的开户服务合规开通的企业户;帐号归企业所有,不出租、不共享。
- Claude:适合读长文档与报表、写投放方案和文案初稿、通过 Meta 广告 MCP 在暂停状态下起草广告结构、按规则做异常排查。
- Codex:适合写和维护自动化脚本(Marketing API、Insights 日报、批量上传、预算规则),在沙盒里运行并接入定时任务或 CI。
- 人工把关:所有会花钱的动作(激活广告、提高预算)都由投手审核后执行;Meta 广告政策与素材合规由人工最终确认。
这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 Meta、Anthropic 或 OpenAI 的官方合作伙伴。想了解开户与代投放流程,请看 Facebook 海外企业户开户与投放(熊猫出海服务页)。
常见问题
换了电脑后 Claude 又要重新登录?
OAuth 登录按服务器地址和配置范围保存;同名服务器在不同作用域指向不同地址时,需要分别登录。
令牌多久过期?
取决于令牌类型和生成方式,以 Meta 的系统用户与访问令牌文档为准。
Claude 网页版连不上但 Claude Code 能连?
网页版从 Anthropic 云端连接,并使用 claude.ai 的回调地址;检查 Meta 应用里是否登记了这个地址。
报错里出现 80004?
这是业务用例频率限制,等待后重试并减少调用频率。
能不能用别人的广告户测试?
不要。只连接你自己企业的或已获授权的帐户。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的广告帐号、主页与像素,通过 Meta 官方 Marketing API、Ads MCP 服务器或 Ads CLI 接入,使用业务管理平台(Business Manager)中的系统用户与最小权限,遵守 Meta 速率限制与《广告发布标准》,并在任何会产生花费的操作前保留人工审核。熊猫出海不出售、出租、共享或转让广告帐号、BM 或 API 密钥,不协助规避广告审核、地区限制、KYC、企业验证或支付管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。
相关阅读
- Facebook 海外企业户开户与投放(熊猫出海服务页)
- 海外 AI Token 服务:帐号开通 + API 接入(熊猫出海)
- 如何将 Claude 链接到 Facebook 广告(Meta 广告 MCP 教程)
- Claude 操作 Facebook 广告投放全流程自动化:端到端流水线
- 系統使用者權杖排錯(繁體)
- Meta 开发了 MCP:让 AI 直接操作你的广告投放
- MCP 安全指南:AI Agent 工具调用权限最小化
- 大模型 API Key 申请与安全管理
联系熊猫出海:Facebook 开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(建户结构、素材、日报还是预算规则)。我们先做资质与素材预审,再协助开通合规的 Facebook 企业广告户,并用 Claude、Codex 搭建在你自有帐号上运行的自动化流程。我们不出售、出租或共享任何广告帐号。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- Meta: Ads MCP server – get started
- Meta for Developers blog: ads MCP server available for developers (2026-07-16)
- Meta: Ads MCP server rules best practices
- Claude Help Center: custom connectors using remote MCP
- Anthropic: Connect Claude Code to tools via MCP
- Meta: Marketing API rate limiting
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

微信扫一扫打赏
支付宝扫一扫打赏
