aeria is an MCP server. You use it from Claude Code, Claude Desktop, claude.ai or any client that speaks MCP: your own agent calls aeria’s tools. aeria has no agent of its own.

With its tools, your agent makes apps. Each app starts from the seed app, its code kept in Cloudflare Artifacts, built in a sandbox (a Cloudflare container), run on aeria.run. What you or your agent make belongs to a workspace: its members, apps, artifacts, connections and events.

The flow

Every change to an app follows the same five steps, each one tool call from your client:

1 create   app_create          the seed forked, production running
2 branch   app_branch_create   a branch from main: a session, its sandbox
3 change   app_file_write,     in the branch's sandbox
           app_command_run
4 preview  app_preview         the branch built, on its own host
5 promote  app_promote         merged when not behind main,
                               production updated

A session is a branch is a sandbox: each open branch has its own sandbox, its own preview on its own host, and its own events. Production runs main; a merge is the only way to promote. Each step in detail: The flow.

What your client does, and what aeria does

• Your agent reads, writes and runs code through aeria’s tools. It never runs git and never holds a credential: Claude Code, Claude Desktop and claude.ai work the same way.
• aeria runs every code tool as an exec in the branch’s sandbox, builds, keeps each build, and uploads it with its own key.
• You answer what only a person may: a call held at ask, a secret typed on app.aeria.dev, your sign-in, your consent to a client.

Every tool call is an event, pushed to the web app on app.aeria.dev as it happens.

The guides

• Connect a client: Claude Code, claude.ai, any MCP client, at app.aeria.dev/mcp.
• The flow: create, branch, change, preview, promote; what each refusal means.
• Tools: every tool by area, each with its level (allow, ask, deny).
• Connections: Stripe, Shopify or any service, called through aeria without your client ever holding its key.
• Artifacts: pages, PDFs, sheets, emails and videos your agent makes, kept in versions.
• Security: what holds, in plain words.
• Words: one word per thing, the same in every tool and every guide.