JTLGO Commerce MCP 服务器

把商品搜索、中国运费报价和物流追踪接入你的 AI 助手。

通过托管 MCP 连接器 URL 或配置文件接入 Codex、Claude Desktop、Antigravity 和其他 MCP 客户端。接入后，Agent 可以搜索 JTLGo 商品、估算中国发货运费、查询物流轨迹、查看安全商品详情，并把不确定的采购问题转给人工客服。

快速结论： https://jtlgo.com/api/mcp - 如果你的 AI 客户端支持托管 MCP 连接器，优先使用托管连接器 URL；如果不支持，再使用配置文件或本地 stdio 包。

下载 MCP 包开始快速设置选择你的客户端

6 Agent 工具

3+ AI 客户端

0 浏览器插件

24/7 本地 Agent 可用

用买家能听懂的话解释 MCP 是什么？

MCP 是 Model Context Protocol，可以理解为 AI 助手和一组业务工具之间的安全连接器。你不用在多个页面之间复制数据，只要用自然语言提问，AI 助手就可以调用 JTLGO 的商品搜索、中国采购、运费查询和物流追踪工具。

自然语言输入，电商动作输出。

普通聊天助手只能根据上下文回答。有了 MCP，助手可以调用经过批准的 JTLGO 工具：搜索商品、查询运费、追踪包裹、查看商品详情，并在答案有风险时请求人工支持。

你提出采购问题。例如：找 3 个防水旅行包，并估算 2 kg 发往美国的运费。

AI 客户端调用 MCP 工具。请求保留在你的本地客户端和经过批准的 JTLGO MCP 服务器中。

JTLGO 返回结构化答案。助手可以比较商品、运费、置信度和下一步动作。

不确定的问题转人工。敏感货、商品不清楚、人工采购需求会引导到邮件或 WhatsApp。

JTLGO MCP 能给你的 AI 助手增加什么能力。

核心流程很简单：MCP 让 AI 助手可以安全使用真实业务工具。对 JTLGO 来说，这些工具聚焦电商采购和中国物流。

商品发现

搜索采购候选商品，对比安全字段，并在商品身份不明确时避免过度自信。

运费预估

按国家、重量、尺寸、货物类型和路线限制查询中国发货路线。

物流追踪

查询 JTLGO 包裹、货件和订单追踪号，并总结最新扫描节点和异常风险。

采购详情检查

获取商品详情、供应商上下文和下一步问题，同时不向 AI 客户端暴露后台私有字段。

人工转接

当商品匹配、敏感货或人工采购需求不确定时，引导到邮件或 WhatsApp。

可用 MCP 工具

search_products 用于商品发现。
quote_shipping_rates 用于中国发货运费预估。
track_shipment 用于包裹、货件和订单轨迹查询。
get_product_detail 用于安全商品详情查询。
human_handoff 用于人工支持。
get_mcp_config 用于安装验证。

安装前先看 Agent 工作流。

页面要教会用户的就是这种自然语言流程：买家只问一次，Agent 自动选择商品搜索、运费报价、物流追踪，并在需要时转人工。

演示提示词 商品搜索 + 运费估算 + 物流追踪 + 人工兜底规则

使用 jtlgo-commerce 的 search_products 找 3 个防水旅行包候选商品，然后报价 2 kg 发往美国的运费。如果你没有把握，请使用 human_handoff。

我会先调用 get_mcp_config，再调用 search_products，然后调用 quote_shipping_rates。如果匹配不够确定或可能涉及敏感货，我会使用 human_handoff，而不是假装答案已经最终确认。

先调用 get_mcp_config。然后用关键词“wireless earbuds”调用 search_products，limit 为 3。之后用 countryCode “US” 和 weight 2 调用 quote_shipping_rates。

为追踪号 JTL123456789 调用 track_shipment。如果没有找到可信轨迹，请告诉客户需要发哪些信息给 JTLGO 客服。

我会调用 track_shipment。如果 JTLGO 找不到可信轨迹，我会要求提供追踪号、订单号、承运商、目的国和最后可见节点，然后再转人工支持。

