将 TikTok Ads MCP 接入 Microsoft Copilot

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → TikTok Ads、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

TikTok Ads + Microsoft Copilot

让你的 AI 分析你的 TikTok 广告：按广告系列、广告组、广告、日期或受众查看花费、展示次数、点击次数和转化次数，还能查看广告系列、Smart+ 广告系列、受众、像素和创意素材库。开启相应工具并经你确认后，还可以暂停或开启广告系列、广告组和广告，并修改广告系列预算。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

TIKTOK_ADS_API_HOST, TIKTOK_ADS_ACCESS_TOKEN, TIKTOK_ADS_ADVERTISER_ID

步骤 1 — 获取凭证

1. 使用能访问你广告账户的 TikTok for Business 账号登录 TikTok API for Business 开发者门户（https://business-api.tiktok.com/portal），然后点击 Become a Developer。
2. 在 My Apps → Create an app 中填写名称、描述和 Advertiser redirect URL（你自己的任意 https 页面即可：你只需从它的地址中复制一段代码），并勾选权限 scope Ad Account Management、Ads Management、Reporting 和 Audience Management；如需使用相应工具，再勾选 Pixel Management 和 Creative Management。TikTok 会审核新应用，通常需要两到三个工作日。
3. 应用获批后，将它的 App ID 和 Secret 复制到 TIKTOK_ADS_APP_ID 和 TIKTOK_ADS_APP_SECRET。两者都是可选的：连接器只用它们列出你的令牌所覆盖的广告账户。
4. 打开应用的 Advertiser authorization URL，登录，勾选广告账户并确认。浏览器会跳转到重定向 URL，地址栏中带有 auth_code=...。这个代码只能使用一次，一小时后过期。
5. 立即用这个代码换取长期有效的访问令牌。这一步只需做一次：

   curl -X POST https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ -H "Content-Type: application/json" -d '{"app_id":"<App ID>","secret":"<Secret>","auth_code":"<auth_code>"}'
   

   将响应中的 data.access_token 粘贴到 TIKTOK_ADS_ACCESS_TOKEN，并将 data.advertiser_ids 中的一个粘贴到 TIKTOK_ADS_ADVERTISER_ID。该令牌不会过期，只有在授权被撤销或应用 secret 被重置时才会失效。
6. 将 TIKTOK_ADS_API_HOST 设为 https://business-api.tiktok.com，安装连接器并运行 tiktok_ads_get_advertiser_info 检查账户。

沙盒：如需在不产生真实花费的情况下试用，请在开发者门户中打开你的应用 → Sandbox，创建一个沙盒广告账户并在那里生成它的令牌；无需审核。使用该令牌和沙盒广告主 ID，并将 TIKTOK_ADS_API_HOST 设为 https://sandbox-ads.tiktok.com。沙盒账户不会投放广告，也不会报告真实数据。

每个连接器对应一个广告账户：每个工具都作用于 TIKTOK_ADS_ADVERTISER_ID 中的广告账户。一个令牌通常覆盖多个账户，tiktok_ads_list_authorized_advertisers 会列出这些账户。每增加一个账户，就再安装一次连接器。

状态和预算修改默认关闭：tiktok_ads_update_campaign_status、tiktok_ads_update_ad_group_status、tiktok_ads_update_ad_status 和 tiktok_ads_update_campaign_budget 在安装时处于关闭状态，因为一旦开启某项内容，就会立即开始花费。如果你希望 AI 暂停广告或修改预算，请逐个开启这些工具。之后 AI 会说明对应的广告系列、广告组或广告，以及当前值和新值，并等待你确认。只有当广告、其广告组和其广告系列都处于开启状态时，广告才会投放。预算是以账户币种计的金额（50 表示 50.00），低于 TikTok 最低限额或低于已花费金额 105% 的预算会被 TikTok 拒绝。连接器从不创建广告系列或广告。

报告：tiktok_ads_get_report 按广告系列、广告组、广告或整个账户返回花费、展示次数、点击次数、转化次数等数据，可以按天或按小时，也可以按年龄、性别、国家或版位细分。每日数据行每次请求最多覆盖 30 天，因此 AI 会拆分更长的时间段；不按时间细分的汇总最多可覆盖一年。日期遵循广告账户的时区，金额使用其币种。

常见错误：TikTok 会在一个其余部分都正常的响应中以代码形式报告错误，连接器会将其转换为清晰的错误。40001：应用或令牌缺少该账户或该操作的权限，请用所需的 scope 重新授权广告账户。40104 或 40105：令牌无效、已过期、已撤销或属于其他账户；请生成新令牌。40100：请求过多，请稍等片刻。40300：TikTok 无法识别该广告主 ID。

连接器不会创建或编辑广告系列、广告组、广告或受众，不会上传创意素材，不会管理 Business Center，也不涵盖 TikTok Shop。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 TikTok Ads 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。

可用工具

示例提示

• “我们上周在 TikTok 上花了多少钱？哪个广告系列的单次转化成本最低？”
• “显示过去 30 天每个广告系列的每日花费、点击次数和转化次数。”
• “按年龄和性别细分上个月的结果。”
• “我们的 TikTok Pixel 还在接收购买事件吗？将最近 7 天与前一周进行比较。”

FAQ

这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse