sellercloud-mcp

Der erste Model Context Protocol-Server für SellerCloud. Verbinden Sie Claude in fünf Minuten mit Ihrem Katalog, Inventar, Ihren Bestellungen und Kanal-Listings – schreibgeschützt.

Warum gibt es das?

SellerCloud hat kein öffentliches SDK. Die REST-API ist zwar gut dokumentiert, aber nicht standardisiert – jedes Team, das Automatisierungen dafür entwickelt, schreibt am Ende dieselbe Authentifizierungs- und Paginierungs-Logik von Grund auf neu.

Wenn Sie Claude (oder einen anderen MCP-fähigen KI-Assistenten) für das tägliche E-Commerce-Geschäft nutzen, ist diese Lücke der Unterschied zwischen "Fasse die heutigen Bestellungen zusammen" (funktioniert sofort) und "Fasse die heutigen Bestellungen zusammen" (erfordert eine benutzerdefinierte Integration).

sellercloud-mcp schließt diese Lücke. Es ist ein kleiner, gut getesteter, unter der MIT-Lizenz stehender MCP-Server, der sieben schreibgeschützte SellerCloud-Endpunkte für jeden MCP-Client bereitstellt. Entwickelt aus jahrelanger Erfahrung mit E-Commerce-Automatisierung im großen Maßstab.

Related MCP server: Amazon Marketplace MCP Server by CData

Was Sie damit tun können

Verbinden Sie diesen Server mit Claude Code, Claude Desktop oder einem beliebigen MCP-Host und stellen Sie Fragen wie:

• "Suche nach allen SKUs, die WIDGET enthalten, und zeige mir die Lagerbestände."

• "Wie viele Bestellungen haben wir gestern über alle Marktplätze hinweg versandt? Gruppiert nach Kanal."

• "Rufe Bestellung 100001 ab und sage mir, welche Positionen versandt wurden."

• "Liste die für Firma 9001 konfigurierten Kanäle auf und zeige, welche aktiv sind."

• "Vergleiche für SKU ACME-001 den Preis über alle Kanal-Listings hinweg."

Claude liest Ihren Katalog direkt. Kein Kopieren und Einfügen, keine Tabellenkalkulationen, keine benutzerdefinierten Pipelines.

Tools (v0.1, alle schreibgeschützt)

Schreib-Endpunkte (Bestellung erstellen, Inventar aktualisieren, Kanaländerungen pushen) sind in v0.1 absichtlich nicht enthalten. Sie sind für v0.2 geplant, sobald sich die schreibgeschützte Ergonomie stabilisiert hat.

Installation

pip install sellercloud-mcp

v0.1 wird aus diesem Repository ausgeliefert. Die Veröffentlichung auf PyPI steht noch aus – installieren Sie es vorerst mit pip install git+https://github.com/alveyautomation/sellercloud-mcp oder klonen Sie es und führen Sie lokal pip install -e . aus.

Anmeldedaten konfigurieren

Der Server liest alles aus Umgebungsvariablen. Kopieren Sie .env.example nach .env und tragen Sie Ihren Tenant ein:

SELLERCLOUD_API_URL=https://your-team.api.sellercloud.com/rest/
SELLERCLOUD_USERNAME=your-username
SELLERCLOUD_PASSWORD=your-password
SELLERCLOUD_DEFAULT_COMPANY_ID=        # optional fallback
SELLERCLOUD_HTTP_TIMEOUT=60            # optional, seconds
SELLERCLOUD_MAX_RETRIES=3              # optional

Verwenden Sie ein schreibgeschütztes SellerCloud-Konto. v0.1 ruft nur GET-Endpunkte auf, aber Defense-in-Depth bedeutet, dass Sie dem Server einen dedizierten Benutzer geben sollten, der nichts ändern kann. Wenn v0.2 mit Schreib-Tools erscheint, können Sie durch ein Upgrade der Anmeldedaten zustimmen – niemals umgekehrt.

In Claude Code einbinden

Fügen Sie dies zu ~/.claude/claude_code_config.json (oder der MCP-Konfiguration Ihres Projekts) hinzu:

{
  "mcpServers": {
    "sellercloud": {
      "command": "sellercloud-mcp",
      "env": {
        "SELLERCLOUD_API_URL": "https://your-team.api.sellercloud.com/rest/",
        "SELLERCLOUD_USERNAME": "your-username",
        "SELLERCLOUD_PASSWORD": "your-password",
        "SELLERCLOUD_DEFAULT_COMPANY_ID": "9001"
      }
    }
  }
}

Starten Sie Claude Code neu. Die sieben sellercloud_*-Tools erscheinen in jeder neuen Sitzung.

In Claude Desktop einbinden

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) und fügen Sie denselben mcpServers-Block wie oben hinzu. Starten Sie die Desktop-App neu.

Tool-Referenz

Jedes Tool gibt einen JSON-Umschlag zurück:

{ "ok": true,  "data": { ... } }
{ "ok": false, "error": "human-readable message" }

sellercloud_search_products

