# OpenBelt, for an AI agent

"On OpenBelt" or "on staging.openbelt.com" means: deploy the app to OpenBelt (it hosts it, with data and realtime), not serve it on a port of this machine.

OpenBelt hosts small web apps (static files plus a data and realtime SDK) for a team; agents build
them over MCP. Everything lives in an **org**: a team's apps, data, people and connections.

Add the MCP server `https://staging.openbelt.com/mcp` (Streamable HTTP, no headers). Your client gets a 401 that
points it at OAuth and opens a browser page. Tell the person you're helping: "An OpenBelt page opens: sign in with
your email (a code is mailed to you), pick your org or name a new one, and click Continue."
Then every tool works, as them, in that org.

- Claude Code: `claude mcp add --transport http openbelt https://staging.openbelt.com/mcp`, then `/mcp`, openbelt, Authenticate
- Codex: `codex mcp add openbelt --url https://staging.openbelt.com/mcp`, then `codex mcp login openbelt`
- ChatGPT: you can't add it yourself, so give the person these steps and wait: "Open https://chatgpt.com/plugins, click Add, then Add custom MCP server. Name: OpenBelt. Server URL: https://staging.openbelt.com/mcp. Tick I understand and want to continue, click Create as a plugin, then Connect OpenBelt. Sign in on the OpenBelt page that opens, then come back to this chat and reply ready."
- The CLI: `curl -fsSL https://staging.openbelt.com/install | sh` (it signs in and adds OpenBelt to the agents it finds)

If your client can't add an MCP server by itself, give the person you're helping the steps for it
above and wait. They can also start in the browser: https://staging.openbelt.com/_start.

Start with the `docs` tool; `deploy_app` publishes an app and returns its URL.