Skip to content

Client registration

Purpose

Register a portfolio product so it can call MKP APIs and use OIDC.

How it works

Register a ClientSite in admin with domains, callback URLs, capabilities, and credentials.

Issue a public site key for browser embeds and a hashed server secret for trusted backends.

Link an OAuth Toolkit Application for OIDC. Use PKCE for public clients.

For Replit client previews in development, add the preview hostname to the ClientSite’s Allowed domains (seed/docs demos also sync REPLIT_DEV_DOMAIN automatically).

Live prototype

The documentation host is registered as ClientSite mkpworks-docs with a stable public site key used by all live prototypes. Fetch its public config:

Public site config

GET /api/v1/sites/mkpworks-docs/public-config/ with X-MKP-Site-Key.

Code to paste

fetch("https://YOUR_PLATFORM/api/v1/sites/mkpworks-docs/public-config/", {
  headers: {
    Accept: "application/json",
    "X-MKP-Site-Key": "pk_mkpworks_docs_live_demo"
  }
}).then((r) => r.json()).then(console.log);