摘要
Tiki 开放 API 适用于越南市场的卖家:订单、库存和直邮确认、运输标签和卖家交付结果、每个仓库的产品价格和库存、卖家仓库和库存、类别、品牌和产品请求。内部应用 ID 和密钥。
引导式设置
2 分钟将 Tiki 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Tiki,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
Tiki 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Tiki,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Tiki + ChatGPT
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
第三步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Tiki。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
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 应该使用它们。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?