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

这篇教程将带你使用 Cursor 连接 TikTok for Business 官方 Ads MCP。完成后，你可以在 Cursor 的智能体会话中列出有权访问的广告主账户，并查询最近 7 个完整自然日的表现。

整个配置通常需要 5–10 分钟，无需编写集成代码、创建 TikTok 开发者应用或配置 API 密钥。

完成后你会得到什么

• Cursor 的 MCP 列表中显示 TikTok Ads 已连接。
• 浏览器已完成 TikTok for Business OAuth 授权。
• Cursor 能列出当前用户可以访问的广告主账户。
• 你会完成一次带账户、日期、时区、币种和归因上下文的只读查询。

开始前的准备清单

需要准备	最低要求	如何确认
Cursor	已安装并登录	可以打开智能体会话并发送消息
TikTok for Business 用户	可以正常登录	先在默认浏览器中完成登录
广告账户权限	至少可以查看目标账户和报表	在 TikTok Ads Manager 中查看最近数据
浏览器	可以完成 OAuth 和本地回调	暂时关闭拦截弹窗或第三方登录的扩展
账户信息	知道目标账户、时区和币种	在 Ads Manager 账户设置中核对

尚未安装时，从 Cursor 官方下载页安装适合 macOS、Windows 或 Linux 的版本，打开后登录。

第 1 步：确认 Cursor 可用

1. 打开 Cursor。
2. 打开智能体会话。
3. 新建一个对话并发送测试消息。

检查点： 智能体会话可以正常返回回答。

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

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

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

第 3 步：添加 TikTok Ads MCP 服务器

1. 在 Cursor 侧边栏打开自定义。
2. 选择 MCP。
3. 点击添加新的 MCP 服务器。
4. 按下面的值填写：

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

5. 保存并启用服务器。
6. 如果状态没有刷新，重新加载 Cursor 窗口。

这里使用 TikTok 官方渐进加载地址，初始加载约 40 个核心工具，并在需要时发现更多工具。

检查点： MCP 页面中可以看到 TikTok Ads。显示需要登录或认证是正常的。

第 4 步：无法使用设置界面时编辑 mcp.json

如果当前版本的添加界面不同，可以直接配置全局 MCP 文件：

• macOS 和 Linux：~/.cursor/mcp.json
• Windows：用户目录下的 .cursor/mcp.json

文件内容为：

{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer"
    }
  }
}

保存后重新加载 Cursor 窗口。全局配置适合个人使用；不要把个人认证信息写入项目的 .cursor/mcp.json 并提交到版本库。

检查点： 重新打开 MCP 页面后能看到 tiktok-ads。

第 5 步：完成 TikTok OAuth 授权

1. 在 MCP 页面找到 TikTok Ads。
2. 点击连接或认证。
3. 浏览器打开后，登录拥有目标广告账户权限的 TikTok for Business 用户。
4. 阅读权限范围并确认授权。
5. 返回 Cursor，等待服务器状态更新。
6. 必要时重新加载一次窗口。

不要把密码、Cookie、访问令牌或 OAuth 回调地址粘贴到聊天中。正常授权由浏览器和 Cursor 完成。

检查点： TikTok Ads 显示已连接，并且工具列表不为空。

第 6 步：确认智能体可以看到工具

打开一个新的智能体会话：

1. 打开可用工具列表。
2. 确认 TikTok Ads 或 tiktok-ads 已启用。
3. 保持默认的工具调用审批，不要开启不受控的自动运行。

渐进加载模式下，初始工具数量较少是正常现象。如果工具为 0，先重新加载窗口并检查服务器地址。

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

复制下面的提示词：

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

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

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

当 Cursor 请求批准读取工具时，先检查工具名称和参数，再批准。

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

第 8 步：运行首次只读查询

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

上下文不完整时，先要求 Cursor 补充，再做业务判断。

常见问题与最快排查顺序

MCP 页面没有 TikTok Ads

检查服务器是否保存到正确范围，确认 JSON 语法有效，重新加载 Cursor 窗口。

服务器存在但没有工具

确认地址以 tt-ads-mcp-layer 结尾，并确认服务器已启用。删除多余空格后重新加载。

OAuth 页面没有打开

检查默认浏览器和弹窗设置，然后在 MCP 页面重新点击认证。

认证成功但账户列表为空

确认授权用户与 Ads Manager 当前用户一致。团队账户请让 Business Center 管理员检查人员与账户分配。

工具调用被阻止

检查 Cursor 团队是否设置了 MCP 允许列表或工具限制。企业环境需要管理员批准服务器地址和读取工具。

报表为空或数字不一致

核对广告主 ID、账户时区、日期边界、币种、转化事件、归因窗口和报表层级。先用最近 3 个完整自然日做最小查询。

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

凭据与执行安全

• 不要在提示词或 mcp.json 中写入密码、Cookie、访问令牌或 OAuth 回调地址。
• 项目级 mcp.json 可能被提交到版本库，只应保存无敏感信息的服务器配置。
• 保持工具调用审批，确认名称和参数后再批准。
• 本教程只批准读取工具；拒绝创建、更新、暂停或删除操作。
• 预算、出价、定向和状态变更应使用独立流程并由人工批准。

官方参考资料

• Cursor：Model Context Protocol
• Cursor：官方下载
• TikTok for Business：TikTok Ads MCP 服务器说明

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