Connect Claude Code, Codex or Cursor to MonstarX

In shortMonstarX has an MCP server at https://monstarx.com/mcp. Add it to Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf, ChatGPT or the Claude app, sign in once in your browser, and say "Push this app to MonstarX and give me the link". Your agent can then push new versions, pull MonstarX's changes, ask MonstarX to build, set secrets and publish.

AI coding agents like Claude Code, Codex and Cursor are great at writing an app, and leave the rest to you: somewhere to run it, a link to share, a domain, a database, testing, and a way for people who aren’t developers to keep changing it. MonstarX is that rest.

Connect your agent to MonstarX once, and “push this app to MonstarX” puts what it built on MonstarX, running in a live preview with a link to share. From then on, you can keep building in your agent, in MonstarX, or both — the work goes both ways.

Agents connect through MCP (the Model Context Protocol, a standard way for AI tools to use other services). MonstarX’s MCP server lives at:

https://monstarx.com/mcp

MonstarX's MCP server page: Build it in your agent. Ship it on MonstarX., the address https://monstarx.com/mcp with Copy URL, the agents it works with, and Copy the setup prompt for your agent

The full developer guide is on MonstarX’s MCP page.

How do I connect my agent?

Open SettingsAPI & MCP. Under Connect a coding agent, pick your agent.
Keep Browser sign-in selected and copy the setup it shows into your agent. The tabs below show the same setup for the most common agents.
Sign in to MonstarX when your agent asks. Your browser opens MonstarX: sign in and press Allow. No key needed.
Say “Push this app to MonstarX and give me the link.”

Claude Code’s command-line tool, the desktop app’s Code tab and the IDE extensions share one setup. Run:

claude mcp add --transport http --scope user monstarx https://monstarx.com/mcp

Then run /mcp in Claude Code, pick monstarx and choose Authenticate (or run claude mcp login monstarx). Your browser opens MonstarX: sign in and press Allow.

--scope user makes MonstarX available in every folder; leave it out to add it to the current project only.

For OpenAI’s Codex command-line tool and IDE extension, run:

codex mcp add monstarx --url https://monstarx.com/mcp
codex mcp login monstarx

The login opens your browser: sign in to MonstarX and press Allow.

Codex runs commands without network access by default, and pushing an app needs the network. Approve the upload command when Codex asks, or allow network access for the session.

Click Add to Cursor in the Cursor setup in Settings, or add MonstarX to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monstarx": {
      "url": "https://monstarx.com/mcp"
    }
  }
}

Cursor lists MonstarX under Settings → MCP with a sign-in button: sign in and press Allow. In Cursor’s command-line agent: agent mcp login monstarx.

For GitHub Copilot’s agent mode, click Install in VS Code in the VS Code setup in Settings, or run:

code --add-mcp '{"name":"monstarx","type":"http","url":"https://monstarx.com/mcp"}'

VS Code asks you to sign in the first time a MonstarX tool runs: sign in and press Allow.

Run:

gemini mcp add --transport http monstarx https://monstarx.com/mcp

Then run /mcp auth monstarx in Gemini CLI and press Allow in the browser.

Add MonstarX to ~/.codeium/windsurf/mcp_config.json. Cascade asks you to sign in the first time:

{
  "mcpServers": {
    "monstarx": {
      "serverUrl": "https://monstarx.com/mcp"
    }
  }
}

On Free, Pro and Max: Customize → Connectors → Add custom connector, paste https://monstarx.com/mcp, then Connect: sign in to MonstarX and press Allow. On Team and Enterprise, an Owner adds it under Organization settings → Connectors, and members press Connect.

One connector works on the web, the desktop app and mobile. Claude chats have no command line, so whole apps come in from GitHub instead of being uploaded.

Turn on Developer mode in ChatGPT’s settings (on Business and Enterprise an admin allows it first), then create a new app or connector with the address https://monstarx.com/mcp and choose OAuth. ChatGPT asks before each tool that changes something.

The Settings page also covers Grok, Lovable, Bolt & v0, Replit, Figma and Others — any tool that speaks MCP. The full developer guide, with more clients, is behind Documentation at the top of SettingsAPI & MCP.

What if my agent needs a key?

Windsurf, Gemini CLI, scripts and CI take an API key instead of a browser sign-in. Make one in SettingsAPI & MCP under API keys, then switch the agent’s setup to API key to get the version with the key in it. See API & MCP for making, using and revoking keys — and keep keys out of code and chats: a key acts as you on every project.

What can I ask my agent to do?

Once connected, talk to your agent in plain words. Try these:

“Push this app to MonstarX and give me the link.”
“Push my changes to MonstarX.”
“Pull the latest version from MonstarX and merge it with my changes.”
“Ask MonstarX to add Stripe checkout, then pull its changes.”
“Publish it on MonstarX.”

