Cin7 Core MCP-Server für Lager, Verkäufe und Einkäufe

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Cin7 Core, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

Cin7 Core

Cin7 Core (ehemals DEAR Inventory) über External API v2: Produkte und Lagerverfügbarkeit pro Standort, Verkäufe mit Bestellungen, Erfüllungen, Rechnungen und Zahlungen (nur lesen), Käufe, Kunden, Lieferanten, Lageranpassungen und Transfers. Erstelle Verkäufe, Käufe, Kunden, Lieferanten und Transfers. Konto-ID und Anwendungs-Schlüssel.

Einrichtung

Die Einrichtung dauert etwa 2 Minuten. Du benötigst ein Cin7 Core-Konto (ehemals DEAR Inventory; du meldest dich unter inventory.dearsystems.com an) mit Zugriff auf Integrationen → API. Der Connector benötigt die Konto-ID und einen Anwendungs-Schlüssel.

Core oder Omni? Cin7 verkauft zwei verschiedene Produkte. Cin7 Core (dieser Connector, ehemals DEAR Systems) verwendet eine Konto-ID und einen Anwendungs-Schlüssel. Cin7 Omni (das ursprüngliche Cin7, go.cin7.com) hat eine separate API v1 mit einem API-Benutzernamen und -Schlüssel: benutze den Cin7 Omni Connector dafür. Die Zugangsdaten des einen funktionieren nicht beim anderen.

1. Öffne in Cin7 Core die API-Einstellungsseite, Integrationen → API (inventory.dearsystems.com/ExternalAPI).
2. Klicke auf +, um eine API-Anwendung hinzuzufügen, und gib ihr einen Namen.
3. Kopiere die Konto-ID (eine GUID) in CIN7_CORE_ACCOUNT_ID und den Anwendungs-Schlüssel in CIN7_CORE_APPLICATION_KEY.
4. Installiere den Connector. Führe cin7_core_get_me aus, um die Verbindung zu überprüfen: es gibt den Firmennamen, die Basiswährung und die Zeitzone des Kontos zurück.

Cloud und self-hosted funktionieren gleich: die Zugangsdaten sind dieselben, und es gibt keine Umleitungs-URL, die festgelegt werden muss. Der Connector sendet sie in den api-auth-accountid und api-auth-applicationkey Headern. Das Löschen der API-Anwendung in Cin7 Core widerruft den Schlüssel.

Wo anfangen: cin7_core_get_me für die Basiswährung, cin7_core_list_locations für Standortnamen, dann cin7_core_list_sales und cin7_core_get_product_availability, die die meisten Fragen beantworten.

Was es liest: Produkte mit Preisstufen, Lagerverfügbarkeit pro Produkt und Standort (verfügbar, zugewiesen, verfügbar, bestellt); Verkäufe mit ihrem Angebot, Bestellung, Erfüllungen (kommissionieren, verpacken und versenden, mit Spediteur und Sendungsverfolgung), Rechnungen und Zahlungen; Käufe mit ihrer Bestellung; Kunden, Lieferanten, Steuerregeln und Zahlungsbedingungen; Lageranpassungen und Lagertransfers.

Einen Verkauf zu erstellen erfordert zwei Aufrufe: cin7_core_create_sale erstellt den Header (Kunde, Standort) und gibt seine ID zurück, dann fügt cin7_core_create_sale_order die Zeilen hinzu. Zeilen benötigen Name, Menge, Preis, Steuer und Steuerregel sowie SKU oder Produkt-ID. Die KI hält die Bestellung im STATUSENTWURF, es sei denn, du möchtest, dass sie autorisiert wird: AUTORISIERT weist Lager zu, bestellt einen Mangel ohne Warnung und sperrt die Bestellung gegen weitere API-Bearbeitungen. Käufe funktionieren auf die gleiche Weise, mit cin7_core_create_purchase und cin7_core_create_purchase_order.

Andere Schreibvorgänge: cin7_core_create_customer, cin7_core_update_customer und cin7_core_create_supplier (sie benötigen Zahlungsbedingungen und Namen sowie Kontencodes, die cin7_core_list_payment_terms und cin7_core_list_tax_rules auflisten), und cin7_core_create_stock_transfer (standardmäßig ENTWURF). Alle diese sind aktiviert.

Bei der Installation deaktiviert: cin7_core_create_stock_adjustment (erstelle eine Lageranpassung). Eine ABGESCHLOSSENE Anpassung verbucht Lagerbewegungen und Buchungseinträge auf einmal, und ihre Mengen sind die neuen Bestandswerte, nicht die Unterschiede. Schalte es auf der Connector-Seite ein, wenn die KI es verwenden soll; die KI bittet dich, jede Änderung zu bestätigen.

Kein Geld und keine Löschungen: der Connector zeichnet niemals Zahlungen, Rechnungen oder Gutschriften auf, ändert oder löscht sie, und er hat keine Lösch- oder Stornierungswerkzeuge.

Identifikatoren: Datensätze verwenden GUIDs (ID, SaleID, TaskID). Standorte, Steuerregeln, Zahlungsbedingungen und Preisstufen werden nach Namen referenziert.

Seitenumbruch: Listen benötigen page (beginnend bei 1) und limit (Standard 100, maximal 1.000); die Antwort enthält Total. updated_since oder modified_since geben nur das zurück, was sich geändert hat. Daten sind UTC, yyyy-MM-ddTHH:mm:ss.

Rate-Limit: 60 Aufrufe pro Minute pro API-Anwendung; darüber hinaus antwortet Cin7 Core mit 429 (ältere Konten 503). Große Seiten und Filter nutzen das Budget besser als viele kleine Aufrufe.

Häufige Fehler: Ein abgelehnter Aufruf antwortet mit 400 und [{"ErrorCode": 400, "Exception": "..."}], das das Problem benennt, wie einen unbekannten Kunden, Standort oder Steuerregel oder ein Dokument, das bereits autorisiert ist. 403 bedeutet eine falsche Konto-ID oder einen Anwendungs-Schlüssel.

Voraussetzungen: CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY

Installiere den Connector lokal

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

Öffne http://localhost:3000/connectors/store, wähle Cin7 Core und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Wie viele Einheiten von SKU MUG-WHT-350 sind an jedem Standort verfügbar?"
• "Liste die Verkäufe dieses Monats auf, die autorisiert, aber noch nicht vollständig erfüllt sind."
• "Zeige die Erfüllung der Bestellung SO-1042 mit ihrem Spediteur und der Sendungsverfolgungsnummer."
• "Welche Käufe warten noch auf den Erhalt von Lager?"
• "Erstelle einen Entwurf für einen Verkauf für den Kunden Coffee Corner im Hauptlager mit 24 Einheiten von MUG-WHT-350 zu 6,50."

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT