← 返回指南
指南 / 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 服务
- 打开当前安装支持的 Claude Code MCP 配置位置。
- 按提供方当前示例添加 TikTok Ads MCP 服务定义。
- 使用支持的密钥或环境变量机制保存凭据。
- 重新加载会话并查看已连接的服务。
- 在开始分析前确认 TikTok Ads 工具可用。
不要混用 Cursor、Codex 或其他 MCP 客户端的配置字段。服务本身正确,但客户端无法解析配置时,也会导致连接失败。
运行首次只读查询
列出当前会话可以访问的 TikTok 广告主账户。
针对我选择的账户汇总最近 7 天的消耗、展示、点击、转化、CPA 和 ROAS。
说明筛选条件,不要修改任何数据。
要求 Claude Code 标记缺失指标,并区分“没有投放”与“数据不可用”。如果结果异常,用明确账户和更短日期范围重复查询。
按层排查
- 没有服务:检查配置位置和客户端是否重新加载。
- 没有工具:检查服务启动输出和能力声明。
- 权限错误:确认广告主账户和 Business Center 访问权。
- 结果为空:确认账户、日期范围、时区和投放状态。
- 响应缓慢:减少维度和日期范围后再试。
完整清单请看 TikTok Ads MCP 故障排查,概念入门可看 TikTok Ads MCP 入门指南。
执行前先复核
将分析和执行分成不同请求。任何线上账户变更都应先生成证据表、变更建议、预期影响、负责人和回滚条件,再由人工审批。