快速开始：选择最省事的接入方式。

先用托管连接器 URL。只有当客户端没有连接器表单时才复制配置片段；只有客户端必须使用 stdio 时才下载本地包。

优先选择连接器

如果你的 AI 客户端有 connector、remote MCP 或 Streamable HTTP 设置页，直接粘贴托管 MCP URL。

其次使用配置文件

如果客户端没有连接器表单，复制下面对应客户端的 JSON 或 TOML。

本地包只作为兜底

只有客户端支持本地 stdio 服务器但不支持托管连接器 URL 时才下载 zip。

先验证一个工具

重启 AI 客户端，调用 get_mcp_config，然后用一个简单请求测试 search_products、quote_shipping_rates 或 track_shipment。

选择你的 MCP 客户端。

参考主流教程，每个客户端提供两种接入方式：连接器用于最快托管接入，配置文件用于需要手动 JSON、TOML 或本地 stdio 的客户端。

Codex MCP 设置

打开 Codex 的 MCP 或连接器设置。

粘贴这个托管 MCP URL：

https://jtlgo.com/api/mcp

保存并重启 Codex，然后让它调用 get_mcp_config。

当你的 Codex 版本支持托管 HTTP MCP 时，优先使用连接器。如果只支持本地 stdio 服务器，再使用配置文件。

托管配置文件：

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp"

带私有 token 的本地 stdio 兜底配置：

[mcp_servers.jtlgo-commerce]
command = "node"
args = ["/Users/you/Downloads/jtlgo-commerce-mcp/scripts/jtlgo-commerce-mcp.mjs"]
env = { JTLGO_API_BASE_URL = "https://api.jtlgo.com", JTLGO_INTERNAL_TOKEN = "YOUR_JTLGO_INTERNAL_TOKEN", JTLGO_SITE = "jtlgo", JTLGO_RATE_API_URL = "https://api.jtlgo.com/sourcing/explore/shipping", JTLGO_RATE_TIMEOUT_MS = "4000", JTLGO_TRACK_API_URL = "https://api.jtlgo.com/api/logi/order/track/ex", JTLGO_TRACK_TIMEOUT_MS = "7000" }

codex mcp add jtlgo-commerce \
  --env JTLGO_API_BASE_URL=https://api.jtlgo.com \
  --env JTLGO_INTERNAL_TOKEN=YOUR_JTLGO_INTERNAL_TOKEN \
  --env JTLGO_SITE=jtlgo \
  --env JTLGO_TRACK_API_URL=https://api.jtlgo.com/api/logi/order/track/ex \
  -- node "/Users/you/Downloads/jtlgo-commerce-mcp/scripts/jtlgo-commerce-mcp.mjs"

Claude Desktop MCP 设置

打开 Claude 连接器面板。

把这个 URL 粘贴到 URL 字段：

https://jtlgo.com/api/mcp

点击保存。支持的 Claude 对话中会出现 JTLGO Commerce MCP。

托管连接器 JSON：

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

本地 stdio 兜底配置：

{
  "mcpServers": {
    "jtlgo-commerce": {
      "command": "node",
      "args": [
        "/Users/you/Downloads/jtlgo-commerce-mcp/scripts/jtlgo-commerce-mcp.mjs"
      ],
      "env": {
        "JTLGO_API_BASE_URL": "https://api.jtlgo.com",
        "JTLGO_INTERNAL_TOKEN": "YOUR_JTLGO_INTERNAL_TOKEN",
        "JTLGO_SITE": "jtlgo",
        "JTLGO_RATE_API_URL": "https://api.jtlgo.com/sourcing/explore/shipping",
        "JTLGO_RATE_TIMEOUT_MS": "4000",
        "JTLGO_TRACK_API_URL": "https://api.jtlgo.com/api/logi/order/track/ex",
        "JTLGO_TRACK_TIMEOUT_MS": "7000"
      }
    }
  }
}

Antigravity MCP 设置

打开 Antigravity MCP 设置，并选择 hosted 或 remote connector。

粘贴这个 URL：

https://jtlgo.com/api/mcp

