Endpoints & environments
Where the API, storefront, media, and MCP live in each environment.
GraphQL
| URL | |
|---|---|
Endpoint (POST) | <host>/graphql |
Playground (GET) | <host>/graphql |
In local development the backend runs on http://localhost:8080, so the
endpoint is http://localhost:8080/graphql. In production it's served under your
platform host (behind the CDN/proxy).
Storefront
A store renders at its subdomain (<slug>.<platform-host>) or a connected
custom domain. Locale-prefixed paths (e.g. /vi/...) serve the matching
translation overlay — see Multi-language.
Media
Uploaded images are served from <host>/storage/..., CDN-cached. Upload via the
media mutations or the MCP upload_image tool — see Media & uploads.
MCP
The shop MCP server runs either as a local stdio binary or a hosted
streamable HTTP endpoint at <mcp-host>/mcp (Bearer crmk_ per request).
See Connect.
Non-GraphQL HTTP
| Endpoint | Purpose |
|---|---|
POST /api/webhooks/stripe/:store_slug | Stripe webhook (per-store signature). |
GET /storage/* | Media. |
GET /internal/* | Internal host/domain resolution (shared-secret). |
GET /health | Liveness. |