SAP S/4HANA (OData) über MCP mit Claude verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → SAP S/4HANA (OData) klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

SAP S/4HANA OData + Claude

Lass deine KI SAP S/4HANA On-Premise oder Private Cloud über seine OData-Services lesen: Services im Katalog des SAP Gateway finden, ihre Felder mit SAPs Bezeichnungen lesen und Journalbuchungszeilen, Fakturen, Kundenaufträge, Geschäftspartner, Bestände und Produkte abfragen. Nur lesend, mit einem technischen SAP-Benutzer.

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:

SAP_ODATA_BASE_URL, SAP_CLIENT, SAP_LANGUAGE, SAP_ODATA_USER, SAP_ODATA_PASSWORD

Schritt 1 — Zugangsdaten holen

1. Lege mit der Transaktion SU01 im Mandanten, den die KI lesen soll, einen technischen Benutzer vom Typ System (nicht Dialog) mit produktivem Passwort an.
2. Gib ihm eine Rolle (PFCG) mit S_SERVICE für die OData-Services, die die KI nutzen darf, und reinen Anzeigeberechtigungen (Aktivität 03). Damit die KI den Katalog durchsuchen kann, erlaube zusätzlich den V2-Katalogservice /IWFND/CATALOGSERVICE und den V4-Servicekatalog.
3. Prüfe, ob die Services aktiv sind: /IWFND/MAINT_SERVICE für V2, /IWFND/V4_ADMIN für V4. Die fertigen Tools nutzen SAPs freigegebene APIs API_JOURNALENTRYITEMBASIC_SRV, API_BILLING_DOCUMENT_SRV, API_SALES_ORDER_SRV, API_BUSINESS_PARTNER, API_MATERIAL_STOCK_SRV und API_PRODUCT_SRV.
4. Trage in SAP_ODATA_BASE_URL den Gateway-Host mit HTTPS-Port und ohne Pfad ein, z. B. https://s4.example.com:44300. In SAP_CLIENT kommt der dreistellige Mandant (z. B. 100), in SAP_LANGUAGE die Anmeldesprache (z. B. DE; in dieser Sprache kommen die Feldbezeichnungen zurück), in SAP_ODATA_USER und SAP_ODATA_PASSWORD Name und Passwort des technischen Benutzers.
5. Installiere den Connector. Es gibt keinen Schritt Authorize with Provider: Der Connector meldet sich per Basic Auth als technischer Benutzer an und schickt Mandant und Sprache bei jedem Aufruf mit.
6. Rufe zuerst s4_guide auf (kostet nichts und spricht SAP nicht an), dann s4_list_services mit einem Fachbegriff wie billing, um zu prüfen, ob der Benutzer den Katalog erreicht.

Netzwerk: Der HTTPS-Port des Gateways ist meist nur im Firmennetz erreichbar. Betreibe AnythingMCP self-hosted in diesem Netz oder binde es per VPN an, und trage den Gateway-Host in SSRF_ALLOWED_HOSTS ein, denn private Adressen lehnt AnythingMCP sonst ab. AnythingMCP Cloud funktioniert nur, wenn das Gateway aus dem Internet erreichbar ist.

So findet die KI die Daten: s4_list_services durchsucht SAPs Katalog (V2 und V4) nach einem Fachbegriff, s4_describe_service listet die Entity-Sets eines Services und markiert analytische und parametrisierte, s4_describe_entity liefert jedes Feld mit seiner SAP-Bezeichnung, dem Währungs- oder Einheitenfeld jedes Betrags und den Filtern, die ein Set verlangt, und s4_query und s4_get_entity lesen Zeilen. Feldnamen werden vor dem Aufruf gegen das $metadata des Services geprüft. Für die häufigsten Fälle rufen s4_journal_entry_items, s4_billing_documents, s4_sales_orders, s4_business_partners, s4_material_stock und s4_products die freigegebenen APIs direkt auf, mit filter, select, orderby, top und skip. Die Katalog-Tools funktionieren auch mit ECC oder BW über SAP Gateway; die fertigen Tools brauchen S/4HANA.

Berechtigungen und Nur lesen: Alle 12 Tools lesen nur. SAP prüft die Berechtigungen des technischen Benutzers bei jedem Aufruf, sie sind also die eigentliche Grenze: Gib der Rolle nur Anzeigeberechtigungen, und nur für die Buchungskreise, Verkaufsorganisationen und Werke, die die KI sehen darf. Zum weiteren Eingrenzen listest du in den OData-Einstellungen des Connectors unter Allowed services die Service-Pfade, die die KI aufrufen darf (* als Platzhalter); andere Services werden abgelehnt. Einzelne Tools kannst du auf der Connector-Seite deaktivieren.

SAPs API-Richtlinie: SAP erwartet, dass Integrationen von Drittanbietern veröffentlichte APIs (die API_*-Services im SAP Business Accelerator Hub) oder selbst gebaute Services nutzen. Nimm diese statt der internen Services hinter Fiori-Apps, und stelle Allowed services passend ein.

Basic Auth oder OAuth: Der Connector wird mit Basic Auth installiert. Ist dein Gateway für OAuth 2.0 eingerichtet, kannst du die Authentifizierung auf der Connector-Seite auf OAuth 2.0 umstellen.

Grenzen: Eine Abfrage liefert höchstens 1.000 Zeilen, die fertigen Tools standardmäßig 100 (top). Für Summen aggregiert die KI auf analytischen Services oder filtert nach Buchungskreis, Verkaufsorganisation oder Werk und nach Datum oder Geschäftsjahresperiode, statt alles durchzublättern. Beträge kommen mit ihrer Währung, Mengen mit ihrer Einheit; Dezimalzahlen kommen als Strings zurück, damit sie exakt bleiben.

Häufige Fehler: 401 heißt falscher Benutzer oder falsches Passwort, oder der Benutzer ist in diesem Mandanten gesperrt. 403 Forbidden auf einem Service heißt, dem technischen Benutzer fehlt die Berechtigung dafür (S_SERVICE oder die fachliche Rolle), 404 heißt, der Service ist in diesem System nicht aktiv. Wird eine private Adresse abgelehnt, fehlt der Host in SSRF_ALLOWED_HOSTS. Sehen die Zeilen nach Demodaten aus, zeigt SAP_CLIENT auf den falschen Mandanten.

Lieber HANA SQL: Soll die KI die Tabellen und CDS-Views von S/4HANA direkt per SQL lesen, über einen Datenbankbenutzer mit Leserechten statt über SAPs Anwendungsberechtigungen, nimm den Connector SAP S/4HANA (HANA SQL). Für jeden anderen OData-V2- oder V4-Service siehe den Connector-Typ OData.

Der Connector schreibt nicht in SAP: Er bucht nichts und legt keine Aufträge, Belege oder Stammdaten an und ändert sie nicht.

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 Claude 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.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. SAP S/4HANA OData, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Welche OData-Services in unserem SAP-Katalog haben mit Fakturen zu tun, und welche davon sind freigegebene APIs?“
• „Zeig mir den fakturierten Nettoumsatz des letzten Monats je Verkaufsorganisation aus den Fakturen, ohne stornierte Belege, mit Währung.“
• „Wie viel Bestand haben wir von Material FG-100 in Werk 1000, je Lagerort?“
• „Liste die 20 größten Journalbuchungszeilen, die letzten Monat in Buchungskreis 1000 gebucht wurden, mit Sachkonto, Betrag und Währung.“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden