home / mcp / hybris mcp server

Hybris MCP Server

MCP server enabling AI assistants to interact with SAP Commerce Cloud (Hybris) for product, order, and data management.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You run a Hybris MCP Server to enable AI assistants to securely interact with your SAP Commerce Cloud (Hybris) instance. It exposes leadership features like product and order management, data imports/exports, script execution, and health checks so you can automate and query your Hybris data from chat or automation workflows.

How to use

Connect your MCP client to the Hybris MCP Server using the stdio-based workflow described below. Once connected, you can search products, view orders, run FlexibleSearch, execute Groovy scripts, import/export data with ImpEx, trigger cron jobs, manage caches, synchronize catalogs, and monitor health. You work with the server by starting it locally and supplying your Hybris instance credentials and base URL as environment variables. Use the available tools to perform concrete tasks such as product lookups, order retrieval, and administrative operations.

How to install

Prerequisites: you need Node.js installed on your machine. You also should have access to a Hybris (SAP Commerce Cloud) instance with HAC admin credentials.

Step 1: Install dependencies and build the MCP server.

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

Step 2: Start the server locally using your Hybris instance details. You must provide the Hybris base URL, username, and password via environment variables.

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

Configuration and security notes

Configure the server with environment variables to connect to your Hybris instance. Common values include the base site, catalog, and version if you need a specific storefront configuration.

Important security guidance: store credentials securely, use environment variables or secure secret management, and ensure HAC admin access is used only for administrative tasks.

Troubleshooting and tips

If you encounter connection or SSL issues, verify that Hybris is running and accessible, HAC is enabled at the correct path, and credentials have admin access.

For local development with self-signed certificates, you can bypass TLS verification temporarily during startup if needed.

If CSRF errors occur, ensure you can log in to HAC manually, confirm the HAC path, and restart the MCP server to obtain a fresh session.

Development

The MCP server is built with a standard Node.js runtime. During development, you can run in watch mode and rebuild as you change code. The typical flow is to install, build, then start the server with the required environmental context.

Available tools

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

get_orders

Get orders for a user

get_order

Get specific order details

flexible_search

Execute FlexibleSearch queries

execute_groovy

Run Groovy scripts

import_impex

Import data using ImpEx format

export_impex

Export data using 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