Cómo conectar BEX Express a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → BEX Express, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

BEX Express + Cursor

La mensajería BEX Express (Serbia) desde un agente de IA: historial de estados de un envío por su número, etiquetas de dirección en PDF, el directorio de direcciones de BEX con municipios, localidades y calles, y los puntos de recogida y depósitos. Crear y cancelar envíos está incluido, desactivado al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

BEX_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos cuando BEX ya te ha enviado la clave. Necesitas un contrato con BEX Express, la mensajería serbia, y una clave de API que BEX emite para ese contrato.

1. Si aún no eres cliente de BEX, pide una oferta en [email protected]: la API es solo para clientes con contrato.
2. Escribe a [email protected], solicita acceso a la API e indica el contrato al que corresponde.
3. BEX te responde con una API key y tu KlijentId. Pega la clave en BEX_API_TOKEN; se envía en la cabecera X-AUTH-TOKEN. Guarda el KlijentId a mano: identifica a tu empresa como remitente de un envío.
4. Instala el conector y ejecuta bex_express_list_municipalities. Si devuelve la lista de municipios, la clave funciona.

Qué lee: el historial de estados de un envío por su número de BEX (el que aparece en la etiqueta), con cada escaneo, estado, fecha, lugar y el siguiente evento previsto; las etiquetas de dirección de un envío en PDF; el directorio de direcciones de BEX con municipios (opštine), localidades (mesta) con código postal y calles; y unos 120 puntos de recogida y depósitos con código, dirección, horario y coordenadas.

Códigos de estado: 1 registrado, 11 recogido en el remitente, 21 entregado, 25 a devolver al remitente, 30 devuelto al remitente, -21 comprobación de dirección por el call center, -51 en aduana. La IA te explica qué significa cada uno con palabras sencillas.

Etiquetas: una etiqueta A6 por página o cuatro etiquetas en una hoja A4, para todos los bultos de un envío o solo para uno. El PDF es pesado, así que la IA solo lo descarga cuando quieres imprimir o guardar una etiqueta.

Las direcciones usan ids de BEX: BEX describe una dirección por municipio, localidad y calle. La IA los busca paso a paso, un municipio o una localidad cada vez. El conector nunca le pide a BEX todas las calles de Serbia de golpe (casi 100.000).

Dos hosts y el puerto 62503: el seguimiento, las etiquetas y el directorio de direcciones van por el puerto HTTPS normal, mientras que la lista de puntos de recogida y la creación y cancelación de envíos van por https://api.bex.rs:62503. Ese puerto es accesible desde AnythingMCP Cloud; en un servidor propio detrás de un firewall que solo deja pasar el puerto 443, esas tres herramientas fallan.

Desactivadas al instalar: bex_express_create_shipments y bex_express_cancel_shipment. Anuncian envíos reales para que los recoja un mensajero o los cancelan, por eso un administrador las activa de forma deliberada. Aun así, la IA te muestra primero el envío completo (remitente, destinatario, bultos, contra reembolso, seguro, quién paga) o el número de envío a cancelar, y espera tu sí. Un envío que el mensajero ya ha recogido no se puede cancelar.

Errores habituales: 401 significa que la clave es incorrecta o falta. 403 significa que la clave funciona pero ese método no está habilitado para tu contrato: pregunta en [email protected]. Muchos métodos de BEX responden HTTP 200 pero con state false y un motivo en err, así que la IA revisa esos campos antes de darte un resultado. La excepción es la lista de puntos de recogida: ahí BEX envía state false con el texto ok aunque la lista esté completa.

El conector no gestiona facturas ni liquidaciones de contra reembolso, y no crea ni cancela envíos mientras un administrador no active esas herramientas.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de BEX Express.

Herramientas disponibles

Ejemplos de prompts

• "¿Dónde está ahora el envío 206897445 y cuándo se espera el siguiente paso?"
• "¿Cuáles de estos envíos volvieron al remitente: 206897445, 206897446 y 206897447?"
• "¿Qué puntos de recogida de BEX hay en Novi Sad y abren los sábados?"
• "Descárgame las etiquetas del envío 206897445, cuatro por hoja A4, para imprimirlas."
• "¿BEX tiene registrada la calle Bulevar oslobođenja de Novi Sad? Dame el id de la localidad y de la calle para una dirección de envío."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT