CloudeIDE
Deploy from your terminal, and give an AI coding agent the same abilities over MCP.
CloudeIDE
Deploy from your terminal — or let your AI coding agent do it.
Website · Quick start · CLI reference · MCP setup · Troubleshooting
What this is
CloudeIDE is a cloud development environment that runs in a browser tab — editor, AI agent, sandboxed execution and deployment, with nothing to install.
This repository is the public, developer-facing part: the cloudeide command-line tool, its MCP server, and the documentation for both. It is what you need if you want to drive CloudeIDE from your own terminal, or give an AI coding agent the ability to build and ship on your behalf.
The web IDE itself lives at cloudeide.com.
Why a CLI and an MCP server
Two different problems, one binary:
- The CLI is for you.
cloudeide deploy .builds the current directory and puts it on a public URL, without opening a browser. - The MCP server is for your agent. Cursor, Claude Code and Codex can call the same operations directly — deploy, watch the build, read the log, roll back — instead of asking you to run commands and paste the output back.
The second one is the interesting half. An agent that can only write code has to hand the result to a human to ship. An agent with these tools closes the loop itself.
Install
npm install -g cloudeide
pnpm add -g cloudeide, yarn global add cloudeide and bun add -g cloudeide all work too. Node 20 or newer.
Quick start
cloudeide login # paste an API token from Settings → API tokens
cloudeide deploy . # build the current directory and publish it
That's the whole flow. deploy prints a live URL when it finishes.
To let an editor drive it instead:
cloudeide install cursor # or: claude-code, codex
That writes the correct MCP config for that tool, in the right place, in its own format. It merges into whatever config is already there rather than overwriting it, and it never writes your token into the file — the config is safe to commit.
See the quick start for the longer version.
Documentation
| Guide | What's in it |
|---|---|
| Quick start | First deploy, start to finish |
| Installation | Package managers, Node versions, upgrading, uninstalling |
| CLI reference | Every command, flag and exit code |
| MCP setup | Cursor, Claude Code and Codex — plus all 13 tools |
| Configuration | Config file, environment variables, precedence |
| Authentication | Tokens, scopes, rotation, what to do if one leaks |
| Examples | CI pipelines, preview deploys, scripting against --json |
| Troubleshooting | Errors by symptom, and what each actually means |
| FAQ | Questions that come up repeatedly |
Editor support
| Editor | Config written | Scope |
|---|---|---|
| Cursor | .cursor/mcp.json | Project, or ~/.cursor/mcp.json with --global |
| Claude Code | .mcp.json | Project — commit it and your whole team gets the tools |
| Codex | .codex/config.toml | Project, or ~/.codex/config.toml with --global |
Run cloudeide doctor afterwards. It checks each tool's configuration and tells you what's wrong rather than just failing.
Scripting
Every command takes --json, which prints one JSON document on stdout and nothing else — no progress lines, no colour. Exit codes are specific (3 not authenticated, 7 out of credits, 9 server unreachable), so a script can branch on the failure rather than on a string match.
URL=$(cloudeide deploy . --env production --json | jq -r '.liveUrl')
See examples.
Getting help
- A bug, or something that behaves surprisingly — open an issue
- A security vulnerability — please do not open a public issue; see SECURITY.md
- Account, billing or deployment questions — the dashboard at cloudeide.com
Contributing
Issues and pull requests are welcome. CONTRIBUTING.md covers how to report something usefully and what to expect from review.
License
MIT — see LICENSE.
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y cloudeideSet up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"com-cloudeide-cloudeide": {
"command": "npx",
"args": [
"-y",
"cloudeide"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
cloudeidenpmCompatible MCP Clients
CloudeIDE works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.