Servidor JTLGO Commerce MCP

Conecte búsqueda de productos, tarifas de envío desde China y seguimiento a su asistente de IA.

Conecte mediante una URL de conector MCP alojado o un archivo de configuración para Codex, Claude Desktop, Antigravity y otros clientes MCP. Su agente podrá buscar productos JTLGo, estimar tarifas desde China, rastrear envíos, revisar detalles de producto y escalar casos inciertos a un operador real.

Respuesta rápida: https://jtlgo.com/api/mcp - use la URL del conector alojado si su cliente de IA lo permite. Si no, use el archivo de configuración o el paquete local stdio.

Descargar paquete MCP Iniciar configuración rápida Elegir cliente

6 Herramientas de agente

3+ Clientes de IA

0 Extensiones de navegador

24/7 Acceso local al agente

¿Qué es MCP en lenguaje sencillo para compradores?

MCP significa Model Context Protocol. Piense en él como un conector seguro entre su asistente de IA y un conjunto pequeño de herramientas de negocio. En lugar de copiar datos entre pestañas, hace una pregunta en lenguaje natural y el asistente llama a las herramientas de JTLGO para búsqueda de productos, sourcing en China, tarifas de envío y seguimiento.

Lenguaje natural entra. Acciones comerciales salen.

Un chat normal solo responde con contexto. Con MCP, el asistente puede usar herramientas aprobadas de JTLGO: buscar productos, cotizar envíos, rastrear paquetes, revisar detalles y pedir soporte humano cuando la respuesta sea riesgosa.

Usted hace una pregunta de sourcing.Ejemplo: encuentre 3 bolsas impermeables y estime el envío de 2 kg a EE. UU.

Su cliente de IA llama herramientas MCP.La solicitud queda dentro de su cliente local y el servidor MCP aprobado de JTLGO.

JTLGO devuelve respuestas estructuradas.El asistente compara productos, tarifas, confianza y próximos pasos.

Los casos inciertos pasan a humanos.Carga restringida, productos poco claros y compras manuales se escalan por email o WhatsApp.

Qué añade JTLGO MCP a su asistente de IA.

El flujo es simple: MCP convierte el asistente en un operador que puede usar herramientas reales con seguridad. En JTLGO, esas herramientas se centran en sourcing ecommerce y logística desde China.

Descubrimiento de productos

Busca candidatos de sourcing, compara campos seguros y evita respuestas demasiado seguras cuando el producto no está claro.

Estimaciones de envío

Cotiza rutas desde China por país, peso, dimensiones, tipo de carga y restricciones.

Seguimiento de envíos

Rastrea paquetes, envíos y números de pedido de JTLGO, y resume el último evento y posibles excepciones.

Revisión de detalles

Consulta detalles de producto y contexto de proveedor sin exponer campos privados del backend.

Traspaso humano

Escala coincidencias inciertas, carga sensible y solicitudes manuales a email o WhatsApp.

Herramientas MCP disponibles

search_products para descubrimiento de productos.
quote_shipping_rates para estimar envíos desde China.
track_shipment para líneas de tiempo de paquetes, envíos y pedidos.
get_product_detail para revisar detalles seguros.
human_handoff para soporte humano.
get_mcp_config para verificar la instalación.

Vea el flujo del agente antes de instalar.

Este es el flujo que el comprador debe entender: pregunta una vez y el agente elige búsqueda de producto, cotización, seguimiento y soporte humano cuando hace falta.

Prompt de ejemplo Búsqueda + envío + seguimiento + regla de traspaso

Use search_products de jtlgo-commerce para encontrar 3 bolsas impermeables, luego cotice el envío de 2 kg a EE. UU. Si no hay confianza suficiente, use human_handoff.

Primero llamaré get_mcp_config, luego search_products y quote_shipping_rates. Si la coincidencia no es segura o hay restricciones de carga, usaré human_handoff en vez de presentar la respuesta como final.

Primero llame get_mcp_config. Luego llame search_products con keyword "wireless earbuds" y limit 3. Después llame quote_shipping_rates con countryCode "US" y weight 2.

Llame track_shipment para el número JTL123456789. Si no hay una línea de tiempo confiable, indique qué datos debe enviar el cliente a soporte de JTLGO.

Llamaré track_shipment. Si JTLGO no encuentra una línea de tiempo confiable, pediré número de tracking, número de pedido, carrier, país destino y último evento visible antes de escalar a soporte.

Inicio rápido: elija la ruta más fácil.

Empiece con la URL del conector alojado. Use snippets de configuración solo si el cliente no tiene formulario de conector, y use el paquete local solo si requiere stdio.

Elija Connector primero

Pegue la URL MCP alojada si el cliente tiene connector, remote MCP o Streamable HTTP.

Use Config file después

Si no hay formulario de conector, copie el JSON o TOML del cliente correspondiente.

Use paquete local como fallback

Descargue el zip solo cuando el cliente soporte stdio local pero no conectores alojados.

Verifique una herramienta

Reinicie el cliente, llame get_mcp_config y pruebe search_products, quote_shipping_rates o track_shipment.

Elija su cliente MCP.

Cada cliente tiene dos patrones: Connector para el setup alojado más rápido, y Config file para JSON, TOML o stdio local.

Configuración MCP en Codex

Abra los ajustes MCP o connector de Codex.

Pegue esta URL MCP alojada:

https://jtlgo.com/api/mcp

Guarde, reinicie Codex y pida que llame get_mcp_config.

Use Connector primero si su versión de Codex soporta HTTP MCP alojado. Si solo soporta stdio local, use Config file.

Config alojada:

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

Fallback stdio local con token privado:

[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"

Configuración MCP en Claude Desktop

Abra el panel de conectores de Claude.

Pegue esta URL en el campo URL:

https://jtlgo.com/api/mcp

Haga clic en Save. JTLGO Commerce MCP estará disponible en conversaciones compatibles.

JSON de conector alojado:

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

Fallback stdio local:

{
  "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"
      }
    }
  }
}

Configuración MCP en Antigravity

Abra ajustes MCP de Antigravity y elija hosted o remote connector.

Pegue esta URL:

https://jtlgo.com/api/mcp

Guarde, reinicie Antigravity y pruebe get_mcp_config, quote_shipping_rates o track_shipment.

JSON de conector alojado:

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

Fallback stdio local:

{
  "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"
      }
    }
  }
}

Cualquier cliente MCP

Elija Streamable HTTP, hosted MCP, remote MCP o connector URL.

Pegue esta URL:

https://jtlgo.com/api/mcp

Llame tools/list o pida al agente ejecutar get_mcp_config.

Config de conector alojado:

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

Fallback stdio local:

{
  "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"
      }
    }
  }
}

If your mobile app cannot connect MCP, copy this prompt.

Use this fallback in ChatGPT mobile, Gemini mobile, or any AI app that cannot add a custom MCP connector. It does not create live API access; it gives the assistant strict rules, required fields, and safe handoff paths.

No-MCP mobile fallback prompt

ChatGPT · Gemini · Mobile AI

You are helping me use JTLGO for China sourcing, shipping rates, and shipment tracking, but this chat does NOT have access to JTLGO MCP tools or live JTLGO APIs.

Rules:
1. Answer in the same language I use.
2. Do not invent live product availability, exact shipping prices, carrier scans, customs rules, or delivery promises.
3. If the product, shipping route, or tracking status is uncertain, clearly say it needs JTLGO manual confirmation.
4. For product sourcing, ask for product name, specs, quantity, target price, destination country, use case, and any supplier/product links or images.
5. For shipping rates, ask for destination country/city, actual weight, package dimensions, cargo type, battery/liquid/magnet/brand status, declared value, and delivery speed preference.
6. For tracking, ask for tracking number, JTLGO order number, carrier if known, destination country, and the last visible tracking event.
7. Use these official next steps when live confirmation is needed:
- Rate quote page: https://jtlgo.com/rate-and-ship/
- Tracking page: https://jtlgo.com/tracking/
- Contact page: https://jtlgo.com/contact-us/
- WhatsApp: +86 139 2810 3300
- Email: sales [at] jtlgo.com

Output format:
- What I can assess from the information provided
- Missing details I need from you
- Safest next action
- A short message I can send to JTLGO support if manual help is needed

Casos de uso nicho para este MCP.

Estas son las búsquedas reales detrás de la página: agentes IA que necesitan herramientas ecommerce, API de búsqueda, sourcing en China, tarifas de envío y tracking sin construir una integración desde cero.

commerce MCP server Local AI agent tool for ecommerce product search and order support.

ecommerce MCP server Best fit for buyers who want AI clients to search products without custom app code.

product search MCP Niche term for exposing catalog search to Codex, Claude Desktop, and Antigravity.

shipping rates MCP Connects AI agents to China shipping-rate estimates and freight route comparison.

shipment tracking MCP Lets AI agents check JTLGO shipment tracking numbers and summarize parcel timelines.

parcel tracking MCP Logistics intent for tracking package status, latest scans, carrier handoff, and exceptions.

order tracking MCP Support intent for checking JTLGO order tracking numbers before escalating to manual help.

China shipping rate API Commercial logistics intent for DDP, parcel, air, sea, and express quotes.

Codex MCP server setup Setup intent for developers and operators using Codex with local MCP tools.

Claude Desktop MCP setup Beginner install intent for local stdio MCP configuration.

local stdio MCP server Technical phrase that matches how this package runs on a user machine.

AI agent product search API Agentic commerce term for product discovery and sourcing workflows.

China sourcing MCP Niche JTLGo positioning for sourcing, product details, freight, and human handoff.

Regla de seguridad: el modo connector alojado no requiere pegar un token privado en la página. Si usa stdio local, mantenga JTLGO_INTERNAL_TOKEN privado; el paquete lo lee localmente y nunca lo devuelve desde una herramienta.

Solución de problemas para principiantes.

La mayoría de fallos vienen de cuatro causas: falta Node.js, ruta del servidor incorrecta, token incorrecto o el cliente IA no se reinició tras editar la config.

No se reconoce "node"

Instale Node.js 20 o superior, cierre Terminal/PowerShell, vuelva a abrirlo y ejecute node -v.

"server failed to start"

Verifique que la ruta termine en scripts/jtlgo-commerce-mcp.mjs.

"unauthorized" o "token invalid"

Reemplace YOUR_JTLGO_INTERNAL_TOKEN por su token privado sin espacios extra.

"tools do not appear"

Reinicie completamente el cliente IA. En apps de escritorio, cerrar la ventana no siempre basta.

"product search is not confident"

Use términos más claros, proporcione una URL o llame human_handoff para email/WhatsApp.

"shipping quote is empty"

Indique país, peso real, dimensiones y tipo de carga. Mercancías sensibles pueden requerir revisión manual.

"tracking is blank"

Revise formato del tracking, carrier, pedido y país destino. Si sigue vacío, llame human_handoff.

Preguntas frecuentes.

¿Es una extensión de Chrome?

No. Soporta URL de conector HTTP alojado y paquete stdio local. No requiere Chrome.

¿Puede usarlo alguien sin programar?

Sí. Lo más fácil es pegar la URL del conector. Si su cliente no lo soporta, use config o paquete local.

¿Qué clientes IA soporta?

La página incluye Codex, Claude Desktop y Antigravity. Cualquier cliente con HTTP MCP alojado o stdio local puede usar uno de los dos patrones.

¿Cuál debería ser mi primer prompt?

Pida llamar get_mcp_config. Luego pruebe search_products, quote_shipping_rates o track_shipment.

¿Puede rastrear envíos JTLGO?

Sí. Use track_shipment con número de tracking, paquete o pedido. Si no hay línea confiable, devuelve guía de soporte humano.

¿Cuándo usar soporte humano?

Cuando el producto sea incierto, haya restricciones, tarifas incompletas o se necesite confirmación manual de compra.