PP/DS MCP Server – Projektdokumentation

Ziel

KI-gestützte Planungsauskunft direkt in SAP: Eine Custom Fiori App im S/4HANA PCE System schickt Planungsfragen an SAP AI Core, der über den MCP-Server auf PP/DS-Daten zugreift und die Antwort direkt zurück in die Fiori App liefert.

---

Architektur (Zielzustand)

┌─────────────────────────────────┐
│       S/4HANA Private Cloud     │
│                                 │
│  ┌──────────────────────────┐   │
│  │  Custom Fiori App        │   │
│  │  (Input: Frage + Kontext)│   │
│  └────────────┬─────────────┘   │
│               │ OData/HTTP      │
│  ┌────────────▼─────────────┐   │
│  │  BTP Integration / ABAP  │   │
│  │  HTTP Outbound Call      │   │
│  └────────────┬─────────────┘   │
└───────────────┼─────────────────┘
                │ Cloud Connector / Private Link
                ▼
┌─────────────────────────────────┐
│          SAP BTP                │
│                                 │
│  ┌──────────────────────────┐   │
│  │  SAP AI Core             │   │
│  │  Orchestration Service   │   │
│  └────────────┬─────────────┘   │
│               │ MCP Tool Calls  │
│  ┌────────────▼─────────────┐   │
│  │  PP/DS MCP Server        │   │
│  │  (dieses Repo)           │   │
│  │  odata-mcp-proxy         │   │
│  └────────────┬─────────────┘   │
│               │ OData           │
└───────────────┼─────────────────┘
                │ Cloud Connector / Private Link
                ▼
┌─────────────────────────────────┐
│       S/4HANA Private Cloud     │
│                                 │
│  ┌──────────────────────────┐   │
│  │  PP/DS OData APIs        │   │
│  │  (Planned/Prod. Orders,  │   │
│  │   Work Centers, ...)     │   │
│  └──────────────────────────┘   │
└─────────────────────────────────┘
                │
                │ Antwort zurück durch denselben Pfad
                ▼
        Custom Fiori App Output

Datenpfad:

1. Fiori App sendet Frage + Kontextdaten (z.B. Planauftragsnummer, Werk) an AI Core
2. AI Core Orchestration versteht die Anfrage, wählt passende MCP-Tools
3. MCP-Server ruft die PP/DS OData APIs im S/4HANA PCE ab
4. Antwort läuft zurück: MCP → AI Core → Fiori App

---

Komponenten

1. Custom Fiori App (S/4HANA PCE)

• Eingebettet in SAP-Transaktion oder eigenständige App
• Sendet strukturierten Kontext an AI Core (z.B. aktuell geöffneter Planauftrag, Werk, Zeitraum)
• Zeigt die AI-Antwort direkt in der UI an
• Tech: SAP UI5 / Fiori Elements, ABAP OData oder CAP Backend

2. SAP AI Core (BTP)

• Orchestration Service als zentrales AI-Brain
• Nimmt die Anfrage der Fiori App entgegen
• Entscheidet welche MCP-Tools aufgerufen werden
• Gibt formatierte Antwort zurück

3. PP/DS MCP Server (dieses Repo, BTP CF)

• Powered by odata-mcp-proxy
• Exposes PP/DS OData APIs als MCP-Tools
• Kein eigener Code — nur api-config.json
• Läuft auf BTP Cloud Foundry, nutzt Destination Service + Cloud Connector

4. S/4HANA PCE OData APIs

• Planaufträge (API_PLANNED_ORDERS)
• Fertigungsaufträge (API_PRODUCTION_ORDERS_2_SRV)
• Arbeitsplätze (API_WORK_CENTER_SRV)
• Erweiterbar via Custom CDS Views

---

BTP Deployment (MCP Server)

Voraussetzungen

• SAP BTP Subaccount (Cloud Foundry aktiviert)
• Cloud Connector konfiguriert mit Virtual Host für S/4HANA PCE
• BTP Destination S4H_PCE angelegt (OnPremise, Basic oder OAuth2SAML)
• Services: Destination, Connectivity, XSUAA

BTP Destination S4H_PCE

Property	Wert
Name	S4H_PCE
Type	HTTP
URL	Virtual Host (Cloud Connector)
Authentication	BasicAuthentication oder OAuth2SAMLBearerAssertion
Proxy Type	OnPremise

Deployment

npm install -g mbt
mbt build
cf login -a https://api.cf.<region>.hana.ondemand.com
cf deploy mta_archives/ppds-mcp-server_1.0.0.mtar

---

API Konfiguration (api-config.json)

Drei API-Gruppen, read-only:

API	EntitySets	Use Case
API_PLANNED_ORDERS	PlannedOrder, PlannedOrderComponent, PlannedOrderCapacity	Planaufträge lesen, Komponenten, Kapazitätsbedarfe
API_PRODUCTION_ORDERS_2_SRV	ProductionOrder, ProductionOrderOperation	Fertigungsaufträge + Vorgänge
API_WORK_CENTER_SRV	WorkCenter	Arbeitsplätze / Ressourcen

→ Details in api-config.json

---

Beispiel-Interaktionen

Fiori App schickt an AI Core (mit Kontext Werk=1000, Material=FG-001):

„Welche Planaufträge für Material FG-001 laufen diese Woche?" → AI Core → PlannedOrder_list mit $filter auf Material + Datum → Antwort in Fiori

„Auf welchem Arbeitsplatz wird Planauftrag 1234567 gefertigt?" → AI Core → PlannedOrderCapacity_get → WorkCenter aus Ergebnis → Antwort

„Welche Komponenten fehlen für Planauftrag 1234567?" → AI Core → PlannedOrderComponent_list → Abgleich mit Verfügbarkeit → Antwort

---

Covered Use Cases (Phase 1 – Read-only)

Frage	API / EntitySet
Welche Planaufträge laufen diese Woche für Werk X?	PlannedOrder
Details zu Planauftrag XXXXXXX?	PlannedOrder GET
Welche Komponenten braucht Planauftrag X?	PlannedOrderComponent
Kapazitätsbedarf für Planauftrag X?	PlannedOrderCapacity
Status Fertigungsauftrag X?	ProductionOrder GET
Welche Vorgänge hat Fertigungsauftrag X?	ProductionOrderOperation
Alle offenen Aufträge für Material Y?	ProductionOrder ($filter)
Welche Arbeitsplätze gibt es in Werk Z?	WorkCenter

---

Roadmap

• [x] MCP Server Konfiguration (api-config.json)
• [x] BTP Deployment Setup (mta.yaml, xs-security.json)
• [ ] BTP Deployment ausführen + testen
• [ ] AI Core Orchestration: MCP-Tools registrieren
• [ ] Custom Fiori App: AI Core Integration (Input/Output)
• [ ] Phase 2: Write-Operationen (Planauftrag ändern)
• [ ] Custom CDS Views für Lücken (aggregierte Kapazitätsauslastung, Alerts)

---

Referenzen

• odata-mcp-proxy GitHub
• odata-mcp-proxy Blog
• AI Core MCP Server Blog
• SAP API Hub – Planned Orders
• SAP API Hub – Production Orders