Saltar al contenido principal
Volver a todos los artículos

Servidor MCP para cotizar fletes y rastrear envíos

Publicado 16 sept 2026 Actualizado 17 sept 2026
Responsabilidad editorial JTLGO Editorial Team
Revisión operativa JTLGO Sourcing Operations Review 16 sept 2026
Política editorial
En esta página
  1. Qué hace un servidor MCP para logística
  2. Las herramientas que debe exponer un servidor MCP de fletes
  3. La cotización cambia según el modo, y con ella las entradas
  4. Cómo conectar un servidor
  5. Acceso público y acceso con cuenta
  6. Qué comprobar antes de confiar en un conector de fletes
  7. Preguntas frecuentes
Servidor MCP para cotizar fletes y rastrear envíos

Qué hace un servidor MCP para logística

Un servidor MCP para fletes expone la cotización y el rastreo como herramientas tipadas, de modo que un asistente puede pedir una cotización o el estado de un envío directamente, sin que una persona tenga que abrir un portal de tarifas. MCP, el Model Context Protocol, es la capa de interfaz: define cómo un cliente como Claude, ChatGPT, Codex, Cursor o VS Code descubre qué herramientas ofrece un servidor, qué argumentos recibe cada una y con qué estructura vuelve la respuesta. En logística, eso convierte dos tareas recurrentes, «¿cuánto va a costar?» y «¿dónde está?», en llamadas a funciones.

El resto del artículo explica qué esperar de cada tipo de herramienta, cómo cambia la cotización según el modo de transporte y cómo conectar un servidor que funcione. Los ejemplos usan el conector público JTLGO Commerce MCP, que cotiza rutas con origen en China y rastrea envíos.

Las herramientas que debe exponer un servidor MCP de fletes

Un servidor útil es pequeño. Cuatro a seis herramientas bien especificadas valen más que veinte vagas, porque el cliente tiene que elegir entre ellas solo a partir de la descripción.

HerramientaPara qué sirveEntrada típicaDevuelve
quote_shipping_ratesEstimar ruta y costopeso, país de destino, largo, ancho, alto, tipo de mercancíaOpciones de ruta con peso facturable y tiempo de tránsito estimado
track_shipmentEstado de un paquete o pedidoun número de rastreo o una listaÚltimos eventos de la línea de tiempo y un aviso de incidencia
search_productsEncontrar lo que se va a enviarpalabra clave, plataforma, límiteArtículos candidatos con sus identificadores
get_product_detailConfirmar un artículo antes de cotizarid de producto o URLCampos de especificación, incluido el peso cuando está publicado
human_handoffEscalar cuando la confianza es bajaidioma, motivoUna vía de soporte que pueda atender una persona
get_mcp_configVerificar la conexiónningunaMetadatos del conector y la lista de herramientas

Las dos últimas importan más de lo que parece. Una herramienta de configuración te permite comprobar que el conector responde sin gastar una consulta de tarifas, y una herramienta explícita de traspaso a una persona le da al asistente adónde ir cuando la respuesta es realmente incierta, en lugar de inventarse una cifra.

La cotización cambia según el modo, y con ella las entradas

Los compradores buscan «MCP server for LTL quote» y «MCP server for FTL quote» como si cotizar fuera un solo problema, igual que tratan la pila de protocolos de agentes como una sola cosa. No lo es. El modo determina qué datos debe exigir una herramienta de cotización, y una herramienta que acepta demasiado poco produce disparates con total seguridad.

ModoQué determina el precioDatos que debe exigir una herramienta de cotización
Paquetería y exprésEl mayor entre el peso real y el peso volumétricoPeso, las tres dimensiones, destino, tipo de mercancía
LTL, carga parcial de camiónClase de flete o densidad, más servicios adicionalesNúmero de palés, dimensiones, clase o densidad, servicios adicionales de recogida y entrega
FTL, camión completoRuta, tipo de equipo y fechaPuntos de origen y destino, tipo de remolque, fecha de recogida
Carga aéreaPeso tasable según un divisor volumétricoPeso bruto, dimensiones, par de aeropuertos, restricciones de mercancía
Marítimo, LCL y FCLMetros cúbicos, o número y tipo de contenedoresVolumen o tipo de contenedor, par de puertos, incoterm

Dos consecuencias prácticas. Primero, cualquier herramienta de cotización que acepte un peso sin dimensiones está adivinando, porque en casi todos los modos la cifra facturable es volumétrica. Segundo, la cotización doméstica LTL y FTL dentro del país de destino es una fuente de datos distinta de la cotización de exportación internacional; un servidor que hace una no hace automáticamente la otra. Comprueba a cuál te estás conectando antes de montar un flujo de trabajo sobre él.

El conector de JTLGO cotiza rutas con origen en China, es decir, opciones exprés, aéreas y marítimas desde China con el peso facturable calculado a partir de las dimensiones que indiques. No cotiza transporte en camión dentro del país de destino. El mismo motor de tarifas está disponible para personas en Rate and Ship, y la misma línea de tiempo en el rastreo de envíos. Es un alcance deliberado, y es mejor conocerlo de entrada que descubrirlo dentro del bucle de un agente.

Cómo conectar un servidor

Un servidor MCP alojado es una URL. La mayoría de los clientes no necesita nada más, y el transporte es JSON-RPC sobre HTTP POST.

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

Para verificar la conexión a mano antes de configurarla en un cliente, envía una llamada de inicialización y luego lista las herramientas. El endpoint exige POST y una cabecera Accept que indique tanto JSON como el tipo event-stream; una petición GET simple se rechaza a propósito.

curl -X POST https://jtlgo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Una llamada de cotización es como cualquier otra invocación de herramienta. Indica las dimensiones, no solo el peso.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "quote_shipping_rates",
    "arguments": {
      "weight": 12,
      "countryCode": "US",
      "length": 40,
      "width": 30,
      "height": 25,
      "goodsType": "general"
    }
  }
}

Acceso público y acceso con cuenta

Los conectores de fletes suelen necesitar dos niveles, y mezclarlos es el error de integración más común. Las herramientas abiertas, como la cotización y el rastreo público, no requieren iniciar sesión, porque no hay nada propio de una cuenta que proteger. Todo lo que lee los pedidos, tareas o historial de soporte de un cliente sí lo requiere, y ahí es donde corresponde OAuth.

JTLGO lo expone como dos URL sobre un mismo servidor: https://jtlgo.com/api/mcp para las seis herramientas públicas y https://jtlgo.com/api/mcp/account para esas mismas seis más cuatro herramientas ligadas a la cuenta, donde el cliente inicia un flujo OAuth solo cuando de verdad se solicitan datos de la cuenta. Elige la URL de cuenta cuando el asistente deba responder preguntas sobre los envíos de un cliente concreto, y la URL pública cuando no. No se gana nada configurando ambas.

Qué comprobar antes de confiar en un conector de fletes

  • ¿Una llamada a una herramienta llega realmente al sistema de origen? Que un servidor responda a tools/list no significa que funcione. Las llamadas de listado suelen servirse desde un esquema estático. Llama a una herramienta real.
  • ¿La herramienta de cotización exige dimensiones? Si acepta solo el peso, su resultado será erróneo para todo lo ligero y voluminoso, que es la mayoría de los bienes de consumo.
  • ¿El rastreo distingue entre «aún sin datos» y «no encontrado»? Significan cosas distintas para un cliente, y un conector que los confunde hará que el asistente tranquilice al cliente con total seguridad y sin razón.
  • ¿Hay una vía de escalado explícita? Los motores de tarifas no devuelven nada para mercancías restringidas y rutas poco habituales. Lo correcto es pasar el caso a una persona, no extrapolar.
  • ¿El alcance está indicado con claridad? Regiones de origen, modos cubiertos y si incluye la cotización de camión doméstico.

Preguntas frecuentes

¿Qué es un servidor MCP para fletes?

Un servicio que expone la cotización de fletes y el rastreo de envíos como herramientas invocables a través del Model Context Protocol, para que un asistente de IA pueda pedir una cotización o un estado directamente, en lugar de que una persona use un portal de tarifas.

¿Puede un servidor MCP cotizar tarifas LTL y FTL?

Sí, si está conectado a un motor de tarifas de transportista para esos modos y exige los datos correctos: número de palés, dimensiones y clase de flete para LTL, y ruta, tipo de equipo y fecha de recogida para FTL. Muchos conectores logísticos, incluido el de JTLGO, cubren modos de exportación internacional y no el transporte en camión doméstico, así que confirma el alcance antes de depender de él.

¿Necesito una API key para usar un servidor MCP de logística?

Para la cotización y el rastreo públicos, normalmente no. Para todo lo que lea la cuenta de un cliente concreto, sí, y debería ser un flujo OAuth iniciado por el cliente, no una clave pegada en un archivo de configuración.

¿Qué clientes MCP pueden usarlo?

Cualquier cliente compatible con servidores HTTP alojados, lo que hoy incluye Claude, ChatGPT, Codex, Cursor y VS Code. El conector es una URL; el cliente se encarga del transporte.

¿Por qué el endpoint rechaza las peticiones GET?

Porque el transporte HTTP de MCP es JSON-RPC sobre POST. Un GET que devolviera metadatos sería una segunda interfaz sin documentar, así que se rechaza con un 405 en lugar de admitirlo de manera informal.

Fuentes y referencias

Comparte este artículo: