Boxzooka MCP Server

Envuelve la API bxz-api de Boxzooka (Product, Inbound, Order, Inventory, Shipment, Return) como un servidor MCP, con el mismo patrón que el conector de Materials Inventory: un servidor compartido, un par de credenciales compartido, todo el equipo se conecta a la misma URL.

33 herramientas, cobertura completa de lectura y escritura. EDI no está cubierto: se basa en XML y Boxzooka requiere una conversación de configuración separada con su equipo de TI para ello; pregunta si realmente lo necesitas y lo añadiré.

Files

• boxzooka_mcp.py — el servidor

• requirements.txt — dependencias de Python

• Dockerfile — construcción de contenedor para alojamiento remoto

Related MCP server: MoySklad MCP Server

1. Despliegue (servicio separado de Materials Inventory)

Este es un despliegue separado del conector de Materials Inventory: cada servidor necesita su propio servicio Railway/Render/Fly.

1. Sube estos tres archivos a un nuevo repositorio (o carpeta en uno existente).

2. Railway → Nuevo proyecto → Desplegar desde repositorio de GitHub → selecciónalo.

3. En Variables, añade:

   • BOXZOOKA_API_TOKEN = tu token de sandbox (c44f966f5c7fc4cdb7d7f461ab4414c6)

   • BOXZOOKA_CUSTOMER_ID = 242

   • BOXZOOKA_API_BASE_URL = https://api.boxzooka.com para producción (datos de almacén en vivo). Si se omite, por defecto usa el sandbox (https://sandbox.boxzooka.com), que son datos de prueba estáticos y NO reflejarán envíos en vivo — establece la URL de producción para números reales. Nota: la producción puede requerir un token/ID de cliente diferente al sandbox; si las llamadas devuelven 401 después de cambiar, obtén credenciales en vivo de Boxzooka.

4. Railway te da una URL pública, por ejemplo: https://boxzooka-production-xxxx.up.railway.app.

5. La URL del conector para dar a tu equipo es esa URL más /mcp: https://boxzooka-production-xxxx.up.railway.app/mcp

2. Conectar al equipo

Igual que Materials Inventory: cada compañero lo añade como conector personalizado en su propia aplicación de Claude, apuntando a la URL anterior. Sin configuración por usuario.

3. Notas de seguridad y sandbox

• Este par de token/cliente actualmente apunta al entorno sandbox de Boxzooka (según su documentación: "para fines de prueba y depuración"). Los datos que ves a través de él son datos de prueba, no tu almacén real: las órdenes y el inventario aquí no reflejarán lo que realmente está sucediendo en el almacén físico de Boxzooka. Cuando estés listo para pasar a producción, contacta a Boxzooka para obtener credenciales de producción y configúralas mediante BOXZOOKA_API_TOKEN / BOXZOOKA_CUSTOMER_ID / BOXZOOKA_API_BASE_URL.

• Misma nota de nivel de acceso que Materials Inventory: este conector puede crear órdenes, cancelar órdenes, ajustar devoluciones, etc. — lectura/escritura completa. No compartas la URL fuera del equipo.

4. Qué está cubierto

• Product: crear, obtener por SKU, actualizar, listar todos, listar (paginado)

• Inbound: crear, obtener por número de PO, buscar por rango de fechas, obtener recibido por fecha (en tiempo real), actualizar, recepción por fecha paginada

• Order: crear, cancelar, buscar (por order_id/order_key/external_id), actualizar, cargar órdenes WMS por fecha

• Inventory: listar todo en stock, obtener por SKU, ajustes de hoy, ajustes por fecha, ubicación por fecha, más variantes paginadas de cada uno

• Shipment: obtener por clave de orden, obtener por rango de fechas, paginado por fecha

• Return: buscar, buscar por fecha, crear, actualizar, cancelar

No cubierto: EDI (basado en XML, necesita una conversación separada con el equipo de TI de Boxzooka).