Collegare SAP S/4HANA OData MCP a Microsoft Copilot

💡 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 + Microsoft Copilot

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SAP_ODATA_BASE_URL, SAP_CLIENT, SAP_LANGUAGE, SAP_ODATA_USER, SAP_ODATA_PASSWORD

Step 1 — Ottieni le credenziali

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.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di SAP S/4HANA OData.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse