btp-sap-odata-to-mcp-server-optimized — Claude Code MCP server
This MCP server connects SAP OData with AI clients and Cloud Foundry. Use it for natural-language SAP queries, KPI analysis, and interactive UI tools.
claude mcp add --env SAP_IAS_URL=<SAP_IAS_URL> --env SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID> --env SAP_IAS_CLIENT_SECRET=<SAP_IAS_CLIENT_SECRET> --env SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME> --env ODATA_DISCOVERY_MODE=<ODATA_DISCOVERY_MODE> --transport stdio btp-sap-odata-to-mcp-server-optimized -- npx -y btp-sap-odata-to-mcp-serverWhat btp-sap-odata-to-mcp-server-optimized does
The server connects SAP OData services to MCP clients and turns plain-language requests into OData operations. Its tool layout includes request routing, 17+ layered tools, automatic call sequencing, KPI monitoring, and trend analysis. UI tools can generate SAP Fiori forms, sortable data grids, KPI dashboards, workflows, and drill-down reports.
Service discovery can use include and exclude patterns, business-domain presets, or an explicit whitelist. Authentication supports IAS, OAuth2, JWT, Basic Auth, and API keys, while XSUAA can enforce granular permissions. The server requires access to SAP BTP Cloud Foundry and the XSUAA, Identity, Connectivity, and Destination services.
Set the configuration through environment variables, install dependencies with npm install, then build with npm run build:btp and deploy using npm run deploy:btp. Node.js >= 18 is required. That prerequisite matters before wiring the server into an MCP client.
What it helps with
- discover SAP services with include and exclude patterns
- turn a plain-language request into an OData query
- assemble a KPI dashboard with trend analysis
- create a validated SAP Fiori form
- control service access through XSUAA
Example prompts for the agent
- Find SAP OData services matching
*API*andZ*. - Turn this question into an SAP OData request and return the result: which orders need attention?
- Create a sales KPI dashboard with drill-down by SAP service.
How to install btp-sap-odata-to-mcp-server-optimized
Platform CLI
claude mcp add --env SAP_IAS_URL=<SAP_IAS_URL> --env SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID> --env SAP_IAS_CLIENT_SECRET=<SAP_IAS_CLIENT_SECRET> --env SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME> --env ODATA_DISCOVERY_MODE=<ODATA_DISCOVERY_MODE> --transport stdio btp-sap-odata-to-mcp-server-optimized -- npx -y btp-sap-odata-to-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
codex mcp add btp-sap-odata-to-mcp-server-optimized --env SAP_IAS_URL=<SAP_IAS_URL> --env SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID> --env SAP_IAS_CLIENT_SECRET=<SAP_IAS_CLIENT_SECRET> --env SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME> --env ODATA_DISCOVERY_MODE=<ODATA_DISCOVERY_MODE> -- npx -y btp-sap-odata-to-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"mcpServers": {
"btp-sap-odata-to-mcp-server-optimized": {
"command": "npx",
"args": [
"-y",
"btp-sap-odata-to-mcp-server"
],
"env": {
"SAP_IAS_URL": "<SAP_IAS_URL>",
"SAP_IAS_CLIENT_ID": "<SAP_IAS_CLIENT_ID>",
"SAP_IAS_CLIENT_SECRET": "<SAP_IAS_CLIENT_SECRET>",
"SAP_DESTINATION_NAME": "<SAP_DESTINATION_NAME>",
"ODATA_DISCOVERY_MODE": "<ODATA_DISCOVERY_MODE>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"servers": {
"btp-sap-odata-to-mcp-server-optimized": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"btp-sap-odata-to-mcp-server"
],
"env": {
"SAP_IAS_URL": "<SAP_IAS_URL>",
"SAP_IAS_CLIENT_ID": "<SAP_IAS_CLIENT_ID>",
"SAP_IAS_CLIENT_SECRET": "<SAP_IAS_CLIENT_SECRET>",
"SAP_DESTINATION_NAME": "<SAP_DESTINATION_NAME>",
"ODATA_DISCOVERY_MODE": "<ODATA_DISCOVERY_MODE>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
gemini mcp add -e SAP_IAS_URL=<SAP_IAS_URL> -e SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID> -e SAP_IAS_CLIENT_SECRET=<SAP_IAS_CLIENT_SECRET> -e SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME> -e ODATA_DISCOVERY_MODE=<ODATA_DISCOVERY_MODE> btp-sap-odata-to-mcp-server-optimized npx -y btp-sap-odata-to-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about btp-sap-odata-to-mcp-server-optimized
How do I install btp-sap-odata-to-mcp-server-optimized in Claude Code?
Run `claude mcp add btp-sap-odata-to-mcp-server-optimized -e SAP_IAS_URL=<SAP_IAS_URL> -e SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID> -e SAP_IAS_CLIENT_SECRET=<SAP_IAS_CLIENT_SECRET> -e SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME> -- npx -y btp-sap-odata-to-mcp-server`. This registers the server with the SAP IAS and Destination settings.
What does btp-sap-odata-to-mcp-server-optimized do?
It connects an MCP client to SAP OData, handles natural-language requests, and exposes tools for SAP data, KPI analysis, forms, dashboards, workflows, and reports.
What does the server need before it can run?
You need access to SAP BTP Cloud Foundry, the XSUAA, Identity, Connectivity, and Destination services, plus Node.js >= 18.
