Servidor MCP para cotizar fletes y rastrear envíos
En esta página
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.
Desliza lateralmente o usa las flechas para ver todas las columnas.
| Herramienta | Para qué sirve | Entrada típica | Devuelve |
|---|---|---|---|
| quote_shipping_rates | Estimar ruta y costo | peso, país de destino, largo, ancho, alto, tipo de mercancía | Opciones de ruta con peso facturable y tiempo de tránsito estimado |
| track_shipment | Estado de un paquete o pedido | un número de rastreo o una lista | Últimos eventos de la línea de tiempo y un aviso de incidencia |
| search_products | Encontrar lo que se va a enviar | palabra clave, plataforma, límite | Artículos candidatos con sus identificadores |
| get_product_detail | Confirmar un artículo antes de cotizar | id de producto o URL | Campos de especificación, incluido el peso cuando está publicado |
| human_handoff | Escalar cuando la confianza es baja | idioma, motivo | Una vía de soporte que pueda atender una persona |
| get_mcp_config | Verificar la conexión | ninguna | Metadatos 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.
Desliza lateralmente o usa las flechas para ver todas las columnas.
| Modo | Qué determina el precio | Datos que debe exigir una herramienta de cotización |
|---|---|---|
| Paquetería y exprés | El mayor entre el peso real y el peso volumétrico | Peso, las tres dimensiones, destino, tipo de mercancía |
| LTL, carga parcial de camión | Clase de flete o densidad, más servicios adicionales | Número de palés, dimensiones, clase o densidad, servicios adicionales de recogida y entrega |
| FTL, camión completo | Ruta, tipo de equipo y fecha | Puntos de origen y destino, tipo de remolque, fecha de recogida |
| Carga aérea | Peso tasable según un divisor volumétrico | Peso bruto, dimensiones, par de aeropuertos, restricciones de mercancía |
| Marítimo, LCL y FCL | Metros cúbicos, o número y tipo de contenedores | Volumen 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/listno 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
- Model Context Protocol specification Model Context Protocol
- JTLGO Commerce MCP connector JTL Global