SAP Commerce MCP Server

What is SAP Commerce MCP Server?

This Model Context Protocol (MCP) server integrates with SAP Commerce Cloud’s OCC APIs to enable natural language interactions with product data through Claude.

How to use SAP Commerce MCP Server?

Install dependencies (npm install), build (npm run build), and start (npm start). Configure via environment variables for SAP Commerce URL, site, OAuth2 credentials, and logging. Use natural language queries in Claude to search products, manage carts, check orders, and more.

Key features of SAP Commerce MCP Server

• Product search with pagination
• Advanced filtering by category and price
• Stock availability checks per location
• Full cart creation, add, update, remove
• Order status and history lookup
• Real-time health and performance analytics

Use cases of SAP Commerce MCP Server

• Find products using conversational queries
• Check stock before adding to cart
• Manage shopping carts programmatically
• Monitor service health and performance trends
• Retrieve order history for customer support

FAQ from SAP Commerce MCP Server

How does authentication work?

The server supports OAuth2 client credentials flow. Set SAP_COMMERCE_CLIENT_ID and SAP_COMMERCE_CLIENT_SECRET in environment variables; tokens are automatically refreshed with a 5-minute buffer.

What caching is implemented?

Product data is cached with a 5-minute TTL. Cache hit rates are monitored, and automatic invalidation and eviction policies manage memory.

What runtime requirements are there?

Node.js and npm are needed. The server runs locally and connects to an SAP Commerce Cloud instance via OCC APIs. SSL validation can be disabled for development.

Where are logs stored?

Logs are written to a logs directory with daily rotation and kept for 30 days. Separate files track errors, combined logs, and health metrics.

What error handling is included?

The server handles invalid product codes, network issues, authentication errors, API rate limiting, invalid category/promotion IDs, price range validation, and cart operation failures.