返回指南

指南 / claude-code

如何将 Claude Code 连接到 TikTok Ads MCP

配置 Claude Code 的只读 TikTok Ads MCP 工作流,验证工具访问并排查常见设置问题。

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

Claude Code 可以在会话中使用 MCP 服务提供的工具。具体配置格式取决于客户端版本和 MCP 提供方,因此服务命令和凭据应以双方当前文档为准。

准备安全测试

选择一个 TikTok 广告主账户和较短的报表周期,确认账户时区、货币、转化事件和归因上下文。先使用只读权限,并尽量避免 Token 出现在源文件、聊天记录和 Shell 历史中。

添加 TikTok Ads MCP 服务

  1. 打开当前安装支持的 Claude Code MCP 配置位置。
  2. 按提供方当前示例添加 TikTok Ads MCP 服务定义。
  3. 使用支持的密钥或环境变量机制保存凭据。
  4. 重新加载会话并查看已连接的服务。
  5. 在开始分析前确认 TikTok Ads 工具可用。

不要混用 Cursor、Codex 或其他 MCP 客户端的配置字段。服务本身正确,但客户端无法解析配置时,也会导致连接失败。

运行首次只读查询

列出当前会话可以访问的 TikTok 广告主账户。
针对我选择的账户汇总最近 7 天的消耗、展示、点击、转化、CPA 和 ROAS。
说明筛选条件,不要修改任何数据。

要求 Claude Code 标记缺失指标,并区分“没有投放”与“数据不可用”。如果结果异常,用明确账户和更短日期范围重复查询。

按层排查

  • 没有服务:检查配置位置和客户端是否重新加载。
  • 没有工具:检查服务启动输出和能力声明。
  • 权限错误:确认广告主账户和 Business Center 访问权。
  • 结果为空:确认账户、日期范围、时区和投放状态。
  • 响应缓慢:减少维度和日期范围后再试。

完整清单请看 TikTok Ads MCP 故障排查,概念入门可看 TikTok Ads MCP 入门指南

执行前先复核

将分析和执行分成不同请求。任何线上账户变更都应先生成证据表、变更建议、预期影响、负责人和回滚条件,再由人工审批。