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

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 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 Omni-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

• "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.

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