Cin7 Omni MCP-Server für Lager und Aufträge

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

Cin7 Omni

Cin7 Omni (go.cin7.com) Inventar- und Bestellmanagement über API v1: Verkaufsbestellungen, Angebote, Einkaufsbestellungen, Gutschriften, Kontakte, Produkte, Lagerbestand pro Filiale, Filialen, Zahlungen (nur lesen), Lageranpassungen, Filialtransfers und Benutzer. Erstelle Bestellungen, Einkaufsbestellungen, Kontakte und Transfers. API-Benutzername und Schlüssel.

Einrichtung

Die Einrichtung dauert etwa 3 Minuten. Du benötigst ein Cin7 Omni-Konto (du meldest dich unter go.cin7.com an) und einen Administrator, der eine API v1-Verbindung hinzufügen kann. Der Connector benötigt den API-Benutzernamen und einen API-Schlüssel.

Omni oder Core? Cin7 verkauft zwei verschiedene Produkte. Cin7 Omni (dieser Connector) meldet sich unter go.cin7.com an und hat API v1 mit einem API-Benutzernamen und Schlüssel. Cin7 Core (ehemals DEAR Inventory) meldet sich unter inventory.dearsystems.com an und hat eine eigene API mit einer Kontonummer und einem Anwendungs-Schlüssel: benutze den Cin7 Core Connector dafür. Die beiden APIs und ihre Zugangsdaten sind nicht austauschbar.

1. Öffne im Cin7 Omni das Benutzermenü, dann Einstellungen → Integrationen & API → API v1.
2. Kopiere den API-Benutzernamen, der oben auf der Seite angezeigt wird, in CIN7_OMNI_API_USERNAME.
3. Klicke auf Neue API-Verbindung hinzufügen, gib ihr einen Namen und kopiere ihren API-Schlüssel in CIN7_OMNI_API_KEY. Schlüssel regenerieren ersetzt einen verlorenen Schlüssel.
4. Unter Berechtigungen aktiviere Lesen für jede Ressource, die die KI sehen soll, und Erstellen oder Aktualisieren für die Ressourcen, die die Schreib-Tools benötigen, und klicke dann auf Speichern. Eine Ressource ohne Berechtigung antwortet mit 403.
5. Installiere den Connector. Führe cin7_omni_list_branches aus, um die Verbindung zu überprüfen: es listet deine Filialen mit ihren IDs auf.

Cloud und self-hosted funktionieren gleich: die Zugangsdaten sind dieselben, und es gibt keine Umleitungs-URL zu setzen. Der Connector sendet den Benutzernamen und Schlüssel als HTTP Basic-Authentifizierung.

Wo du anfangen kannst: cin7_omni_list_branches für Filial-IDs, cin7_omni_list_sales_orders für aktuelle Bestellungen, cin7_omni_list_stock für Lagerbestand pro Filiale und cin7_omni_list_contacts, um einen Kunden oder Lieferanten zu finden.

Was es liest: Verkaufsbestellungen, Angebote und Gutschriften mit ihren Positionen; Zahlungen, die gegen Bestellungen erfasst wurden; Einkaufsbestellungen; Produkte, ihre Optionen (die verkaufbaren SKUs) mit Preisen und Kategorien; Lagerbestand pro Produktoption und Filiale (verfügbar, im Bestand, offene Verkäufe, eingehend); Lageranpassungen und Filialtransfers; Kontakte und Benutzer.

Was es schreibt: cin7_omni_create_sales_order, cin7_omni_update_sales_order (nur Kopfzeilenfelder, wie z.B. Status, Sendungsverfolgungscode und Lieferanweisungen), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact und cin7_omni_create_branch_transfer sind aktiviert. Eine neue Verkaufsbestellung wird genehmigt, es sei denn, die KI erstellt sie als Entwurf; Einkaufsbestellungen und Transfers werden als Entwürfe gespeichert, es sei denn, sie werden genehmigt. Versand und Empfang von Transfers erfolgen in Cin7.

Bei der Installation deaktiviert: cin7_omni_create_adjustment (erstellt eine Lageranpassung in einer Filiale). Eine genehmigte Anpassung ändert den Lagerbestand und den Lagerwert gleichzeitig. Aktiviere es auf der Connector-Seite, wenn die KI es verwenden soll; die KI fragt dich, jede Änderung zu bestätigen.

Überprüfe die Antwort jeder Schreiboperation: Cin7 antwortet mit HTTP 200 und einer Liste von {index, success, id, code, errors}, auch wenn es den Datensatz abgelehnt hat. Die KI überprüft success und errors, bevor sie einen Schreibvorgang als abgeschlossen meldet.

Zahlungen sind nur lesbar: der Connector erfasst, ändert oder löscht niemals eine Zahlung, und er versendet, fakturiert oder storniert keine Bestellungen.

Filterung: where nimmt SQL-ähnliche Bedingungen für Felder des Datensatzes, nicht für dessen Positionen. Strings und Daten kommen in einfache Anführungszeichen, Zahlen bleiben unformatiert: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Daten sind UTC, yyyy-MM-ddTHH:mm:ssZ. fields kürzt die Antwort (id,reference,total,lineItems(code,qty)), was bei Bestelllisten hilft, da sie groß sind.

Seitenumbruch: page beginnt bei 1 und rows beträgt maximal 250 (Standard 50, 25 bei Bestelllisten). Die KI fragt nach der nächsten Seite, bis eine leer zurückkommt.

Ratenlimits: Cin7 Omni erlaubt 3 Aufrufe pro Sekunde, 60 pro Minute und 5.000 pro Tag pro Konto; darüber hinaus antwortet es mit 429 und Retry-After. Große rows mit engen where-Filtern nutzen das Budget besser als viele kleine Aufrufe.

Werte: der Bestell-status ist DRAFT, APPROVED oder VOID, und stage ist eine Freitext-Workflow-Phase (Neu, Wartet auf Zahlung, Verarbeitung, In Bearbeitung, Versendet). Lager-available ist der Lagerbestand minus offene Verkäufe. Kontakt-type ist Kunde, Lieferant oder Intern. Schreibvorgänge nehmen Beträge in der Bestellwährung; Lesevorgänge geben Basiswährungswerte mit dem Wechselkurs zurück. Neue Benutzer können bis zu 2 Stunden benötigen, um in cin7_omni_list_users angezeigt zu werden.

Häufige Fehler: 403 bedeutet, dass die API-Verbindung keine Berechtigung für diese Ressource hat: aktiviere sie unter Berechtigungen und speichere. 429 ist das Ratenlimit: warte auf die Retry-After-Zeit.

Voraussetzungen: CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_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 Omni und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Welche Verkaufsbestellungen wurden diese Woche genehmigt und sind noch nicht versendet?"
• "Wie viel Lagerbestand von SKU TSHIRT-BLK-M ist in jeder Filiale verfügbar?"
• "Welche Einkaufsbestellungen sollen in diesem Monat ankommen, und von welchen Lieferanten?"
• "Finde den Kunden mit der E-Mail [email protected] und zeige seinen offenen Saldo."
• "Erstelle einen Entwurf für den Transfer von 20 Einheiten von TSHIRT-BLK-M vom Hauptlager zum Stadtgeschäft."

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT