SAP S/4HANA Cloud mit Microsoft Copilot verbinden (MCP)

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → SAP S/4HANA Cloud klicken, Zugangsdaten einfügen, Copilot verbinden — fertig. Kein Docker, kein git clone, kein lokaler Server.

SAP S/4HANA Cloud + Microsoft Copilot

Frag Copilot nach deinen Daten in SAP S/4HANA Cloud Public Edition: Geschäftspartner, Kunden, Lieferanten, Kundenaufträge, Bestellungen, Fakturen, Auslieferungen, Produkte und Journalbuchungen. Der Connector hat 15 lesende Tools auf den OData-APIs von S/4HANA und meldet sich per OAuth 2.0 Client Credentials aus einem Kommunikationsarrangement an.

Was du Copilot fragen kannst

• "Zeig mir Geschäftspartner 1000123 und sag mir, ob er Kunde, Lieferant oder beides ist." Nutzt s4_get_business_partner, s4_list_customers und s4_list_suppliers.
• "Liste die Kundenaufträge für Auftraggeber 17100001." Nutzt s4_list_sales_orders mit einem OData-filter auf SoldToParty.
• "Was steht in Kundenauftrag 0000012345, Position für Position?" Nutzt s4_get_sales_order und s4_list_sales_order_items.
• "Welche Bestellungen haben wir bei Lieferant 17300001?" Nutzt s4_list_purchase_orders mit einem filter auf Supplier.
• "Liste die Fakturen mit Datum in diesem Monat." Nutzt s4_list_billing_documents mit einem Datums-filter.
• "Schlag Material TG11 im Produktstamm nach." Nutzt s4_get_product.

Was du brauchst

• Einen Tenant von S/4HANA Cloud Public Edition und einen Administrator, der Kommunikationsarrangements anlegen kann.
• Ein Kommunikationsarrangement für jeden API-Bereich, den Copilot lesen soll (Geschäftspartner, Kundenaufträge, Bestellungen, Fakturen usw.), mit einem Kommunikationsbenutzer und -system, die OAuth 2.0 mit dem Client-Credentials-Grant nutzen.
• Vier Werte für den Connector: S4_BASE_URL (die Basis-URL deines Tenants), S4_TOKEN_URL (die OAuth-Token-URL des Tenants), S4_CLIENT_ID und S4_CLIENT_SECRET.

Schritt 1 — Zugangsdaten holen

Einrichtung (einmalig, durch den S/4-Admin):

1. Öffne in deinem S/4HANA-Cloud-Tenant Communication Arrangements und lege eines für SAP_COM_0008 — Business Partner Integration an (weitere nach Bedarf: 0109 Sales Order, 0026 Purchase Order, 0186 Billing).
2. Lege einen Communication User und ein Communication System an. Wähle OAuth 2.0 als Authentifizierungsmethode, Grant-Typ Client Credentials.
3. S/4 erzeugt Client ID, Client Secret und eine Token URL pro Tenant, etwa https://my300000.authentication.eu10.hana.ondemand.com/oauth/token.
4. Die Base URL des Tenants ist https://my300000.s4hana.cloud.sap (deine Tenant-ID ersetzt 300000).
5. Setze die vier Variablen von oben.

Der Connector schickt Client-ID und Secret im HTTP-Basic-Header, wie Public Edition es verlangt, und erneuert das Token (meist eine Stunde gültig) selbst kurz vor Ablauf.

Schritt 2 — Adapter installieren

In der Cloud öffnest du Connectors → SAP S/4HANA Cloud und fügst die vier Werte ein. Zum Self-Hosting:

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 SAP S/4HANA Cloud-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

Dazu kommen fünf eingebaute OData-Tools: s4_cloud_list_services, s4_cloud_describe_service, s4_cloud_describe_entity, s4_cloud_query und s4_cloud_get_entity. Sie lesen das $metadata der acht APIs, für die der Connector eingerichtet ist, sodass der Agent jedes Feld dieser Services mit den SAP-Bezeichnungen erreicht. Ein Service außerhalb dieser Liste braucht zuerst sein Communication Arrangement. Du betreibst S/4HANA On-Premise oder in der Private Cloud? Dann nimm SAP S/4HANA (OData) oder SAP S/4HANA über HANA SQL.

Die Listen-Tools nehmen top, um die Zeilenzahl zu begrenzen; Geschäftspartner, Kundenaufträge, Bestellungen und Fakturen nehmen zusätzlich einen OData-filter.

Fehlerbehebung

• Kein einziges Tool funktioniert. Die Token-Anfrage scheitert. Prüf, ob S4_TOKEN_URL die Token-URL deines Tenants ist und ob Client-ID und Secret zu dem Kommunikationsarrangement gehören, das du angelegt hast.
• Manche Bereiche gehen, andere werden abgelehnt. Jede API braucht ihr eigenes Kommunikationsarrangement. Wenn Geschäftspartner kommen, Kundenaufträge aber nicht, fehlt für diesen Kommunikationsbenutzer das Arrangement der Kundenauftrags-API.
• Ein gefilterter Aufruf scheitert. Der filter ist OData-Syntax mit den Feldnamen der API, zum Beispiel SoldToParty eq '17100001', Texte in einfachen Anführungszeichen. Lass dir von Copilot den verwendeten Filter zeigen und korrigiere den Feldnamen.
• Antworten dauern lange oder brechen bei großen Listen ab. Frag nach weniger Zeilen; Copilot übergibt das als top.

FAQ

Kann Copilot in S/4HANA Kundenaufträge anlegen oder ändern? Nein. Alle 15 Tools lesen nur. In deinem Tenant wird nichts angelegt, geändert oder gebucht.

Funktioniert das mit S/4HANA On-Premise oder Private Cloud? Dieser Connector ist für S/4HANA Cloud Public Edition gebaut. Für S/4HANA On-Premise und Private Cloud gibt es zwei fertige Adapter: SAP S/4HANA (OData) über SAP Gateway und SAP S/4HANA (HANA SQL), der die HANA-Datenbank liest und SAPs Data Dictionary als Tools mitbringt. Beide laufen auf einem self-hosted AnythingMCP in deinem Netzwerk.

Speichert AnythingMCP meine Daten? Client-ID und Secret liegen verschlüsselt (AES-256-GCM) in deinem Workspace und werden Copilot nie gezeigt. Wenn Copilot ein Tool nutzt, ruft AnythingMCP S/4HANA auf und gibt das Ergebnis an Copilot weiter; der Aufruf landet im Audit-Log deines Workspaces. AnythingMCP Cloud wird in Frankfurt gehostet; wenn die Daten deine eigene Infrastruktur nicht verlassen dürfen, hostest du AnythingMCP selbst.

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