Cin7 Core MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Cin7 Core-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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.

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Verbinde mit Claude