Claude For Commerce Merchant Commercetools

Claude for Commerce — The merchant agent

**The commercetools implementation.**

The [commerce-agents](https://github.com/anthropics/commerce-agents) merchant agent, connected to a commercetools Composable Commerce project. Staff ask it about performance, inventory, pricing, and campaigns; every write it proposes is a staged change a person approves, and only then does it reach the project.

The merchant role only — the shopping agent is not part of this.

ct_merchant/    the backend, the commercetools client, and the mapping
api/            the portal API: the turn as SSE, the views' reads, approve and discard
portal/         the operator portal, a Next.js app
tests/          the suite, against a real project
docs/           integration.html — the illustrated tour
patches/        one fix to an upstream file, applied to the fetched checkout

Everything here is this project's own code. The agent itself — the prompt, the five skills, the tool contracts, the executor and its gates — is [commerce-agents](https://github.com/anthropics/commerce-agents), which `setup.sh` fetches and installs as a dependency; it is not copied into this repository.

**→ [`docs/integration.html`](docs/integration.html) is the illustrated tour** — three diagrams (the architecture and its credential boundary, how commercetools resources become the records the agent reads, and the propose → approve → apply sequence), plus every read's source and what the platform refuses. Open it in a browser.

What it is

The repository defines the merchant agent once — prompt, five skills, tool contracts, guardrails, the approval gate — and expects a deployment to supply one thing: a [`MerchantBackend`](https://github.com/anthropics/commerce-agents/blob/main/merchant-agent/core/merchant_agent/backend.py). This project is that implementation, over the commercetools HTTP API.

commercetools publishes SDKs for Java, TypeScript, PHP, and .NET but not for Python, and the repository is Python, so [`ct_m