sellercloud_search_products(
    query: str,                          # required
    company_id: int | None = None,       # falls back to default if unset
    page: int = 1,
    page_size: int = 50,                 # capped at 50 by SellerCloud
)

Beispielantwort:

{
  "ok": true,
  "data": {
    "items": [
      { "ID": "ACME-WIDGET-001", "ProductName": "Acme Widget, Standard", "Price": 29.99 }
    ],
    "total": 1,
    "page": 1,
    "page_size": 50
  }
}

sellercloud_get_product

sellercloud_get_product(sku: str, company_id: int | None = None)

Gibt den Katalogdatensatz zurück oder data: null, wenn die SKU nicht im Katalog der Firma enthalten ist.

sellercloud_search_orders

sellercloud_search_orders(
    date_from: str,                      # ISO date "YYYY-MM-DD"
    date_to: str,                        # ISO date "YYYY-MM-DD"
    company_id: int | None = None,
    query: str | None = None,
    limit: int = 200,                    # max 1000
)

Die Paginierung wird transparent gehandhabt – SellerCloud begrenzt die Seitengröße auf 50, aber das Tool sammelt Seiten bis zum limit. Die Antwort enthält limit_reached: true, wenn mehr Bestellungen vorhanden waren, als das limit zuließ.

sellercloud_get_order

sellercloud_get_order(order_id: int)

Gibt den vollständigen Bestelldatensatz zurück (mit Items[]) oder data: null bei einem 404-Fehler.

sellercloud_get_inventory

sellercloud_get_inventory(sku: str, company_id: int | None = None)

Der zurückgegebene Datensatz enthält:

• InventoryAvailableQty – was die API aktuell als verkaufbar betrachtet

• PhysicalQty – physisch auf Lager

• ReservedQty – reserviert für offene Bestellungen

• OnOrder – eingehende Bestellmenge (PO)

Verwenden Sie InventoryAvailableQty als kanonische Zahl für "Menge, die ich verkaufen kann".

sellercloud_list_channels

sellercloud_list_channels(company_id: int | None = None)

Gibt die Liste der konfigurierten Kanal-Feeds für die Firma zurück. Jeder Datensatz enthält ChannelID, Name und Active.

sellercloud_get_channel_listing

sellercloud_get_channel_listing(channel_id: int, sku: str)

Detail-Listing pro Kanal. Nützlich für Stichproben von Preisen über Marktplätze hinweg.

Lokale Entwicklung

git clone https://github.com/alveyautomation/sellercloud-mcp
cd sellercloud-mcp
python -m venv .venv && source .venv/bin/activate    # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
pytest                                                # 44 tests, ~4s

Pre-Commit-Hooks (gitleaks, ruff, formatter, Tenant-Fingerprint-Scrubber):

pip install pre-commit
pre-commit install

Integrationstests gegen ein echtes SellerCloud-Sandbox-Konto sind hinter SELLERCLOUD_INTEGRATION_TESTS=1 geschützt. Sie sind für normale Beiträge nicht erforderlich.

Fehlerbehebung

Failed to obtain SellerCloud token – Benutzername/Passwort abgelehnt. Häufigste Ursache: Das Konto hat 2FA aktiviert oder ist gesperrt. Der POST /api/token-Endpunkt von SellerCloud erwartet ein Dienstkonto ohne 2FA.

Missing required environment variables – der Server versuchte zu starten, bevor seine .env geladen wurde. Exportieren Sie die Variablen entweder in der übergeordneten Shell oder stellen Sie sicher, dass Ihre MCP-Host-Konfiguration sie im env-Block enthält.

Leere Ergebnisse trotz bekannter Daten – bestätigen Sie, dass die company_id korrekt ist. SellerCloud gibt nur die Standardfirma des authentifizierten Benutzers zurück, es sei denn, Sie übergeben companyID explizit.

Paginierung fühlt sich langsam an – die Seitengröße ist von SellerCloud auf 50 begrenzt, nicht von uns. Bei großen Datumsbereichen sind mehrere Roundtrips zu erwarten.

Mitwirken

Issues und Pull Requests sind willkommen. Bitte:

• Führen Sie pytest aus, bevor Sie einen PR öffnen (pip install -e ".[dev]").

• Führen Sie pre-commit run --all-files aus.

• Halten Sie Ergänzungen im v0.1-Umfang schreibgeschützt. Schreib-Endpunkte kommen in v0.2.

• Nur synthetische Daten in Tests – keine echten SKUs, Kundennamen oder Bestellnummern.

Lizenz

MIT – siehe LICENSE.

Haftungsausschluss

sellercloud-mcp ist eine inoffizielle Integration eines Drittanbieters. Sie wird nicht von SellerCloud, Inc. unterstützt, ist nicht mit ihr verbunden oder wird von ihr gefördert. "SellerCloud" ist eine Marke von SellerCloud, Inc. Verwendung auf eigene Gefahr; überprüfen Sie das Verhalten gegenüber Ihrem Tenant, bevor Sie sich für Produktionsentscheidungen darauf verlassen.