I work on SAP Commerce, and most of my day ends up in the Hybris Administration Console running FlexibleSearch queries, ImpEx imports, and Groovy scripts. I built hac-mcp so Claude can drive HAC directly, with per-environment permissions I set once.
It is a Model Context Protocol server that logs into HAC with the credentials I already use, so nothing has to be installed on the platform. The AI only gets the operations I allow on the environment it is talking to.
What it exposes
- flexible_search: run FlexibleSearch queries and get structured results back
- impex_import: validate and execute ImpEx, with mandatory-field checks before the import runs
- groovy_execute: run Groovy against the platform, with a separate flag for commit mode
- type tools: search types, inspect attributes and relationships, resolve opaque PKs
- media + cronjobs: read and write text media, list CronJobs, run one synchronously
Permissions
Each environment has its own set of switches for what Claude is allowed to do on it. FlexibleSearch and property reads are on by default. ImpEx import, Groovy execution, and Groovy commit mode are off, so a new environment is read-only until I turn one on.
Every tool checks these switches in code before it sends anything to HAC. If production has Groovy commit mode turned off, the call is rejected, whatever the model was asked to do.
When a FlexSearch fails on an unknown field, the server returns the valid field names alongside the error. The model fixes the query and retries. Same for ImpEx: mandatory fields are checked up front, and post-import attribute errors come back with the valid field list attached.
Example prompts
- cross-env diff: Inspect the PromotionRule with code SUMMER25 in staging and recreate it in my local environment.
- fix my impex: My ImpEx is failing on staging, check the actual values in production and fill in the correct ones.
- triage: Find all orders stuck in WAIT status for more than 3 days in production and give me a summary.
- gated groovy: Write a Groovy script to do X and run it on local first. If it works I will approve it for staging.
Run npx hac-mcp, open http://localhost:18432 to add an environment, then point your MCP client at /mcp/sse.
MCP server for SAP Commerce Cloud's Hybris Administration Console. FlexibleSearch, ImpEx, Groovy, and CronJob tools with per-environment permissions. Issues and PRs welcome.