MCP Server

Conecta cualquier AI assistant (Claude, GPT, etc.) con Fletea usando el protocolo MCP. Tu asistente podra crear envios, rastrear paquetes, cotizar y mas — todo desde una conversacion natural.

🤖

6 herramientas

Crear envio, rastrear, cotizar, listar, cancelar y descargar guia

⚡

Instalacion rapida

Un solo comando npm y listo

🔒

Seguro

Usa tu API Key de Fletea, nada mas

Que es MCP

MCP (Model Context Protocol) es un protocolo abierto que permite a los AI assistants conectarse con herramientas externas. En lugar de copiar y pegar datos, tu asistente puede hablar directamente con Fletea.

Por ejemplo, puedes decirle a Claude:

"Crea un envio de CDMX a Guadalajara, 2.5 kg, zapatos deportivos"

Y Claude usara la API de Fletea para crear la orden, darte el numero de guia y descargar la etiqueta — todo automatico.

Instalacion

1

Instalar el paquete

npm install @fletea/mcp-server

2

Obtener tu API Key

Ve a Dashboard > Configuracion > API Keys y crea una key con los permisos que necesites.

3

Configurar tu asistente

Agrega Fletea como server MCP en la configuracion de tu AI assistant (ver abajo).

Configuracion para Claude Desktop

Abre el archivo de configuracion de Claude Desktop y agrega esto:

{
  "mcpServers": {
    "fletea": {
      "command": "npx",
      "args": ["@fletea/mcp-server"],
      "env": {
        "FLETEA_API_KEY": "flt_tu_api_key"
      }
    }
  }
}

🚀

Donde esta el archivo de configuracion?

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%\Claude\claude_desktop_config.json

Herramientas disponibles

Cuando conectas el MCP Server, tu asistente tiene acceso a estas 6 herramientas:

Herramienta	Que hace
create_shipment	Crea un nuevo envio con direcciones y paquete
track_order	Rastrea un envio por numero de guia
get_quote	Cotiza un envio (precio estimado y tiempo)
list_orders	Lista tus envios con filtros y paginacion
cancel_order	Cancela un envio pendiente
get_label	Descarga la guia PDF de un envio

Ejemplos de uso

Una vez configurado, puedes hablar con tu asistente de forma natural:

Cuanto cuesta enviar 3 kg de Monterrey a CDMX?

Segun la cotizacion de Fletea: $179 MXN por envio estandar, entrega estimada en 3-4 dias habiles. Quieres que cree el envio?

Si, crealo. Recoleccion en Av Universidad 1000, Col Centro, Monterrey. Entrega a Juan Perez, Reforma 456, Juarez, CDMX 06600, tel 5559876543

Listo! Envio creado con guia FLT-784512. Quieres que descargue la etiqueta PDF?

Variables de entorno

Variable	Requerida	Descripcion
FLETEA_API_KEY	Si	Tu API Key de Fletea (empieza con flt_)
FLETEA_BASE_URL	No	URL base de la API (default: https://app.fletea.mx)

Compatibilidad

El MCP Server funciona con cualquier AI assistant que soporte el protocolo MCP:

• Claude Desktop (Anthropic)
• Claude Code (CLI)
• Cualquier herramienta que use el SDK de MCP

💡

Necesitas ayuda?

Escríbenos por WhatsApp o a hola@fletea.mx