将 TikTok Shop MCP 连接到 Gemini CLI

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

TikTok Shop Seller + Gemini

让你的 AI 操作你的 TikTok Shop 店铺：含买家留言和地址的订单、商品、库存、仓库、物流面单与跟踪、退货和结算，并可按需更改发货、商品、库存和价格。

前提条件

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

TIKTOK_SHOP_APP_KEY, TIKTOK_SHOP_APP_SECRET, TIKTOK_SHOP_SERVICE_ID

步骤 1 — 获取凭证

应用创建好后，设置大约需要 15 分钟。你需要在 TikTok Shop Partner Center 中有一个自己的应用（App key、App secret 和 Service ID），以及店铺所有者的 Seller Center 账号。

先要有卖家开发者权限：只有当店铺有指定的客户经理（account manager）时，TikTok 才允许卖家注册为卖家开发者（seller developer），并为自己的店铺创建应用。没有客户经理时，Partner Center 会提示“This account is not eligible for seller developer registration”。这种情况下，请通过 Seller Center 的帮助中心向 TikTok Shop 申请客户经理资格审核，或者使用拥有卖家开发者权限的开发者的应用。

1. 用店铺所有者账号登录 partner.tiktokshop.com（美国店铺：partner.us.tiktokshop.com），打开 App & Service，为你的店铺创建一个自定义应用（custom app）。在 Manage API 中开启工具所需的权限范围：Shop authorized information、Order information、Product basic 和 Product write、Fulfillment basic、Logistics basic、Return and refund basic 以及 Finance information。
2. 把应用的 Redirect URL 设为你的 AnythingMCP 地址加上 /api/tiktok-shop/callback：AnythingMCP Cloud 上是 https://cloud.anythingmcp.com/api/tiktok-shop/callback，自托管时是 <SERVER_URL>/api/tiktok-shop/callback（使用你自己的 SERVER_URL）。
3. 把应用的 App key 复制到 TIKTOK_SHOP_APP_KEY，App secret 复制到 TIKTOK_SHOP_APP_SECRET，Service ID（App & Service → 你的应用 → Basic Information）复制到 TIKTOK_SHOP_SERVICE_ID。美国店铺把 TIKTOK_SHOP_MARKET 设为 US；英国、欧盟和其他所有市场留空即可。
4. 安装连接器，打开它并点击 Authorize with Provider。TikTok Shop 会让你选择地区、登录 Seller Center 并批准应用；随后你会回到 AnythingMCP，连接器即可使用。用 tiktok_shop_get_authorized_shops 检查连接。

Cloud 和自托管的方式相同：连接器始终使用你自己的应用，只有 Redirect URL 不同。

多个店铺：如果一次授权涵盖多个店铺（跨境卖家），请在授权前把 TIKTOK_SHOP_SHOP_ID 设为店铺 ID、店铺代码或准确的店铺名称。不设置时，连接器使用第一个店铺。

令牌自动续期：访问令牌有效期为 7 天，会自动续期；刷新令牌在卖家授权有效期内一直有效，并加密存储。授权过期或在 Seller Center 中被取消后，连接器会显示需要重新授权，其所有者会收到一封邮件，点击 Authorize with Provider 即可恢复。

App secret 只保存在 AnythingMCP 中：每次调用都用它签名（HMAC-SHA256），secret 本身从不发送。TikTok 会拒绝超过 5 分钟的时间戳，所以时钟不准的自托管服务器会收到时间戳错误。

可读取的内容：订单，包括商品明细、买家留言和卖家备注、收件人姓名和地址、付款金额、承运商、运单号和包裹；订单的价格明细；商品，包括类目、品牌、图片、属性，以及每个 SKU 的价格和各仓库库存；店铺可以上架的类目及其属性和上架规则，以及品牌；仓库、配送选项和承运商；包裹、上门揽收和自行投递选项、可打印的物流面单和装箱单，以及物流跟踪事件；退货、退款和取消申请；结算单，以及每笔订单扣除费用和佣金后的结算金额。

安装时默认关闭：tiktok_shop_ship_package、tiktok_shop_mark_package_shipped、tiktok_shop_update_order_shipping_info、tiktok_shop_create_product、tiktok_shop_edit_product、tiktok_shop_partial_edit_product、tiktok_shop_update_inventory、tiktok_shop_update_price、tiktok_shop_activate_products 和 tiktok_shop_deactivate_products。它们会安排发货、向买家发送运单号、创建和编辑商品、覆盖库存、设置价格以及上架或下架商品，也就是会更改你的线上店铺或买家看到的内容。请在连接器页面只开启你需要的工具；AI 在每次更改前都会先征得你的确认。tiktok_shop_upload_product_image 默认开启：它只为之后的商品保存一张图片，不会更改任何商品。

不涉及资金操作：没有工具会退款、取消订单或回复买家。这些仍在 Seller Center 中处理。

ID、时间和分页：ID 是长数字，AI 以字符串形式传递；时间为 Unix 秒；列表通过 page_token 分页。

常见错误：106001 表示签名错误：App key 和 App secret 不属于同一个应用。105005 表示应用或授权缺少该 API 的权限范围：在 Manage API 中开启后重新授权。36009033 表示应用设置了 IP 白名单，但其中不包含 AnythingMCP 的地址。36009002 或 429 表示触发了限流：等一分钟再试。

步骤 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 — 在 Gemini 中添加连接器

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

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 TikTok Shop Seller 的工具。

可用工具

示例提示

• “哪些订单在等待发货？有买家留言吗？”
• “把今天创建的包裹的物流面单和装箱单给我。”
• “哪些商品在任一仓库的库存少于 10 件？”
• “列出未处理的退货和退款申请，并附上每个申请的原因和金额。”
• “上周的结算扣除费用和佣金后给我打了多少钱？”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

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