保存并重启 Antigravity，然后测试 get_mcp_config、quote_shipping_rates 或 track_shipment。

托管连接器 JSON：

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

本地 stdio 兜底配置：

{
  "mcpServers": {
    "jtlgo-commerce": {
      "command": "node",
      "args": [
        "/Users/you/Downloads/jtlgo-commerce-mcp/scripts/jtlgo-commerce-mcp.mjs"
      ],
      "env": {
        "JTLGO_API_BASE_URL": "https://api.jtlgo.com",
        "JTLGO_INTERNAL_TOKEN": "YOUR_JTLGO_INTERNAL_TOKEN",
        "JTLGO_SITE": "jtlgo",
        "JTLGO_RATE_API_URL": "https://api.jtlgo.com/sourcing/explore/shipping",
        "JTLGO_RATE_TIMEOUT_MS": "4000",
        "JTLGO_TRACK_API_URL": "https://api.jtlgo.com/api/logi/order/track/ex",
        "JTLGO_TRACK_TIMEOUT_MS": "7000"
      }
    }
  }
}

任意 MCP 客户端

在客户端中选择 Streamable HTTP、hosted MCP、remote MCP 或 connector URL。

粘贴这个 URL：

https://jtlgo.com/api/mcp

调用 tools/list，或让 Agent 运行 get_mcp_config。

托管连接器配置：

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

本地 stdio 兜底配置：

{
  "mcpServers": {
    "jtlgo-commerce": {
      "command": "node",
      "args": [
        "/Users/you/Downloads/jtlgo-commerce-mcp/scripts/jtlgo-commerce-mcp.mjs"
      ],
      "env": {
        "JTLGO_API_BASE_URL": "https://api.jtlgo.com",
        "JTLGO_INTERNAL_TOKEN": "YOUR_JTLGO_INTERNAL_TOKEN",
        "JTLGO_SITE": "jtlgo",
        "JTLGO_RATE_API_URL": "https://api.jtlgo.com/sourcing/explore/shipping",
        "JTLGO_RATE_TIMEOUT_MS": "4000",
        "JTLGO_TRACK_API_URL": "https://api.jtlgo.com/api/logi/order/track/ex",
        "JTLGO_TRACK_TIMEOUT_MS": "7000"
      }
    }
  }
}

如果手机 App 不能接 MCP，复制这段 Prompt。

适用于 ChatGPT 手机端、Gemini 手机端，或任何不能添加自定义 MCP 连接器的 AI App。它不会让 App 获得实时 API 能力，但会约束 AI 不编造结果，并把用户引导到 JTLGO 页面或人工支持。

无 MCP 手机端兜底 Prompt

ChatGPT · Gemini · Mobile AI

你现在帮我使用 JTLGO 做中国采购、运费报价和物流追踪，但当前聊天没有接入 JTLGO MCP 工具，也不能调用 JTLGO 实时 API。

规则：
1. 用我使用的语言回答。
2. 不要编造实时商品库存、精确运费、承运商扫描节点、清关规则或送达承诺。
3. 如果商品、运输路线或物流状态不确定，要明确说明需要 JTLGO 人工确认。
4. 做商品采购时，先向我收集：商品名称、规格、数量、目标价格、目的国、用途，以及供应商/商品链接或图片。
5. 做运费预估时，先向我收集：目的国/城市、实重、包裹尺寸、货物类型、是否含电池/液体/磁性/品牌、申报价值、期望时效。
6. 做物流追踪时，先向我收集：追踪号、JTLGO 订单号、已知承运商、目的国、最后可见轨迹节点。
7. 需要实时确认时，只引导我使用这些官方入口：
- 运费报价页：https://jtlgo.com/rate-and-ship/
- 物流追踪页：https://jtlgo.com/tracking/
- 联系页面：https://jtlgo.com/contact-us/
- WhatsApp：+86 139 2810 3300
- 邮箱：sales [at] jtlgo.com

输出格式：
- 根据已提供信息可以判断什么
- 还缺哪些信息
- 最安全的下一步
- 如果需要人工支持，帮我生成一段可直接发给 JTLGO 的简短消息

这个 MCP 面向的利基使用场景。

页面背后的搜索意图很明确：AI Agent 需要电商工具、商品搜索 API、中国采购流程、运费预估和包裹追踪，而不想从零开发集成。

commerce MCP server 用于电商商品搜索和订单支持的本地 AI Agent 工具。

ecommerce MCP server 适合想让 AI 客户端搜索商品但不想写自定义应用的买家。

product search MCP 把商品目录搜索能力暴露给 Codex、Claude Desktop 和 Antigravity 的利基词。

shipping rates MCP 把 AI Agent 接到中国运费预估和物流路线对比。

shipment tracking MCP 让 AI Agent 查询 JTLGO 物流单号并总结包裹轨迹。

parcel tracking MCP 覆盖包裹状态、最新扫描、承运商交接和异常查询意图。

order tracking MCP 用于检查 JTLGO 订单追踪号，并在需要时升级到人工支持。

China shipping rate API 面向 DDP、小包、空运、海运和快递报价的商业物流意图。

Codex MCP server setup 面向使用 Codex 配置本地 MCP 工具的开发者和运营。

Claude Desktop MCP setup 面向本地 stdio MCP 配置的新手安装意图。

local stdio MCP server 匹配这个包在用户电脑上运行方式的技术词。

AI agent product search API 面向商品发现和采购工作流的 Agentic commerce 词。

China sourcing MCP JTLGo 在采购、商品详情、运费和人工转接上的利基定位。

安全规则： 托管连接器模式不需要你在页面里粘贴私有 token。如果使用本地 stdio 模式，请保护好 JTLGO_INTERNAL_TOKEN；程序只在本地读取它，不会从任何工具返回该 token。

新手常见问题排查。

大多数 MCP 接入失败来自四类问题：没有安装 Node.js、服务器路径错误、token 错误，或修改配置后没有重启 AI 客户端。

无法识别 "node"

安装 Node.js 20 或更新版本，关闭 Terminal/PowerShell 后重新打开，再运行 node -v。

"server failed to start"

检查配置路径是否指向真实文件，并且以 scripts/jtlgo-commerce-mcp.mjs 结尾。

"unauthorized" 或 "token invalid"

把 YOUR_JTLGO_INTERNAL_TOKEN 换成你的私有 token，不要多加空格或引号，除非客户端明确要求。

"tools do not appear"

完整重启 AI 客户端。桌面应用只关闭窗口通常不够，需要退出并重新打开。

"product search is not confident"

让 Agent 使用更清晰的商品词、提供来源 URL，或调用 human_handoff 走邮件/WhatsApp 人工帮助。

"shipping quote is empty"

提供目的国代码、实重、尺寸和货物类型。电池、液体、超大件和敏感货可能需要人工路线判断。

"tracking is blank"

检查追踪号格式、承运商、订单号和目的国。如果轨迹仍为空，调用 human_handoff 进行人工复核。

常见问题。

这是 Chrome 插件吗？

不是。它支持托管 HTTP 连接器 URL 和本地 stdio 包，不需要 Chrome 插件。

非开发人员能用吗？

可以。最简单的方式是粘贴连接器 URL。如果你的客户端不支持托管连接器，再使用配置文件或本地包兜底。

支持哪些 AI 客户端？

页面提供 Codex、Claude Desktop 和 Antigravity 示例。任何支持托管 HTTP MCP 或本地 stdio MCP 的客户端都可以使用其中一种方式接入。

第一个提示词应该怎么写？

让 AI 客户端调用 get_mcp_config。然后用一个简单请求测试 search_products、quote_shipping_rates 或 track_shipment。

可以追踪 JTLGO 物流吗？

可以。使用 track_shipment 输入 JTLGO 追踪号、包裹追踪号或订单追踪 ID。如果找不到可信轨迹，工具会返回人工支持建议。

什么时候应该用人工支持而不是 MCP 输出？

当商品身份不确定、可能存在运输限制、运费看起来不完整，或买家需要人工采购确认时，应使用人工支持。