Boxzooka MCP Server

Kapselt die Boxzooka bxz-api (Product, Inbound, Order, Inventory, Shipment, Return) als MCP-Server, gleiches Muster wie der Materials Inventory Connector: ein gemeinsamer Server, ein gemeinsames Anmeldedatenpaar, das gesamte Team verbindet sich mit derselben URL.

33 Tools, vollständige Lese- und Schreibabdeckung. EDI ist nicht abgedeckt – es basiert auf XML und Boxzooka erfordert ein separates Setup-Gespräch mit deren IT-Team; fragen Sie, ob Sie es tatsächlich benötigen, und ich füge es hinzu.

Dateien

• boxzooka_mcp.py — der Server

• requirements.txt — Python-Abhängigkeiten

• Dockerfile — Container-Build für Remote-Hosting

Related MCP server: MoySklad MCP Server

1. Bereitstellen (separater Dienst vom Materials Inventory)

Dies ist eine separate Bereitstellung vom Materials Inventory Connector – jeder Server benötigt seinen eigenen Railway/Render/Fly-Dienst.

1. Schieben Sie diese drei Dateien in ein neues Repo (oder einen Ordner in einem bestehenden).

2. Railway → Neues Projekt → Von GitHub-Repo bereitstellen → auswählen.

3. Fügen Sie unter Variablen hinzu:

   • BOXZOOKA_API_TOKEN = Ihr Sandbox-Token (c44f966f5c7fc4cdb7d7f461ab4414c6)

   • BOXZOOKA_CUSTOMER_ID = 242

   • BOXZOOKA_API_BASE_URL = https://api.boxzooka.com für Produktion (Live-Lagerdaten). Wenn nicht angegeben, wird standardmäßig die Sandbox verwendet (https://sandbox.boxzooka.com), die statische Testdaten enthält und Live-Sendungen NICHT widerspiegelt — setzen Sie die Produktions-URL für echte Zahlen. Hinweis: Die Produktion erfordert möglicherweise ein anderes Token/eine andere Kunden-ID als die Sandbox; wenn Aufrufe nach dem Wechsel 401 zurückgeben, erhalten Sie Live-Anmeldedaten von Boxzooka.

4. Railway gibt Ihnen eine öffentliche URL, z.B. https://boxzooka-production-xxxx.up.railway.app.

5. Die Connector-URL, die Sie Ihrem Team geben, ist diese URL plus /mcp: https://boxzooka-production-xxxx.up.railway.app/mcp

2. Team verbinden

Gleich wie beim Materials Inventory: Jedes Teammitglied fügt es als benutzerdefinierten Connector in seiner eigenen Claude-App hinzu, die auf die obige URL zeigt. Keine Einrichtung pro Benutzer.

3. Sicherheits- und Sandbox-Hinweise

• Dieses Token-/Kundenpaar zeigt derzeit auf die Sandbox-Umgebung von Boxzooka (laut deren Dokumentation: „für Test- und Debugzwecke"). Die Daten, die Sie darüber sehen, sind Testdaten, nicht Ihr echtes Lager – Bestellungen und Inventar hier spiegeln nicht wider, was tatsächlich im physischen Lager von Boxzooka passiert. Sobald Sie bereit sind, live zu gehen, kontaktieren Sie Boxzooka für Produktionsanmeldedaten und setzen Sie diese über BOXZOOKA_API_TOKEN / BOXZOOKA_CUSTOMER_ID / BOXZOOKA_API_BASE_URL.

• Gleicher Zugriffsebenen-Hinweis wie beim Materials Inventory: Dieser Connector kann Bestellungen erstellen, Bestellungen stornieren, Retouren anpassen usw. – voller Lese-/Schreibzugriff. Teilen Sie die URL nicht außerhalb des Teams.

4. Was abgedeckt ist

• Product: erstellen, per SKU abrufen, aktualisieren, alle auflisten, auflisten (paginiert)

• Inbound: erstellen, per PO-Nummer abrufen, nach Datumsbereich suchen, nach Eingangsdatum abrufen (Echtzeit), aktualisieren, paginiertes Empfangen nach Datum

• Order: erstellen, stornieren, suchen (nach order_id/order_key/external_id), aktualisieren, WMS-Bestellungen nach Datum laden

• Inventory: alle vorrätigen auflisten, per SKU abrufen, heutige Anpassungen, Anpassungen nach Datum, Einlagerung nach Datum, plus paginierte Varianten von jedem

• Shipment: per Auftragsschlüssel abrufen, nach Datumsbereich abrufen, paginiert nach Datum

• Return: suchen, nach Datum suchen, erstellen, aktualisieren, stornieren

Nicht abgedeckt: EDI (XML-basiert, erfordert ein separates Gespräch mit der Boxzooka-IT).