如何用 Claude Code 连接 TikTok Ads MCP：配置、认证与首次查询

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

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

完成后你会得到什么

• Claude Code 中已添加并连接 TikTok Ads MCP。
• 浏览器已完成 TikTok for Business OAuth 授权。
• Claude Code 能列出你有权访问的广告主账户。
• 你会完成一次带账户、日期、时区、币种和归因上下文的只读查询。

开始前的准备清单

需要准备	最低要求	如何确认
Claude Code	已安装并登录	终端执行 claude --version 能返回版本
TikTok for Business 用户	可以正常登录	先在默认浏览器中完成登录
广告账户权限	至少可以查看目标账户和报表	在 TikTok Ads Manager 中查看最近数据
终端	可以执行 Claude Code 命令	macOS/Linux 使用终端，Windows 使用 PowerShell
浏览器	可以完成 OAuth 和本地回调	暂时关闭拦截弹窗或第三方登录的扩展

尚未安装时，请按 Claude Code 官方安装文档安装。安装后打开终端，执行：

claude --version

如果提示找不到命令，先关闭并重新打开终端，再检查安装步骤和 PATH。

第 1 步：登录并确认 Claude Code 可用

1. 在终端执行 claude。
2. 按界面提示登录。
3. 进入会话后发送一条测试消息。
4. 退出会话，返回终端。

检查点： claude 命令能启动会话，并且测试消息得到回复。

第 2 步：确认 TikTok 广告账户权限

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

检查点： 浏览器中的登录用户已经能访问目标广告账户。OAuth 不会自动增加新的账户权限。

第 3 步：添加 TikTok Ads MCP

在终端复制并执行下面的单行命令：

claude mcp add --transport http --scope user tiktok-ads https://business-api.tiktok.com/open_mcp/tt-ads-mcp-flat

这个命令会：

• 使用远程 HTTP 传输。
• 把服务器命名为 tiktok-ads。
• 以用户范围保存，使当前用户的不同项目都可以使用。
• 使用 TikTok 官方完整加载地址；TikTok 官方推荐 Claude 使用此模式。

完整加载模式会在连接时提供约 400 个工具，因此首次加载可能比普通 MCP 服务器稍慢。

检查点： 命令结束时没有显示配置错误。

第 4 步：检查服务器配置

在终端执行：

claude mcp list

列表中应出现 tiktok-ads。需要查看单个服务器详情时执行：

claude mcp get tiktok-ads

确认类型为 http，地址以 tt-ads-mcp-flat 结尾。

第 5 步：完成 TikTok OAuth 认证

1. 在终端执行 claude 进入会话。
2. 输入 /mcp。
3. 在服务器列表中选择 tiktok-ads。
4. 选择认证，并按提示在浏览器中登录 TikTok for Business。
5. 阅读权限范围后确认授权。
6. 返回 Claude Code，再次输入 /mcp 查看状态。

如果浏览器没有自动打开，复制 Claude Code 提供的授权链接到默认浏览器。授权完成但浏览器回调失败时，按 Claude Code 提示复制地址栏中的完整回调地址；不要把它发送到聊天或公开位置。

检查点： /mcp 面板中 tiktok-ads 已连接，并显示可用工具数量。

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

在 Claude Code 会话中粘贴：

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

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

字段没有返回时标记“不可用”，不要猜测。
不要创建、修改、暂停或删除广告系列、广告组、广告、受众、预算、出价或定向。

成功结果： 至少返回一个你认识的账户，并且广告主 ID、时区和币种与 Ads Manager 一致。

第 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 值的区别。

缺少上下文时，先要求补充，不要直接依据结果调整投放。

常见问题与最快排查顺序

claude 命令不存在

重新打开终端并执行 claude --version。仍失败时回到官方安装文档检查安装位置和 PATH。

tiktok-ads 不在列表中

重新执行添加命令，注意 --transport 和 --scope 必须写在服务器名称前面，并检查地址是否完整。

/mcp 显示需要认证

选择 tiktok-ads 发起 OAuth。如果浏览器没有打开，手动打开面板给出的授权链接。

认证后仍然断开

先确认默认浏览器已登录正确用户，再在 /mcp 中重新认证。若团队管理策略阻止个人 MCP，请联系管理员确认允许的服务器范围。

账户列表为空

在 Ads Manager 中确认同一用户可以看到目标账户。团队账户请让 Business Center 管理员检查分配。

工具很多或加载较慢

完整加载模式会提供约 400 个工具，首次连接稍慢是正常的。先等待连接完成，再从 /mcp 检查状态。

数据与 Ads Manager 不一致

核对时区、日期边界、币种、转化事件、归因窗口和报表层级，尤其确认 Ads Manager 是否包含今天。

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

凭据与执行安全

• 不要在提示词或命令中粘贴密码、Cookie、访问令牌或 OAuth 回调地址。
• 不要把个人认证信息写入项目的 .mcp.json 并提交到版本库。
• 第一次查询只调用读取工具，并在提示词中明确禁止写入。
• 出现创建、更新、暂停或删除工具的审批时，拒绝本次调用。
• 预算、出价、定向和状态调整应使用单独流程并由人工批准。

官方参考资料

• Claude Code：通过 MCP 连接外部工具
• Claude Code：安装与设置
• TikTok for Business：TikTok Ads MCP 服务器说明

连接完成后，可以继续阅读 如何用 AI 分析 TikTok Ads 表现。