DocumentationLicense
Cloud
Cloudbeta

Publish a config

Turn a validated gateway config into a running managed MCP endpoint on mcpg.cloud — log in, set your context, validate, publish, and read back the endpoint URL. Re-publishing the same name updates in place.

Publishing is the core loop of mcpg.cloud: a validated AppConfig goes in, a running managed gateway with its own MCP endpoint comes out. This is the end-to-end walkthrough.

1. Log in

mcpg cloud login runs an OIDC sign-in and stores the credential locally. Your federation license rides along automatically so the platform resolves your real tenant organization on first contact.

bash
mcpg cloud login
mcpg cloud whoami     # the orgs this login can act on

2. Set your context

Every command needs an org, workspace, and environment. Set them once so later commands take just their primary noun:

bash
mcpg cloud use --org acme --workspace prod --env eu

Coordinates resolve flag > environment variable (MCPG_ORG / MCPG_WORKSPACE / MCPG_ENV) > this stored context, so you can always override per command.

3. Validate before you ship

The platform validates too, but catching problems locally is faster. Run the same check CI runs — see Configure the gateway for the authoring workflow:

bash
mcpg config check gw.yaml

4. Publish

Publish the config under a name. The command streams a phase ladder as the gateway is provisioned:

bash
mcpg cloud publish edge --config gw.yaml \
  --replicas 2 \
  --region eu \
  --size s

Useful flags: --replicas (horizontal scale), --region, --size (resource class), --isolation-tier, --image-tag (pin the gateway image), and --custom-hostname (see Custom domains).

Publishing the same name again updates it in place and records a new config version — it does not create a second instance.

5. Read back the endpoint

bash
mcpg cloud instances              # endpoint URLs + instance ids
mcpg cloud operations             # recent provisioning operations
mcpg cloud logs edge --follow     # stream the gateway's logs

Point any MCP client at the endpoint URL from instances, exactly as you would a self-hosted gateway.

Tear down

bash
mcpg cloud delete edge            # by name (a UUID-shaped target deletes by id)

Where to go next