如何用 Codex 连接 Meta Ads MCP：从安装到首次广告分析

这篇教程带你使用 Codex 连接 Meta 官方 Ads MCP。完成后，你可以在 Codex 中列出自己有权访问的 Meta 广告账户，并查询 Facebook、Instagram 等版位的广告表现。

整个连接过程通常需要 5–10 分钟，无需编写代码或创建 Meta Developer App，也不要把 Meta 密码或 Token 粘贴到 Codex 中。

完成后你会得到什么

• Codex 的 MCP 列表中显示 Meta Ads 已连接。
• Codex 能列出你有权限访问的 Meta 广告账户。
• Codex 能按广告账户的时区和币种返回最近 7 个完整自然日的广告表现。
• 第一次查询只读取数据，不会创建、修改、暂停或删除广告。

开始前的准备清单

需要准备	最低要求	如何确认
Codex	已安装可使用 Codex 的桌面应用	打开应用后可以进入 Codex 并新建会话
Meta 登录账户	能正常登录 Facebook	建议先在浏览器中完成登录和双重验证
广告账户权限	对目标广告账户至少拥有查看广告表现所需的权限	在 Meta Ads Manager 中可以打开该账户并查看报表
浏览器	能打开 Meta OAuth 授权页面	暂时关闭会阻止登录弹窗的扩展

本教程使用 Codex 桌面界面完成配置。尚未安装时，请先按照 OpenAI 官方桌面应用文档完成安装。

第 1 步：安装并打开 Codex

如果你已经可以在桌面应用中使用 Codex，可以直接进入下一步。

1. 从 OpenAI 官方页面下载适合 macOS、Windows 或 Linux 的桌面应用。
2. 安装并打开应用，然后登录你的 OpenAI 账户。
3. 在应用中选择 Codex。
4. 点击 New chat 新建一个会话。

检查点： 你应该能看到 Codex 的输入框，并能正常发送一条测试消息。

第 2 步：添加 Meta Ads MCP 服务器

1. 打开 Codex 的 Settings。
2. 选择 MCP servers。
3. 点击 Add server。
4. 按下面的值填写：

字段	填写内容
Name	Meta Ads
Type	Streamable HTTP
URL	https://mcp.facebook.com/ads

5. 保存服务器。
6. 点击 Restart，让 Codex 重新加载 MCP 配置。

检查点： 返回 MCP 服务器列表后，应能看到 Meta Ads。如果状态提示需要认证，这是正常的，下一步会完成 OAuth 登录。

如果你的 Codex 版本暂时没有可视化添加入口，也可以编辑全局配置文件 ~/.codex/config.toml：

[mcp_servers.meta_ads]
url = "https://mcp.facebook.com/ads"
default_tools_approval_mode = "writes"

保存后重启 Codex。不要把这段配置放进项目仓库；使用全局配置还可以避免其他项目自动继承不必要的广告账户访问权限。

第 3 步：完成 Meta OAuth 授权

1. 在 Meta Ads 服务器旁点击 Authenticate。
2. 浏览器打开后，登录拥有目标广告账户权限的 Facebook 账户。
3. 仔细检查授权页面展示的账户和权限，只授权本次分析确实需要的账户。
4. 完成授权后返回 Codex。
5. 如果 Codex 仍显示等待认证，重新打开 MCP 列表或重启一次应用。

检查点： Meta Ads 不再显示需要认证，并处于已启用或已连接状态。

OAuth 授权并不会自动赋予你新的广告账户权限。你只能访问该 Facebook 用户原本就有权访问的账户。团队账户应先由 Business Portfolio 管理员在 Meta 后台分配权限。

第 4 步：确认 MCP 工具已连接

新建一个 Codex 会话，在输入框中输入：

/mcp

在结果中查找 Meta Ads。如果能看到该服务器及其可用工具，说明 Codex 已经加载连接。

不要跳过这一步。如果服务器尚未连接，后续普通提问可能会得到基于常识生成的回答，而不是真实账户数据。

第 5 步：列出可以访问的广告账户

复制下面的 Prompt 到 Codex：

请仅使用 Meta Ads MCP 的只读工具，列出当前授权用户可以访问的 Meta 广告账户。

