What can you do with this server?

The Hybris MCP Server enables AI assistants to interact with SAP Commerce Cloud (Hybris) instances through comprehensive administrative and operational tools. **Product & Catalog Management**: Search products with pagination, retrieve detailed product information by code/SKU, browse the category tree, and access category details. **Order Management**: View orders for specific users (by ID or email) and retrieve detailed order information. **Database Operations**: Execute FlexibleSearch queries against the Hybris database with configurable result limits and export query results to ImpEx format. **Data Import/Export**: Import data using ImpEx format for bulk operations and export data to ImpEx format based on FlexibleSearch queries. **Scripting & Automation**: Run Groovy scripts via the scripting console, list all cron jobs with their status, and trigger specific cron jobs on-demand. **Catalog Synchronization**: Trigger synchronization between catalog versions (e.g., Staged to Online). **System Administration**: Clear Hybris caches (specific types or all), retrieve system information and health status, and perform health checks to verify instance accessibility. The server uses stdio transport for MCP communication, requires admin HAC (Hybris Administration Console) access for administrative tools, and supports both OCC API endpoints (products, orders) and HAC endpoints (FlexibleSearch, Groovy, ImpEx). It works with multiple AI tools including Claude Desktop, VS Code extensions, Cursor, Windsurf, Zed, JetBrains IDEs, Sourcegraph Cody, and Raycast.

Which integrations are available for this server?

Enables interaction with [SAP](/mcp/servers/integrations/sap) Commerce Cloud (Hybris) instances, providing tools for product and catalog management, order viewing, FlexibleSearch queries, Groovy script execution, ImpEx data import/export, cron job management, cache clearing, and catalog synchronization.

Hybris MCP Server

MCP (Model Context Protocol) server for SAP Commerce Cloud (Hybris) integration. This server allows AI assistants like Claude to interact with your Hybris instance.

Features

Product Management: Search products, get product details, browse categories
Order Management: View orders and order details
FlexibleSearch: Execute FlexibleSearch queries directly
Groovy Scripts: Run Groovy scripts via the scripting console
ImpEx: Import and export data using ImpEx format
Cron Jobs: List and trigger cron jobs
Cache Management: Clear Hybris caches
Catalog Sync: Trigger catalog synchronization
Health Checks: Monitor system health

Installation

git clone <repository-url> cd hybris-mcp npm install npm run build

Configuration

Configure via environment variables:

Variable	Required	Description	Default
`HYBRIS_BASE_URL`	Yes	Base URL of your Hybris instance	-
`HYBRIS_USERNAME`	Yes	Admin username (HAC access required)	-
`HYBRIS_PASSWORD`	Yes	Admin password	-
`HYBRIS_BASE_SITE_ID`	No	OCC base site ID	`electronics`
`HYBRIS_CATALOG_ID`	No	Product catalog ID	`electronicsProductCatalog`
`HYBRIS_CATALOG_VERSION`	No	Catalog version	`Online`
`HYBRIS_HAC_PATH`	No	HAC path prefix	`/hac`

Common Configurations

Standard Hybris (localhost):

HYBRIS_BASE_URL=https://localhost:9002 HYBRIS_USERNAME=admin HYBRIS_PASSWORD=nimda

SAP Commerce Cloud (CCv2):

HYBRIS_BASE_URL=https://backoffice.your-environment.model-t.cc.commerce.ondemand.com HYBRIS_USERNAME=admin HYBRIS_PASSWORD=your-password HYBRIS_HAC_PATH=/hac

Custom Site Configuration:

HYBRIS_BASE_URL=https://localhost:9002 HYBRIS_USERNAME=admin HYBRIS_PASSWORD=nimda HYBRIS_BASE_SITE_ID=yoursite HYBRIS_CATALOG_ID=yourProductCatalog HYBRIS_CATALOG_VERSION=Online

Usage with Claude Code

Add the MCP server using the CLI:

claude mcp add hybris \ -e HYBRIS_BASE_URL=https://localhost:9002 \ -e HYBRIS_USERNAME=admin \ -e HYBRIS_PASSWORD=nimda \ -- node /path/to/hybris-mcp/dist/index.js

Or manually add to your Claude Code MCP settings (~/.claude.json or project config):

{ "mcpServers": { "hybris": { "type": "stdio", "command": "node", "args": ["/path/to/hybris-mcp/dist/index.js"], "env": { "HYBRIS_BASE_URL": "https://localhost:9002", "HYBRIS_USERNAME": "admin", "HYBRIS_PASSWORD": "nimda" } } } }

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "hybris": { "command": "node", "args": ["/path/to/hybris-mcp/dist/index.js"], "env": { "HYBRIS_BASE_URL": "https://localhost:9002", "HYBRIS_USERNAME": "admin", "HYBRIS_PASSWORD": "nimda" } } } }

Usage with Cursor

Add to your Cursor MCP configuration (~/.cursor/mcp.json):

Usage with Windsurf

Add to your Windsurf MCP configuration (~/.codeium/windsurf/mcp_config.json):

