Boxzooka MCP Server

Обёртка над Boxzooka bxz-api (Product, Inbound, Order, Inventory, Shipment, Return) в виде MCP-сервера, по той же схеме, что и коннектор Materials Inventory: один общий сервер, одна общая пара учётных данных, вся команда подключается к одному и тому же URL.

33 инструмента, полное покрытие чтения и записи. EDI не покрыт — он основан на XML, и для него Boxzooka требует отдельного разговора с их IT-командой; спросите, если он действительно нужен, и я добавлю его.

Файлы

• boxzooka_mcp.py — сервер

• requirements.txt — зависимости Python

• Dockerfile — сборка контейнера для удалённого хостинга

Related MCP server: MoySklad MCP Server

1. Разверните его (отдельный сервис от Materials Inventory)

Это отдельное развёртывание от коннектора Materials Inventory — каждому серверу нужен свой сервис Railway/Render/Fly.

1. Загрузите эти три файла в новый репозиторий (или папку в существующем).

2. Railway → New Project → Deploy from GitHub repo → выберите его.

3. В Variables добавьте:

   • BOXZOOKA_API_TOKEN = ваш sandbox-токен (c44f966f5c7fc4cdb7d7f461ab4414c6)

   • BOXZOOKA_CUSTOMER_ID = 242

   • BOXZOOKA_API_BASE_URL = https://api.boxzooka.com для продакшена (данные живого склада). Если не указано, по умолчанию используется sandbox (https://sandbox.boxzooka.com), который содержит статические тестовые данные и НЕ будет отражать реальные отгрузки — укажите продакшен-URL для реальных цифр. Обратите внимание: для продакшена могут потребоваться другие токен/ID клиента, чем для sandbox; если после переключения вызовы возвращают 401, получите боевые учётные данные у Boxzooka.

4. Railway выдаёт вам публичный URL, например https://boxzooka-production-xxxx.up.railway.app.

5. URL коннектора для вашей команды — это этот URL плюс /mcp: https://boxzooka-production-xxxx.up.railway.app/mcp

2. Подключите команду

То же, что и Materials Inventory: каждый коллега добавляет его как пользовательский коннектор в своём приложении Claude, указывая на URL выше. Никакой настройки для каждого пользователя.

3. Замечания по безопасности и sandbox

• Эта пара токен/клиент в настоящее время указывает на sandbox-среду Boxzooka (согласно их документации: «для целей тестирования и отладки»). Данные, которые вы через неё видите, — это тестовые данные, а не ваш реальный склад: заказы и инвентарь здесь не будут отражать то, что реально происходит на физическом складе Boxzooka. Когда будете готовы к запуску, свяжитесь с Boxzooka для получения продакшен-учётных данных и задайте их через BOXZOOKA_API_TOKEN / BOXZOOKA_CUSTOMER_ID / BOXZOOKA_API_BASE_URL.

• То же примечание об уровне доступа, что и для Materials Inventory: этот коннектор может создавать заказы, отменять заказы, корректировать возвраты и т. д. — полный доступ на чтение и запись. Не делитесь URL за пределами команды.

4. Что покрыто

• Product: создание, получение по SKU, обновление, список всех, список (с пагинацией)

• Inbound: создание, получение по номеру PO, поиск по диапазону дат, получение по дате получения (в реальном времени), обновление, пагинированное получение по дате

• Order: создание, отмена, поиск (по order_id/order_key/external_id), обновление, загрузка заказов WMS по дате

• Inventory: список всех в наличии, получение по SKU, сегодняшние корректировки, корректировки по дате, размещение по дате, плюс пагинированные варианты каждого

• Shipment: получение по ключу заказа, получение по диапазону дат, пагинированное по дате

• Return: поиск, поиск по дате, создание, обновление, отмена

Не покрыто: EDI (на основе XML, требует отдельного разговора с IT-отделом Boxzooka).