返回指南

指南 / codex

如何将 Codex 连接到 TikTok Ads MCP

为 Codex 配置安全的只读 TikTok Ads MCP 工作流,并验证账户、工具和报表上下文。

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

本文介绍 Codex 连接 TikTok Ads MCP 的通用流程,不假设某个提供方的固定配置语法。MCP 服务名称、包命令和权限字段可能变化,具体配置值应以提供方当前文档为准。

配置前准备

准备 MCP 提供方的服务配置、当前安装中 Codex 的 MCP 配置位置,以及目标 TikTok 广告主账户。第一次会话应明确只读,并确认报表使用的账户、时区、货币、归因上下文和日期范围。

连接服务

  1. 打开当前安装使用的 Codex MCP 配置。
  2. 按提供方文档添加 TikTok Ads MCP 服务。
  3. 使用支持的环境变量或凭据机制保存密钥,不要把 Token 粘贴到提问中或提交到代码仓库。
  4. 开启新的 Codex 会话,或重新加载 MCP 配置。
  5. 确认服务已连接,并且可以发现 TikTok Ads 工具。

不要直接复制其他客户端的配置示例。服务命令正确,但客户端字段不兼容时,表面上也可能像身份验证失败。

用只读请求验证

显示当前会话可以访问的 TikTok 广告主账户。
不要创建、编辑、暂停或删除任何内容。

选定账户后,再请求最近 7 天的消耗、展示、点击、转化、CPA 和 ROAS 汇总,并要求 Codex 说明账户、时区、货币、筛选条件和缺失字段。

连接失败时的检查顺序

  • 服务无法启动:检查命令、运行时、包和环境变量。
  • 服务已启动但没有工具:重新加载 Codex,并检查服务声明的能力。
  • 工具存在但数据被拒绝:检查广告主账户和 Business Center 权限。
  • 账户列表为空:检查身份、账户访问关系和账户筛选条件。
  • 请求超时:先缩短日期范围、减少维度,不要马上更换凭据。

完整诊断请查看 TikTok Ads MCP 故障排查指南

将执行和分析分开

先用 Codex 生成带证据的结论和待审批变更清单。预算、出价、定向、创意和广告状态修改都应有独立审批、变更原因和回滚条件。