摘要
Tiki 开放 API 适用于越南市场的卖家:订单、库存和直邮确认、运输标签和卖家交付结果、每个仓库的产品价格和库存、卖家仓库和库存、类别、品牌和产品请求。内部应用 ID 和密钥。
引导式设置
2 分钟将 Tiki 连接到 Meta Muse
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Tiki,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Tiki 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Tiki,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Tiki + Meta Muse
Tiki 开放 API 适用于越南市场的卖家:订单、库存和直邮确认、运输标签和卖家交付结果、每个仓库的产品价格和库存、卖家仓库和库存、类别、品牌和产品请求。内部应用 ID 和密钥。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
TIKI_CLIENT_ID, TIKI_CLIENT_SECRET
第一步 — 获取凭据
设置大约需要 10 分钟。
- 使用你的 Tiki 账户登录 Tiki 开放平台控制台
https://open.tiki.vn,并打开 Application, Create (https://open.tiki.vn/web/console/apps/create)。 - 填写名称、摘要、描述、主页和图标。作为 Token endpoint auth method 选择 basic header(此后无法更改),应用类型选择 In-house。
- 输入你的商店 ID(不带 S 前缀的数字)和商店名称,然后提交。将 App ID 复制到
TIKI_CLIENT_ID,将 App Secret 复制到TIKI_CLIENT_SECRET。 - 在 Tiki 卖家中心批准连接:Seller info, Detail, Store Setting and Contact Info, Manage, Integrated Applications。在此之前,每次调用都会返回 401。
连接器在 https://api.tiki.vn/sc/oauth2/token 获取令牌(客户端凭据,HTTP Basic),并在过期时续订。内部应用拥有商店的所有权限,因此没有可选范围。Tiki 只有一个生产环境。
从哪里开始:tiki_list_orders,带有 item_confirmation_status 等待(待确认的订单)和状态 nin|processing,waiting_payment,然后 tiki_get_order。
确认订单:从你的库存中完成的订单(tiki_delivery, seller_delivery, cross_border)通过 tiki_confirm_available 确认,列出你可以提供的商品和来自 tiki_list_seller_inventories 的卖家库存(传递订单的 Tiki 仓库代码)。未列出的商品将被取消。直邮订单通过 tiki_confirm_dropship 确认;tiki_cancel_dropship 拒绝一个订单,并且在关闭状态下安装。tiki_get_shipping_label 返回订单交付模型的标签链接。你自己交付的订单通过 tiki_update_seller_delivery 获取结果。没有退货或取消 API:退货显示为 is_rma 订单和退货状态。
产品和库存:tiki_list_products(包括每个仓库的库存),tiki_get_product,tiki_find_product_by_sku(你的 original_sku),tiki_update_product(每个卖家仓库的价格以 VND 计,来自 tiki_list_seller_warehouses;不适用于存放在 Tiki 的现货产品)。tiki_set_product_active 处于关闭状态,因为 0 会将产品下架。tiki_list_product_requests 和 tiki_get_tracking 跟踪产品请求;tiki_list_categories,tiki_get_category_attributes,tiki_list_brands 和 tiki_list_tiki_warehouses 提供参考数据。tiki_get_seller 显示商店及其运营模型。创建产品不包括在内。
格式:日期为越南时间(UTC+7)的 yyyy-MM-dd HH:mm:ss;价格为 VND。设置订单的过滤器写为 in|a,b 或 nin|a,b。列表从 1 开始的 page 和 limit;答案包含 paging(总数、当前页、最后一页)。错误为 errors(消息列表),状态码为 400、401(缺少令牌、过期或应用未连接到商店)、403、422 或 429。
速率限制:每个卖家每秒 200 个请求;429 应该稍后重试,其他 4xx 响应不重试。
第二步 — 安装适配器
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
第三步 — 在 Muse 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
- 在聊天中,向 Muse 提出需要用到
Tiki的工具的请求。
你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
tiki_get_seller | 令牌背后的卖家:id、名称、状态、logo、operation_models(直邮、现货、缺货、卖家缺货、跨境)… |
tiki_list_seller_warehouses | 卖家仓库(取件和退货地址):id、名称、is_primary、状态、类型、街道、区、县、地区、国家和联系方式… |
tiki_list_orders | 列出订单,最新优先:代码、履行类型、状态、is_rma、创建时间、更新时间、发票(小计、总计… |
tiki_get_order | 读取一个订单:代码、关系代码、履行类型、状态、发票、Tiki 仓库、商品及其价格、数量、卖家收入… |
tiki_list_seller_inventories | 卖家库存(库存位置),你可以从中确认订单,及其服务的 Tiki 仓库:seller_inventories 和映射… |
tiki_get_shipping_label | 订单的可打印标签链接(HTML):shipping_label_url(tiki-delivery)、shipping_label_url 和 shipping_stamp_url(直邮)… |
tiki_list_products | 列出产品,最新优先:product_id、sku、original_sku(你的 SKU)、名称、价格、市场价格、实体类型、master_id、super_id… |
tiki_get_product | 读取一个产品:名称、sku、original_sku、价格、市场价格、状态、属性、图片、类别和每个仓库的库存。只读 |
tiki_find_product_by_sku | 通过你自己的 SKU(original_sku)查找产品:product_id、sku、名称、价格、市场价格、类别和图片。只读 |
tiki_list_categories | Tiki 类别:id、名称、父级、is_primary 以及是否可以在其中创建产品。按父级过滤以遍历树。只读 |
tiki_get_category_attributes | 一个类别的产品请求属性:代码、显示名称、数据类型、is_required 和允许的值。只读 |
tiki_list_brands | 按名称搜索 Tiki 品牌:id 和名称,用于产品请求。只读 |
tiki_list_tiki_warehouses | Tiki 仓库(履行中心):id、代码和名称,在订单和卖家库存映射中出现。只读 |
tiki_list_product_requests | 产品创建和更新请求:id、track_id、状态(草稿、处理中、等待、批准、拒绝、删除)、原因和… |
tiki_get_tracking | 通过其跟踪 ID 查询异步产品请求的状态:状态、原因和请求 ID 一旦被接受。只读 |
tiki_confirm_available | 确认从你的库存中履行的订单的库存(tiki_delivery、seller_delivery 或 cross_border):列出你可以提供的商品 ID… |
tiki_confirm_dropship | 确认来自一个卖家库存的直邮订单(seller_confirmed);Tiki 然后安排取件 |
tiki_update_seller_delivery | 报告你自己交付的订单的交付结果(seller_delivery):successful_delivery,或失败交付及原因和… |
tiki_update_product | 更改一个产品的价格和每个卖家仓库的库存,通过你的 original_sku 或 Tiki product_id 识别。库存不能… |
tiki_set_product_active | 切换一个产品的销售状态(1 表示上架,0 表示下架)。0 会将其从 Tiki 下架 |
tiki_cancel_dropship | 拒绝一个直邮订单(seller_canceled)。无法撤销;客户将获得退款,并计入商店 |
示例提示
- "哪些 Tiki 订单仍需确认库存?"
- "确认订单 821034567 的直邮并获取运输标签。"
- "SKU TK-KETTLE-17 在我的每个仓库中的库存是多少?"
- "哪些产品请求仍在等待 Tiki 的批准?"
- "跟踪订单 821034567 的交付情况。"
常见问题
凭据来自哪里? 来自 Tiki 开放平台控制台上的内部应用,使用基本头部的令牌端点身份验证方法。在 Tiki 卖家中心的集成应用下批准连接,或者每次调用都会返回 401。
它涵盖了什么? 订单的库存和直邮确认、运输标签和卖家交付结果、每个仓库的产品价格和库存、卖家仓库和库存、类别、品牌和产品请求。
哪些工具安装时处于关闭状态? tiki_cancel_dropship 和 tiki_set_product_active。仅在连接器页面上切换它们,如果 AI 应该使用它们。
Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?