Cin7 Omni MCP mit Cursor verbinden

💡 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 + Cursor

Cin7 Omni (go.cin7.com) Inventar- und Auftragsverwaltung über API v1: Verkaufsaufträge, Angebote, Bestellungen, Gutschriften, Kontakte, Produkte, Lagerbestand pro Filiale, Filialen, Zahlungen (nur lesen), Bestandsanpassungen, Filialtransfers und Benutzer. Erstelle Aufträge, Bestellungen, Kontakte und Transfers. API-Benutzername und Schlüssel.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector enthalten sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

Schritt 1 — Zugangsdaten erhalten

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: verwende 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, die festgelegt werden muss. Der Connector sendet den Benutzernamen und den Schlüssel als HTTP Basic-Authentifizierung.

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

Was es liest: Verkaufsaufträge, Angebote und Gutschriften mit ihren Positionen; Zahlungen, die gegen Aufträge erfasst wurden; Bestellungen; Produkte, deren Optionen (die verkaufbaren SKUs) mit Preisen und Kategorien; Lagerbestand pro Produktoption und Filiale (verfügbar, auf Lager, offene Verkäufe, eingehend); Bestandsanpassungen 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. Ein neuer Verkaufsauftrag wird genehmigt, es sei denn, die KI erstellt ihn als Entwurf; Bestellungen 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 Bestandsanpassung 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 bittet 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 Aufträge.

Filtern: where nimmt SQL-ähnliche Bedingungen auf Felder des Datensatzes, nicht seiner 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 Auftragslisten hilft, da sie groß sind.

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

Rate-Limits: 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 Auftragsstatus ist DRAFT, APPROVED oder VOID, und der Status ist eine Freitext-Workflow-Phase (Neu, Wartet auf Zahlung, Verarbeitung, Wartend, Versendet). Lagerbestand available ist der Lagerbestand minus offene Verkäufe. Kontakt type ist Kunde, Lieferant oder Intern. Schreibvorgänge nehmen Beträge in der Währung des Auftrags; Lesevorgänge geben Werte in der Basiswährung mit dem Wechselkurs zurück. Neue Benutzer können bis zu 2 Stunden benötigen, um in cin7_omni_list_users zu erscheinen.

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 Rate-Limit: warte auf die Retry-After-Zeit.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Cin7 Omni-Tools aufrufen.

Verfügbare Tools

Beispielaufforderungen

• "Welche Verkaufsaufträge wurden diese Woche genehmigt und sind noch nicht versendet?"
• "Wie viel Lagerbestand von SKU TSHIRT-BLK-M ist in jeder Filiale verfügbar?"
• "Welche Bestellungen sollen diesen 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."

FAQ

Ich benutze Cin7 Core (DEAR Inventory). Ist das der richtige Connector? Nein. Cin7 Core hat seine eigene API und Zugangsdaten: verwende den Cin7 Core Connector. Die Zugangsdaten eines Produkts funktionieren nicht beim anderen.

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja — MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Verbinde mit Claude