Saltar al contenido principal

JTLGO Commerce MCP

Una conexión MCP para comercio público y trabajo de cuenta.

El conector público sirve para búsqueda de productos, tarifas desde China y seguimiento. El conector de cuenta inicia OAuth automáticamente y abre herramientas autenticadas para resumen de cuenta, work items y tickets de soporte.

Endpoint público https://jtlgo.com/api/mcp

Ejecutando handshake MCP…

Protocolo
—
Herramientas
—
Latencia
—

Comparar los dos conectores

Primero elija el modo de acceso correcto.

La división real del producto no es “URL hospedada vs archivo de configuración”. La decisión correcta es si el cliente debe usar solo herramientas públicas o iniciar OAuth para herramientas de cuenta.

Conector de cuenta

Use este único endpoint para todas las herramientas públicas y las herramientas de cuenta con alcance. El cliente MCP inicia OAuth cuando hace falta; la página nunca maneja el token.

10 herramientas · OAuth solo cuando se necesitan datos de cuenta

https://jtlgo.com/api/mcp/account

Ambas URL ofrecen las mismas 6 herramientas públicas. Añada la URL de cuenta solo cuando el asistente deba leer o escribir datos del cliente: es un conector, no dos.

Elija su cliente.

Use la URL pública solo para trabajo anónimo. Use la URL de cuenta como conector único para herramientas públicas y de cuenta.

Pegue esta URL del conector

No requiere inicio de sesión para descubrir herramientas. Ideal para sourcing y logística generales.

https://jtlgo.com/api/mcp

Config JSON

Use el mismo endpoint en el campo connector del cliente o dentro del archivo de configuración.

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

Config TOML

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

Pegue esta URL del conector

Use este único endpoint para todas las herramientas públicas y las herramientas de cuenta con alcance. El cliente MCP inicia OAuth cuando hace falta; la página nunca maneja el token.

https://jtlgo.com/api/mcp/account

Config JSON

Use el mismo endpoint en el campo connector del cliente o dentro del archivo de configuración.

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

Config TOML

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

Configuración del conector de cuenta

Use este único endpoint para todas las herramientas públicas y las herramientas de cuenta con alcance. El cliente MCP inicia OAuth cuando hace falta; la página nunca maneja el token.

https://jtlgo.com/api/mcp/account

4 dominios de herramientas autenticadas

Estas cuatro herramientas aparecen solo después de que el cliente complete OAuth.

get_account_summary

Lee el resumen de cuenta y el estado del cliente que el conector puede exponer.

list_customer_work_items

Lista los work items del cliente que aún requieren atención.

get_customer_work_item

Abre un work item concreto para que el asistente continúe.

create_support_ticket

Crea un ticket de soporte con alcance cuando se necesita escalar.

Matriz de herramientas públicas

Estas son las seis herramientas expuestas hoy por el conector público.

HerramientaUsoEntrada típicaDevuelve
search_products Descubrimiento de catálogo keyword, site, limit Candidatos de producto seguros
quote_shipping_rates Estimación de ruta desde China countryCode, weight, dimensions Opciones de ruta y peso facturable
track_shipment Tracking de pedido y paquete tracking number o lista Última línea de tiempo y pista de excepción
get_product_detail Inspección de un producto id o product URL Campos seguros de detalle
human_handoff Escalación manual language, reason Ruta de soporte por email y WhatsApp
get_mcp_config Verificación de instalación none Metadatos del conector y lista de herramientas

4 dominios de herramientas autenticadas

Lecturas de fondo

Tres artículos sobre por qué llega la compra mediada por agentes, qué trabajo de abastecimiento elimina y cómo se conectan las herramientas de flete.

Antes de salir de esta página

¿Por qué la prueba usa POST?

Porque el endpoint MCP ahora exige POST JSON-RPC y el antiguo GET metadata responde 405.

Flujo de verificación pública POST initialize → notification initialized → tools/list. Después llame get_mcp_config o search_products.

¿Cuándo uso el conector de cuenta?

Cuando el asistente debe iniciar OAuth automáticamente y acceder a herramientas bajo account:read, work_items:read o support:write.

¿Debo conservar las dos URL?

No. Elija público para uso anónimo o cuenta como un solo conector con herramientas públicas y de cuenta.