In a chat app without a command line (the Claude app, ChatGPT), try “Build me a booking app for my salon on MonstarX”, “Import github.com/me/my-app into MonstarX” or “What is MonstarX doing on my Harbour Watch project?”.

What happens when my agent pushes an app?

The agent asks MonstarX for a one-time upload link, then sends your app’s folder with a single command. node_modules, build output and .env files stay on your machine, and the files never pass through the AI model, so a large app costs no more tokens than a small one.
MonstarX checks what the app is — the same check as importing an app — and runs it in a live preview with its own packages.
The agent gets back the project link, what MonstarX found, and any keys the app still needs.

Every later push becomes a new version in Versions, named after the agent (“Pushed from Claude Code”), with a note in the chat so you and MonstarX’s builder know what changed. If someone built in MonstarX since your agent’s last copy, the push is refused instead of overwriting their work: the agent downloads MonstarX’s version, merges, and pushes again.

Which tools does MonstarX give my agent?

Tool	What it does
`get_account`	Your account, plan and what is left of your allowance
`list_projects`	Your projects, most recently changed first
`get_project`	One project at a glance: what MonstarX is doing, the preview, publishing, missing secrets
`prepare_upload`	A one-time upload link and the command to push the current folder, as a new project or a new version
`import_from_github`	Bring in an app from a GitHub repository
`push_files`	Write a few files directly, for small edits or agents without a command line
`create_project`	Have MonstarX build a new app from a description, pictures or documents
`read_files`	List or read a project’s files
`download_project`	A one-time download link and the command to unpack the project
`send_message`	Ask MonstarX’s builder to build, answer or plan, as if you typed in the workspace
`get_messages`	Read the project’s chat, optionally waiting for MonstarX to finish replying
`stop`	Stop what MonstarX is running in a project
`publish_project`	Put the current version live
`set_secrets`	Store the keys the app reads, encrypted, in Backend → Secrets
`get_logs`	The preview’s state and output; can start a stopped preview

Every tool acts only on projects you own. Tools that only read are marked so, so agents can run them without asking; publishing always asks first.

Limits

Uploads: up to 100 MB as a .tar.gz (what the push command makes) or 50 MB as a .zip. Files over 10 MB are left out and listed.
push_files: 200 files, 400 KB each, 2 MB per call.
Links for uploads and downloads work once, for 15 minutes.
A push that would delete most of a project (fewer than a quarter of its files) is refused — that is almost always the wrong folder.
A push is refused while MonstarX is building in that project.
Allowance: asking MonstarX to build (send_message, create_project) uses your plan’s allowance. Pushing, importing, downloading, reading and publishing don’t.
API keys: up to 20 per account. Browser sign-ins stay signed in for 90 days of use.

Troubleshooting

The MonstarX tools don’t show up. Most agents load servers when a session starts: start a new one. In Claude Code, /mcp shows whether MonstarX is connected.
“Sign in” or an unauthorised error. The sign-in lapsed or the key was revoked. Sign in again (/mcp in Claude Code, codex mcp login monstarx) or make a new key.
Codex can’t upload. Its sandbox blocks the network: approve the command, or allow network access.
“This upload has 3 files and the project has 214”. The command ran in the wrong folder. Run it where package.json is.
“The files in MonstarX changed since your copy was taken”. Someone built in MonstarX after your last push. Ask your agent to download, merge and push again.
A private GitHub repository isn’t found. Connect GitHub in MonstarX first — see GitHub.
The app doesn’t start. Ask your agent to check the logs; a missing key can be set with set_secrets.

How do I disconnect an agent?

Open SettingsAPI & MCP and click Disconnect beside the agent under Connected agents — it is signed out at once. An agent that uses a key stops when you Revoke the key. See API & MCP.

Frequently asked questions

Do I need an API key?

Usually not. Most agents sign in through your browser: you sign in to MonstarX and press Allow. Keys are for agents, scripts and CI that can't open a browser.

Will my .env files be uploaded?

No. The push command leaves them out, and if one arrives anyway MonstarX doesn't store it. Keep keys in Backend → Secrets, or ask your agent to use set_secrets.

Can I keep building in both my agent and MonstarX?

Yes. Push from your agent, build in MonstarX, then ask your agent to pull the latest version. A revision check stops either side from overwriting the other.

Which apps run on MonstarX?

MonstarX apps and Vite apps (React, Vue, Svelte — every Lovable, Bolt and v0 export) run and publish here. Next.js, Remix, Astro, Nuxt and SvelteKit run in the preview but publish on their own host. Others can be rebuilt as a web app.

Is this the same as MCP connectors?

No, it is the opposite direction. Here your agent uses MonstarX. MCP connectors let MonstarX use other MCP servers.

Start from your coding agentPush an app you built elsewhere as a new project.

API & MCPConnected agents and API keys.

Import an appWhat runs on MonstarX, and how imports work.

GitHubKeep a project in a GitHub repository.