← 返回指南

指南 / codex

如何用 Codex 连接 TikTok Ads MCP：从配置到首次广告分析

在 Codex 中添加 TikTok Ads 官方 MCP 地址，完成 OAuth 授权和连接验证，并用可复制的只读提示词分析最近 7 天广告表现。

作者：AdsDecide更新于 2026-08-20

这篇教程将带你使用 Codex 连接 TikTok for Business 官方 Ads MCP。完成后，你可以在 Codex 中列出有权访问的广告主账户，并分析最近 7 个完整自然日的广告表现。

整个过程通常需要 5–10 分钟，无需编写代码、创建 TikTok 开发者应用或配置 API 密钥。

完成后你会得到什么

  • Codex 的 MCP 服务器列表中显示 TikTok Ads 已连接。
  • Codex 能列出当前用户有权限访问的 TikTok 广告主账户。
  • Codex 能返回账户时区、币种和最近 7 个完整自然日的表现。
  • 你会完成一次可复核的只读查询，并确认没有改动广告配置。

开始前的准备清单

需要准备最低要求如何确认
Codex已安装可使用 Codex 的桌面应用可以进入 Codex 并新建会话
TikTok for Business 用户可以正常登录先在默认浏览器中完成登录
广告账户权限至少可以查看目标账户和报表在 TikTok Ads Manager 中查看最近数据
浏览器可以完成 OAuth 授权和回调暂时关闭拦截弹窗或第三方登录的扩展
账户信息知道目标账户名称、时区和币种在 Ads Manager 账户设置中核对

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

第 1 步：打开 Codex

  1. 打开桌面应用并登录 OpenAI 账户。
  2. 在应用中选择 Codex。
  3. 点击新建会话。
  4. 发送一条测试消息，确认会话可用。

检查点： 你能看到 Codex 输入框并正常收到回复。

第 2 步：确认 TikTok 广告账户

  1. 在默认浏览器登录 TikTok Ads Manager。
  2. 切换到准备分析的账户。
  3. 记录账户名称、广告主 ID、时区和币种。
  4. 打开报表，确认当前用户能看到最近几天的数据。

检查点： 当前浏览器登录用户对目标账户已有查看权限。OAuth 不会自动增加新的广告账户权限。

第 3 步：添加 TikTok Ads MCP 服务器

  1. 打开 Codex 的设置。
  2. 选择 MCP 服务器。
  3. 点击添加服务器。
  4. 按下面的值填写：
字段填写内容
名称TikTok Ads
类型Streamable HTTP
服务器地址https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer
  1. 保存服务器。
  2. 点击重新启动，让 Codex 重新加载 MCP 配置。

这里使用 TikTok 官方的渐进加载地址：初始只加载核心工具，需要时再发现更多工具，适合快速开始。

检查点： 返回 MCP 服务器列表后能看到 TikTok Ads。显示“需要认证”属于正常情况。

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

[mcp_servers.tiktok_ads]
url = "https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer"

保存后重新启动 Codex。全局配置不要提交到项目仓库。

第 4 步：完成 TikTok OAuth 授权

  1. 在 TikTok Ads 服务器旁点击认证。
  2. 浏览器打开后，登录拥有目标广告账户权限的 TikTok for Business 用户。
  3. 阅读授权页面展示的权限。
  4. 确认授权并等待浏览器返回 Codex。
  5. 如果状态没有更新，重新打开 MCP 服务器列表或重启一次。

不要把 TikTok 密码、Cookie、访问令牌或回调地址粘贴到 Codex。正常授权不需要手动传递这些凭据。

检查点： TikTok Ads 显示已启用或已连接，不再提示认证。

第 5 步：确认 MCP 工具已加载

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

/mcp

在结果中找到 TikTok Ads，并确认存在可用工具。渐进加载模式下工具数量少于完整加载模式是正常现象。

不要跳过这一步。服务器尚未连接时，普通提问可能得到通用建议，而不是真实账户数据。

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

复制下面的提示词：

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

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

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

成功结果： Codex 至少返回一个你认识的账户。对照 Ads Manager 检查名称、广告主 ID、时区和币种，并复制后续要分析的广告主 ID。

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

把 1234567890123456789 替换为真实广告主 ID：

请仅使用 TikTok Ads MCP 的读取工具分析广告主 ID 1234567890123456789。

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

不要创建、修改、暂停或删除任何广告系列、广告组、广告、受众、预算、出价或定向，也不要执行优化建议。

如何判断结果可以使用

结果至少应说明：

  • 查询的账户名称和广告主 ID。
  • 日期范围的具体起止日期，并排除今天。
  • 报表使用的账户时区和币种。
  • 数据的聚合层级与排序方式。
  • 转化事件、归因口径和筛选条件。
  • 哪些值确实为 0，哪些指标不可用。

如果缺少这些上下文，先让 Codex 补全，不要立即依据结果调整预算。

常见问题与最快排查顺序

MCP 列表中没有 TikTok Ads

返回设置 → MCP 服务器，确认服务器已经保存并启用，核对地址没有空格，然后点击重新启动。

认证后不断回到登录页面

先在默认浏览器登录正确的 TikTok for Business 用户，允许弹窗和本地回调，再从 Codex 重新认证。

账户列表为空

确认 OAuth 用户与 Ads Manager 当前用户一致。团队账户请让 Business Center 管理员检查人员与广告账户的分配。

服务器可见但没有工具

确认类型为 Streamable HTTP，地址以 tt-ads-mcp-layer 结尾，然后重新启动 Codex。仍失败时删除错误条目并按本文地址重新添加。

查询成功但没有数据

先缩短到最近 3 个完整自然日，确认该账户同期确实有消耗，并让 Codex 返回实际使用的日期和筛选条件。

报表与 Ads Manager 不一致

核对账户时区、日期边界、币种、转化事件、归因窗口和报表层级。界面若包含今天，不能与截至昨天的完整自然日报表直接比较。

完整诊断流程见 TikTok Ads MCP 故障排查。

凭据与执行安全

  • 不要把密码、Cookie、访问令牌或 OAuth 回调地址粘贴进提示词。
  • 不要在公开截图中展示完整广告主 ID、客户名称或商业数据。
  • 第一次使用只执行读取工具，并在提示词中明确禁止写入。
  • Codex 请求调用创建、更新、暂停或删除工具时，应拒绝调用。
  • 预算、出价、定向和状态变更应使用独立会话和人工审批流程。

官方参考资料

连接完成后，可继续阅读 如何用 AI 分析 TikTok Ads 表现，把首次查询扩展为日常复盘流程。