Scoped API tokens

MCP Authentication

Understand how StaticX API tokens keep agent, CI, and automation access narrow, revocable, and easy to audit.

Why API tokens

Credentials that match the job, not the person.

StaticX uses scoped API tokens for MCP. They work consistently in local agents, CI jobs, unattended automation, and temporary delivery workflows.

Site

One site

Best default for an agent that builds, deploys, and inspects one site.

Workspace

One workspace

Use when an agent must manage several related sites for one team or client.

Account

Global account

Reserve for trusted internal automation that genuinely needs cross-workspace access.

Lifecycle

Create narrow. Expire early. Revoke freely.

Token nameUse a purpose, such as Cursor deploy for Olive Orbit, so future you knows why it exists.
RestrictionChoose site, workspace, or account before choosing permissions.
ExpiryUse the shortest practical expiry. Rotate long-running automation deliberately.
Secret handlingThe value is shown once. Never log it, commit it, or paste it into screenshots.
Last usedReview last-used time before revoking stale or unexpected credentials.
RevocationRevocation is immediate and does not affect deployments already published.

Agent safety

Destructive actions stay separate.

Normal deploydeploy.run can publish a new immutable release.
Rollbackdeploy.rollback is separate and MCP requires ROLLBACK deployment_id.
Delete versiondeploy.delete is separate and MCP requires DELETE deployment_id.