Usage with VS Code (Copilot/Continue/Cline)

For VS Code extensions that support MCP, add to your workspace .vscode/mcp.json:

{ "servers": { "hybris": { "command": "node", "args": ["/path/to/hybris-mcp/dist/index.js"], "env": { "HYBRIS_BASE_URL": "https://localhost:9002", "HYBRIS_USERNAME": "admin", "HYBRIS_PASSWORD": "nimda" } } } }

Usage with Zed

Add to your Zed settings (~/.config/zed/settings.json):

{ "context_servers": { "hybris": { "command": { "path": "node", "args": ["/path/to/hybris-mcp/dist/index.js"], "env": { "HYBRIS_BASE_URL": "https://localhost:9002", "HYBRIS_USERNAME": "admin", "HYBRIS_PASSWORD": "nimda" } } } } }

Usage with JetBrains IDEs

For IntelliJ IDEA, WebStorm, PyCharm, and other JetBrains IDEs with AI Assistant, add to your MCP configuration:

macOS/Linux: ~/.config/JetBrains/mcp.json Windows: %APPDATA%\JetBrains\mcp.json

Usage with Sourcegraph Cody

Add to your Cody MCP configuration (~/.config/cody/mcp.json):

Usage with Raycast

Add to your Raycast AI extension MCP settings (~/.config/raycast/mcp.json):

Generic MCP Configuration

For any other MCP-compatible client, the server uses stdio transport. Run with:

node /path/to/hybris-mcp/dist/index.js

Required environment variables:

HYBRIS_BASE_URL
HYBRIS_USERNAME
HYBRIS_PASSWORD

Available Tools

Product & Catalog (OCC API)

Tool	Description
`search_products`	Search for products in the catalog
`get_product`	Get detailed product information by code
`get_categories`	List all categories in the catalog
`get_category`	Get category details by code

Orders (OCC API)

Tool	Description
`get_orders`	Get orders for a user
`get_order`	Get specific order details

Administration (HAC)

Tool	Description
`flexible_search`	Execute FlexibleSearch queries
`execute_groovy`	Run Groovy scripts
`import_impex`	Import ImpEx data
`export_impex`	Export data to ImpEx format
`get_cronjobs`	List cron jobs and their status
`trigger_cronjob`	Trigger a cron job to run
`clear_cache`	Clear Hybris caches
`get_system_info`	Get system information
`trigger_catalog_sync`	Sync catalog versions
`health_check`	Check system health

Example Prompts

Search Products

Search for "camera" products in Hybris

FlexibleSearch

Run a FlexibleSearch query: SELECT {pk}, {code}, {name[en]} FROM {Product} WHERE {code} LIKE '%camera%'

Execute Groovy

Execute this Groovy script to count products: import de.hybris.platform.core.Registry def ctx = Registry.getApplicationContext() def flexibleSearchService = ctx.getBean("flexibleSearchService") def query = "SELECT COUNT(*) FROM {Product}" def result = flexibleSearchService.search(query) println "Total products: ${result.result[0]}"

Import ImpEx

Import this ImpEx to create a product: INSERT_UPDATE Product; code[unique=true]; name[lang=en]; catalogVersion(catalog(id),version) ; testProduct001 ; Test Product ; electronicsProductCatalog:Online

Trigger Catalog Sync

Sync the electronics catalog from Staged to Online

Security Notes

Store credentials securely - never commit them to version control
Use environment variables or secure secret management
The server requires HAC admin access for administrative tools
Consider using read-only credentials if you only need OCC API access

Development

# Watch mode for development npm run dev # Build npm run build # Run directly HYBRIS_BASE_URL=https://localhost:9002 \ HYBRIS_USERNAME=admin \ HYBRIS_PASSWORD=nimda \ npm start

Troubleshooting

Connection Issues

Verify your Hybris instance is running and accessible
Check if HAC is enabled and accessible at the configured path
Ensure credentials have admin access to HAC

SSL Certificate Errors

For local development with self-signed certificates:

NODE_TLS_REJECT_UNAUTHORIZED=0 node dist/index.js

CSRF Token Errors

The server handles CSRF tokens automatically. If you see CSRF errors:

Check that HAC login is working manually
Verify the HAC path is correct
Try restarting the MCP server to get a fresh session

License

MIT

Hybris MCP Server

Hybris MCP Server

Features

Installation

Configuration

Common Configurations

Usage with Claude Code

Usage with Claude Desktop

Usage with Cursor

Usage with Windsurf

Usage with VS Code (Copilot/Continue/Cline)

Usage with Zed

Usage with JetBrains IDEs

Usage with Sourcegraph Cody

Usage with Raycast

Generic MCP Configuration

Available Tools

Product & Catalog (OCC API)

Orders (OCC API)

Administration (HAC)

Example Prompts

Search Products

FlexibleSearch

Execute Groovy

Import ImpEx

Trigger Catalog Sync

Security Notes

Development

Troubleshooting

Connection Issues

SSL Certificate Errors

CSRF Token Errors

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API