SAP S/4HANA OData su MCP: leggi SAP da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → SAP S/4HANA (OData), inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

SAP S/4HANA OData

Lascia che la tua AI legga SAP S/4HANA on-premise o Private Cloud tramite i servizi OData: trovare servizi nel catalogo SAP, leggerne i campi con le etichette di SAP e interrogare registrazioni contabili, documenti di fatturazione, ordini di vendita, business partner, giacenze e prodotti. Sola lettura, con un utente tecnico SAP.

Setup

1. Con la transazione SU01, crea nel mandante che l'AI deve leggere un utente tecnico di tipo System (non Dialog) con una password produttiva.
2. Assegnagli un ruolo (PFCG) con S_SERVICE per i servizi OData che l'AI può usare e autorizzazioni di business di sola visualizzazione (attività 03). Per permettere all'AI di sfogliare il catalogo, abilita anche il servizio di catalogo V2 /IWFND/CATALOGSERVICE e il catalogo dei servizi V4.
3. Verifica che i servizi siano attivi: /IWFND/MAINT_SERVICE per V2, /IWFND/V4_ADMIN per V4. I tool pronti usano le API rilasciate di SAP API_JOURNALENTRYITEMBASIC_SRV, API_BILLING_DOCUMENT_SRV, API_SALES_ORDER_SRV, API_BUSINESS_PARTNER, API_MATERIAL_STOCK_SRV e API_PRODUCT_SRV.
4. Imposta SAP_ODATA_BASE_URL sull'host del Gateway con la sua porta HTTPS e senza percorso, ad esempio https://s4.example.com:44300. In SAP_CLIENT va il mandante a tre cifre (ad esempio 100), in SAP_LANGUAGE la lingua di accesso (ad esempio IT; le etichette dei campi tornano in questa lingua), in SAP_ODATA_USER e SAP_ODATA_PASSWORD nome e password dell'utente tecnico.
5. Installa il connettore. Non c'è nessun passaggio Authorize with Provider: il connettore accede con Basic auth come utente tecnico e invia mandante e lingua a ogni chiamata.
6. Chiama prima s4_guide (non costa nulla e non contatta SAP), poi s4_list_services con un termine di business come billing per verificare che l'utente raggiunga il catalogo.

Rete: la porta HTTPS del Gateway di solito è raggiungibile solo dalla rete aziendale. Installa AnythingMCP self-hosted in quella rete o collegalo via VPN, e aggiungi l'host del Gateway a SSRF_ALLOWED_HOSTS, perché altrimenti AnythingMCP rifiuta gli indirizzi privati. AnythingMCP Cloud funziona solo se il Gateway è raggiungibile da internet.

Come l'AI trova i dati: s4_list_services cerca un termine di business nel catalogo SAP (V2 e V4), s4_describe_service elenca gli entity set di un servizio e segnala quelli analitici e parametrizzati, s4_describe_entity restituisce ogni campo con la sua etichetta SAP, il campo valuta o unità di ogni importo e i filtri che un set richiede, e s4_query e s4_get_entity leggono le righe. I nomi dei campi vengono controllati sul $metadata del servizio prima della chiamata. Per i casi più comuni, s4_journal_entry_items, s4_billing_documents, s4_sales_orders, s4_business_partners, s4_material_stock e s4_products chiamano direttamente le API rilasciate, con filter, select, orderby, top e skip. I tool del catalogo funzionano anche su ECC o BW con SAP Gateway; i tool pronti richiedono S/4HANA.

Permessi e configurazione in sola lettura: tutti i 12 tool leggono soltanto. SAP controlla le autorizzazioni dell'utente tecnico a ogni chiamata, quindi sono loro il vero confine: dai al ruolo solo autorizzazioni di visualizzazione, e solo per le società, le organizzazioni commerciali e le divisioni che l'AI può vedere. Per restringere ancora, elenca in Allowed services, nelle impostazioni OData del connettore, i percorsi dei servizi che l'AI può chiamare (* vale come jolly); gli altri servizi vengono rifiutati. Puoi disattivare singoli tool dalla pagina del connettore.

Policy API di SAP: SAP si aspetta che le integrazioni di terze parti usino le API pubblicate (i servizi API_* sul SAP Business Accelerator Hub) o servizi che hai costruito tu. Preferiscili ai servizi interni dietro le app Fiori, e imposta Allowed services di conseguenza.

Basic auth o OAuth: il connettore si installa con Basic auth. Se il tuo Gateway è configurato per OAuth 2.0, puoi passare l'autenticazione del connettore a OAuth 2.0 dalla pagina del connettore.

Limiti: una query restituisce al massimo 1.000 righe, i tool pronti 100 per impostazione predefinita (top). Per i totali, l'AI aggrega sui servizi analitici oppure filtra per società, organizzazione commerciale o divisione e per data o periodo contabile, invece di scorrere tutto pagina per pagina. Gli importi arrivano con la loro valuta e le quantità con la loro unità; i decimali tornano come stringhe, così restano esatti.

Errori comuni: 401 significa utente o password sbagliati, oppure utente bloccato in quel mandante. 403 Forbidden su un servizio significa che all'utente tecnico manca l'autorizzazione (S_SERVICE o il ruolo di business), 404 che il servizio non è attivo in questo sistema. Se un indirizzo privato viene rifiutato, l'host manca in SSRF_ALLOWED_HOSTS. Se le righe sembrano dati demo, SAP_CLIENT punta al mandante sbagliato.

Meglio HANA SQL? Se l'AI deve leggere tabelle e CDS view di S/4HANA direttamente in SQL, con un utente di database in sola lettura invece delle autorizzazioni applicative di SAP, usa il connettore SAP S/4HANA (HANA SQL). Per qualsiasi altro servizio OData V2 o V4, vedi il tipo di connettore OData.

Il connettore non scrive in SAP: non registra nulla e non crea né modifica ordini, documenti o anagrafiche.

Prerequisiti: SAP_ODATA_BASE_URL, SAP_CLIENT, SAP_LANGUAGE, SAP_ODATA_USER, SAP_ODATA_PASSWORD

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli SAP S/4HANA (OData) e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali servizi OData del nostro catalogo SAP riguardano i documenti di fatturazione, e quali sono API rilasciate?"
• "Mostrami il fatturato netto del mese scorso per organizzazione commerciale dai documenti di fatturazione, senza i documenti stornati, con la valuta."
• "Quanta giacenza abbiamo del materiale FG-100 nella divisione 1000, per magazzino?"
• "Elenca le 20 righe di registrazione contabile più grandi registrate il mese scorso nella società 1000, con conto Co.Ge., importo e valuta."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT