跳到主要内容
JTLGO Commerce MCP

一个 MCP 连接,覆盖公开工具与账户工作。

Public connector 用于公开商品搜索、中国报价和物流追踪。Account connector 会自动拉起 OAuth,并在登录后开放账户摘要、工作项和支持工单类工具。

Public connector

无需登录即可发现和调用公开工具,适合通用采购与物流查询。

https://jtlgo.com/api/mcp
Account connector

这个单一端点同时提供公开工具和带 scope 的账户工具;需要账户权限时由 MCP 客户端拉起 OAuth,网页本身不会接触 token。

https://jtlgo.com/api/mcp/account
打开 Account connector
2 种访问模式

Public connector 与 Account connector

6 个公开工具

搜索、报价、追踪、详情、转人工、配置校验

Account 模式共 10 个工具

6 个公开工具 + 4 个带 scope 的账户工具

Account connector 设置

这个单一端点同时提供公开工具和带 scope 的账户工具;需要账户权限时由 MCP 客户端拉起 OAuth,网页本身不会接触 token。

get_account_summary 读取账户摘要和连接器允许暴露的客户级状态。
list_customer_work_items 列出当前仍需处理的客户工作项。
get_customer_work_item 打开单个客户工作项详情供助手继续处理。
create_support_ticket 当需要升级时创建带 scope 的支持工单。

选择你的客户端。

只做匿名查询时使用 Public URL;需要全部公开工具和账户工具时,只配置 Account URL 即可。

Codex / ChatGPT

公开物流查询优先用 Public URL;当客户端需要自动拉起 OAuth 并读取账户数据时,切换到 Account URL。

粘贴这个连接器 URL

无需登录即可发现和调用公开工具,适合通用采购与物流查询。

https://jtlgo.com/api/mcp

既可以直接填在客户端 connector 输入位,也可以写入配置文件。

Public connector

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

TOML 配置

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

Public 工具矩阵

以下 6 个工具来自当前 Public connector。

工具用途典型输入返回结果
search_products 商品发现 keyword, site, limit 安全候选商品列表
quote_shipping_rates 中国路线报价 countryCode, weight, dimensions 线路和计费重方案
track_shipment 订单和包裹追踪 tracking number 或列表 最新轨迹和异常提示
get_product_detail 单商品检查 id 或 product URL 安全商品详情字段
human_handoff 人工兜底 language, reason 邮件和 WhatsApp 支持路径
get_mcp_config 安装校验 none 连接器元数据和工具列表

这个页面已经去掉的内容

  • OK 不再主推 ZIP 下载。
  • OK 不再展示本地包安装路径。
  • OK 不再展示私密凭证指引。
  • OK 匿名访问时不会主动请求 auth/me。

离开页面前确认三件事

为什么测试要用 POST?

因为 MCP 端点现在强制 POST JSON-RPC,旧的 GET metadata 已经按规范返回 405。

什么时候用 Account connector?

当助手需要自动拉起 OAuth,并访问 account:read、work_items:read 或 support:write 下的客户工具时。

两个 URL 都要保留吗?

不需要。匿名使用选 Public;需要全部公开与账户工具时,只选 Account。