Connect a module

Mirakl Connect

ShopMCP connects to the Mirakl Connect seller API with OAuth2 client credentials. v1 is admin-gated and read-only while we validate real seller credentials, rate limits, and marketplace workflows.

1. Copy Mirakl Connect credentials

In Mirakl Connect, copy the OAuth2 client ID and client secret for the seller account you want to connect. Mirakl documents this as a client-credentials flow where ShopMCP exchanges those values for a bearer token. Use Mirakl Connect credentials for sellers and brands, not Mirakl Catalog Platform credentials.

Mirakl MCP is not ShopMCP MCP

Mirakl uses MCP to mean Mirakl Catalog Platform. This ShopMCP integration targets Mirakl Connect for seller marketplace operations.

If the seller account does not expose OAuth credentials, ask the Mirakl Partner team contact for the client ID and client secret for the Mirakl Connect API.

2. Paste credentials into ShopMCP

Open Settings - Integrations, choose Mirakl Connect, then paste the client ID and client secret. ShopMCP requests tokens from https://auth.mirakl.net/oauth/token, calls https://miraklconnect.com/api with a bearer token, and stores the credentials encrypted at rest.

Connection status

Mirakl Connect is currently available only to ShopMCP admins. Writes are off. After the first real seller credential validation, the same connection path can be opened more broadly without changing what customers need to paste.

What you can ask

List Mirakl Connect products and check catalog state across Mirakl-powered marketplaces.
Review orders, async action status, returns, and order document metadata.
Inspect customer conversations and message threads when that endpoint is available for the connected seller credentials.
Build a marketplace operations overview across products, orders, returns, and support conversations.

Writes

Writes are intentionally off in v1. Product changes, order accept/cancel/refund operations, shipment creation, document upload, return updates, and conversation replies will stay behind the ShopMCP writes gate after sandbox and seller-account validation.

Troubleshooting

Token rejected — re-copy the client ID and secret from Mirakl Connect and confirm the credentials belong to the seller API.
Wrong Mirakl product — Mirakl Platform/MMP and Mirakl Catalog Platform credentials are not the target for this connection. Use Mirakl Connect seller credentials.
429 rate limit — ShopMCP respects Mirakl's Retry-After header. Narrow filters or wait before retrying large reads.
No marketplace data — confirm the seller account has active Mirakl Connect marketplaces and permissions for products, orders, returns, and conversations.