请为每个账户返回：
- 账户名称
- 广告账户 ID
- 账户状态
- 时区
- 币种

如果字段无法获取，请标记“不可用”，不要猜测。
不要创建、修改、暂停或删除任何广告、广告组、广告系列、受众或预算。

成功结果： Codex 应至少返回一个你认识的账户，广告账户 ID 通常以 act_ 开头。对照 Meta Ads Manager 检查账户名称、时区和币种是否一致。

如果你能访问多个账户，先复制后续要分析的 act_... 广告账户 ID，避免下一步查错账户。

第 6 步：运行第一次只读广告分析

将 Prompt 中的 act_1234567890 替换为你刚才确认的真实广告账户 ID：

请仅使用 Meta Ads MCP 的只读工具分析广告账户 act_1234567890。

查询要求：
1. 先读取并确认账户名称、账户 ID、时区和币种。
2. 日期范围使用该账户时区内“截至昨天的最近 7 个完整自然日”，不要包含今天。
3. 按广告系列汇总：状态、消耗、展示、点击、CTR、CPC、转化、CPA、购买转化价值和 ROAS。
4. 按消耗从高到低排序，并增加一行账户总计。
5. 说明使用的点击、转化事件和归因口径；如果接口没有返回某项指标，请标记“不可用”，不要把缺失值当成 0。
6. 最后用不超过 3 条要点指出值得人工复核的异常，但不要执行任何优化操作。

不要创建、修改、暂停或删除任何广告、广告组、广告系列、受众、出价或预算。

一份可以继续使用的结果至少应明确：

• 查询的是哪个广告账户，而不是只显示账户名称。
• 日期范围的起止日期，以及是否排除了今天。
• 报表时区和币种。
• 指标是账户总计还是广告系列级别。
• 缺失指标、归因口径和筛选条件。

如果 Codex 没有说明这些上下文，先让它补全，不要立即依据结果调整预算。

常见问题与最快排查顺序

MCP 列表中没有 Meta Ads

返回 Settings → MCP servers 检查服务器是否保存并启用，确认 URL 完整且没有空格，然后点击 Restart。官方地址是 https://mcp.facebook.com/ads，不要把 Ads Manager 网页地址填入 MCP URL。

Authenticate 后不断回到登录页面

先在默认浏览器中正常登录 Facebook，再重新认证。检查浏览器是否阻止弹窗、第三方登录或本地回调；仍失败时，在 Codex 中删除该服务器并按本文地址重新添加。

账户列表为空

这通常是 Meta 权限问题，不是 Prompt 问题。确认 OAuth 登录的 Facebook 用户与 Ads Manager 当前用户一致，并让 Business Portfolio 管理员检查目标广告账户的人员分配。

能看到账户，但查询被拒绝

检查用户是否只有部分资产权限，或是否缺少查看广告表现所需的权限。重新授权前先确认正确的广告账户 ID，避免为错误账户扩大授权范围。

查询成功但没有数据

先把日期范围缩短为最近 3 个完整自然日，并确认该账户在这段时间确实产生过消耗。要求 Codex 返回实际筛选条件，并区分“消耗为 0”和“指标不可用”。

报表与 Ads Manager 不一致

逐项核对账户时区、日期边界、归因窗口、转化事件、币种和聚合层级。不要直接比较一个包含今天的界面报表和本教程中不包含今天的完整自然日报表。

凭据与执行安全

• 不要把 Facebook 密码、Cookie、OAuth Token 或个人访问令牌粘贴进 Prompt。
• 不要在公开截图中展示完整账户 ID、客户名称或商业数据。
• 第一次使用只做读取和核对；修改预算、状态或定向应放在新的会话和独立审批流程中。
• 如果 Codex 请求调用写入工具，先拒绝并检查请求内容。本文不需要任何写入操作。

官方参考资料

• OpenAI：在 Codex 中连接 MCP 服务器
• OpenAI：安装并开始使用桌面应用
• Meta：Meta Ads AI Connectors 开放测试公告

完成以上步骤后，你已经拥有一个可复用的只读 Meta Ads 分析入口。下一次查询只需明确广告账户 ID、日期范围、指标和“不要修改任何内容”，不必重复配置服务器。