Cin7 Core MCP mit Cursor verbinden

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

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

Voraussetzungen

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

CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY

Schritt 1 — Zugangsdaten abrufen

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: verwende den Cin7 Omni Connector dafür. Die Zugangsdaten eines Produkts funktionieren nicht für das andere.

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, Verfügbarkeit pro Produkt und Standort (auf Lager, zugewiesen, verfügbar, bestellt); Verkäufe mit ihrem Angebot, Bestellung, Erfüllungen (picken, packen und versenden, mit Anbieter und Sendungsverfolgung), Rechnungen und Zahlungen; Einkäufe mit ihrer Bestellung; Kunden, Lieferanten, Steuerregeln und Zahlungsbedingungen; Bestandsanpassungen und Bestandsübertragungen.

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 STATUS DRAFT, es sei denn, du möchtest sie autorisieren: AUTHORISED weist Bestände zu, bestellt einen Mangel ohne Vorwarnung und sperrt die Bestellung gegen weitere API-Änderungen. Einkä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 Steuerregelnamen sowie Kontocodes, die cin7_core_list_payment_terms und cin7_core_list_tax_rules auflisten), und cin7_core_create_stock_transfer (standardmäßig DRAFT). All diese sind aktiviert.

Bei der Installation deaktiviert: cin7_core_create_stock_adjustment (erstelle eine Bestandsanpassung). Eine ABGESCHLOSSENE Anpassung erfasst Bestandsbewegungen 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 fragt dich, jede Änderung zu bestätigen.

Kein Geld und keine Löschungen: der Connector erfasst, ändert oder löscht niemals Zahlungen, Rechnungen oder Gutschriften, und er hat keine Lösch- oder Ungültigmachungswerkzeuge.

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

Paging: Listen benötigen page (ab 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 z.B. ein unbekannter Kunde, Standort oder Steuerregel, oder ein Dokument, das bereits autorisiert ist. 403 bedeutet eine falsche Konto-ID oder einen Anwendungs-Schlüssel.

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 Core-Tools aufrufen.

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 Anbieter und der Sendungsverfolgungsnummer."
• "Welche Einkäufe warten noch auf den Erhalt von Beständen?"
• "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."

FAQ

Ich benutze Cin7 Omni (go.cin7.com). Ist das der richtige Connector? Nein. Cin7 Omni hat eine separate API v1 mit einem API-Benutzernamen und -Schlüssel: verwende den Cin7 Omni Connector. Die Zugangsdaten eines Produkts funktionieren nicht für das andere.

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