JTL Fulfillment Network MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → JTL Fulfillment Network klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen — fertig. Kein Docker, kein git clone, kein lokaler Server.

JTL Fulfillment Network + Microsoft Copilot

JTL Fulfillment Network (JTL-FFN) für Händler: Produkte, Bestand pro Lager, Ausgangsaufträge mit Versandstatus und Sendungsverfolgung, Anlieferungen, Retouren, Lager und Versandarten deiner Fulfiller. Ausgangsaufträge auf Wunsch anlegen oder stornieren. OAuth2.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

JTL_FFN_CLIENT_ID, JTL_FFN_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

1. Melde dich einmal unter fulfillment.jtl-software.com mit deinem JTL-Konto an, das die Merchant-Rolle braucht. Bis zu dieser ersten Anmeldung antwortet die API für deinen Benutzer mit 404.
2. Öffne kundencenter.jtl-software.de/oauth (die Seite steht nicht im Menü des Kundencenters) und lege einen OAuth-Client mit den Scopes ffn.merchant.read und ffn.merchant.write an. Redirect-URI: https://cloud.anythingmcp.com/api/mcp-oauth/callback bei AnythingMCP Cloud oder <your AnythingMCP URL>/api/mcp-oauth/callback bei Self-Hosting.
3. Füge Client-ID und Secret in JTL_FFN_CLIENT_ID und JTL_FFN_CLIENT_SECRET ein, installiere den Connector und klicke dann auf der Connector-Seite auf Authorize with Provider. Access-Tokens gelten 30 Minuten und werden automatisch erneuert.
4. Beginne mit jtl_ffn_get_current_user, dann jtl_ffn_list_warehouses und jtl_ffn_list_products. Für einen Auftrag zeigt jtl_ffn_get_outbound den Status und jtl_ffn_list_outbound_shipping_notifications die Pakete mit Sendungsverfolgung.

Eine jfsku ist die 11-stellige Produkt-ID von JTL (z. B. MERC01PRDCT), nicht deine eigene SKU (merchantSku); Outbound- und Inbound-Tools akzeptieren entweder die FFN-ID oder deine eigene Auftragsnummer. filter nimmt Ausdrücke im OData-Stil wie status eq 'Shipped' entgegen. jtl_ffn_create_outbound und jtl_ffn_cancel_outbound werden deaktiviert installiert: Aktiviere sie bewusst und prüfe vor jedem Aufruf die Details. Listen nehmen limit (Standard 50) und offset entgegen.

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 JTL Fulfillment Network-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

FAQ

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
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden