TikTok Ads MCP 入门：从连接到首次只读分析

这篇教程将带你连接 TikTok for Business 官方 MCP 服务器，并完成第一次只读广告查询。无需编写代码、创建开发者应用或管理 API 密钥，通常 10–15 分钟可以完成。

TikTok 官方服务器同时提供报表和广告管理工具。本文只使用读取能力；不会创建、修改、暂停或删除广告。

完成后你会得到什么

• 你的 MCP 客户端能够连接 TikTok Ads MCP。
• 浏览器已完成 TikTok for Business OAuth 授权。
• AI 能列出你有权访问的广告主账户。
• AI 能按账户时区和币种汇总最近 7 个完整自然日的表现。
• 你能判断结果来自真实账户数据，而不是模型自行推测。

开始前的准备清单

需要准备	最低要求	如何确认
MCP 客户端	已安装并能添加 Streamable HTTP 服务器	可以打开客户端的 MCP 设置
TikTok for Business 账户	可以正常登录	先在默认浏览器登录一次
广告账户权限	至少能查看目标账户和报表	在 TikTok Ads Manager 中打开账户并查看数据
浏览器	允许打开授权页面和本地回调	暂时关闭会拦截弹窗或第三方登录的扩展
账户信息	知道要分析的账户、时区和币种	从 Ads Manager 的账户设置中核对

如果你还没有广告账户，先注册 TikTok for Business，并完成 Ads Manager 广告账户的基础资料。团队账户还需要 Business Center 管理员把目标广告账户分配给你的用户。

第 1 步：确认广告账户权限

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

检查点： 在连接 MCP 之前，你已经能在 Ads Manager 中看到目标账户。OAuth 只会授权现有权限，不会自动增加账户访问权。

第 2 步：选择官方服务器地址

TikTok 提供两种工具加载方式：

模式	官方地址	适用情况
渐进加载	https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer	初始加载约 40 个核心工具，其他工具按需发现；新手优先选择
完整加载	https://business-api.tiktok.com/open_mcp/tt-ads-mcp-flat	连接时加载约 400 个工具；适合能处理大量工具上下文的客户端

如果客户端教程没有特别说明，先使用渐进加载地址。两种模式连接的是同一套 TikTok Ads 能力，不是两个不同账户系统。

第 3 步：在 MCP 客户端中添加服务器

打开客户端的 MCP 设置，新增一个远程服务器，并填写：

字段	填写内容
名称	TikTok Ads
类型	Streamable HTTP
服务器地址	https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer

保存后重新加载客户端。如果你使用特定客户端，可直接照对应教程操作：

• Codex 连接教程
• Claude Code 连接教程
• Cursor 连接教程

检查点： MCP 服务器列表中能看到 TikTok Ads。此时显示“需要认证”属于正常状态。

第 4 步：完成 OAuth 授权

1. 在 TikTok Ads 服务器旁选择认证或连接。
2. 浏览器打开后，登录拥有目标广告账户权限的 TikTok for Business 用户。
3. 阅读授权页面显示的权限范围。
4. 确认授权，等待浏览器跳回客户端。
5. 返回客户端，刷新 MCP 状态；必要时重新启动一次。

不要把 TikTok 密码、Cookie 或回调地址中的令牌复制到聊天框。正常 OAuth 流程会在浏览器和客户端之间完成。

检查点： 服务器显示已连接或已启用，不再提示登录。

第 5 步：确认工具已加载

打开客户端的 MCP 工具列表，检查 TikTok Ads 是否存在并且至少显示可用工具。渐进加载模式工具数量较少是正常现象，需要时会继续发现其他工具。

如果服务器存在但工具数量为 0，先重新加载客户端；仍未恢复时，检查地址结尾是 tt-ads-mcp-layer，而不是普通 Ads Manager 网页地址。

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

复制下面的提示词：

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

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

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

成功结果： 返回至少一个你认识的账户，而且名称、广告主 ID、时区和币种与 Ads Manager 一致。复制下一步要用的广告主 ID。

如果账户为空，先检查登录用户和 Business Center 权限，不要通过反复改提示词来解决权限问题。

第 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”和“不可用”的明确区分。
• 每条结论对应的数据证据。

缺少其中任何一项时，让 AI 补充上下文，再进行业务判断。

常见问题与最快排查顺序

看不到服务器

检查服务器是否已保存并启用，核对完整地址，重新加载客户端。不要填写 Ads Manager 首页地址。

浏览器反复要求登录

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

已连接但账户列表为空

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

有账户但报表为空

确认广告主 ID、账户时区和日期范围；先查询最近 3 个完整自然日，并要求返回实际使用的筛选条件。

数据与 Ads Manager 不一致

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

更完整的诊断顺序见 TikTok Ads MCP 故障排查。

凭据与执行安全

• 不要在提示词中粘贴密码、Cookie、访问令牌或 OAuth 回调地址。
• 不要在公开截图中展示完整广告主 ID、客户名称和业务数据。
• 首次使用只运行读取工具，并在每条提示词中明确禁止写入。
• 如果客户端请求调用创建、更新、暂停或删除工具，拒绝该调用。
• 修改预算、出价、定向或状态时，应另开流程并获得人工审批。

官方参考资料

• TikTok for Business：TikTok Ads MCP 服务器说明
• Model Context Protocol 官方介绍

连接完成后，可以继续学习 如何分析 TikTok Ads 表现，把首次查询扩展成可复核的日常报表。