Antigravity + xCloud

Install one-click apps with Antigravity on xCloud

Installing one-click apps with Antigravity means asking Google's coding agent to find an app in the xCloud catalogue, check that your server fits, install it once you approve and give you the address, from the panel next to your code.

Skill: xcloud:deploy
Toolsets: oneclick-apps, catalog, servers
Free with every xCloud account

Set up Antigravity All Antigravity guides

YouI want n8n on my Frankfurt server. Check that it fits and tell me how to install it.

oneclickApps_compatibilityread-only

AgentFrankfurt fits n8n on stack, runtime, state and billing. n8n installs only from the dashboard, so I cannot do it from here.

AgentIn the xCloud dashboard go to Add site, then One-Click Apps, and pick n8n. Want me to check the install afterwards?

Last updated: October 2026. Keep a human in the loop: xCloud stops and asks before anything that creates, deploys, updates, reboots, deletes or buys.

Setup

How Do You Set Up Antigravity to Install one-click apps on xCloud?

Connect Antigravity once; every job on this account uses the same connection. Then ask in plain words.

1
Add xCloud in View raw config
In the Antigravity IDE, click the three dots at the top of the agent side panel, choose MCP Servers, then Manage MCP Servers, then View raw config. Paste this into mcp_config.json and save. The field is serverUrl: it is the only remote URL property in Antigravity's documented configuration, so do not write url or httpUrl.
JSON
```
{
  "mcpServers": {
    "xcloud": {
      "serverUrl": "https://app.xcloud.host/mcp"
    }
  }
}
```
2
Sign in, then check the connection
Open Agent settings (Cmd+, on Mac, Ctrl+, on Windows and Linux), go to Customizations and click Authenticate next to xcloud. Approve the teams and the access level in the browser, copy the authorization code it shows, paste it into the settings panel and click Submit. Then ask this in the agent panel.
Prompt
```
Who am I on xCloud?
```
3
No browser sign-in? Use an API key
Create a token with the mcp:invoke scope plus the read abilities for the areas it will use (read:servers and read:sites, with read:billing and read:addons for billing and add-on tools) and the matching write: abilities if it should change things in Settings, Developers, API Tokens and add it as a header. Replace YOUR_TOKEN with the token, which contains a pipe character, and never paste it into chat. Keep this file out of git.
JSON
```
{
  "mcpServers": {
    "xcloud": {
      "serverUrl": "https://app.xcloud.host/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

Check it worked

Then ask Antigravity for the job itself, for example:

Prompt

Check whether Immich fits my Amsterdam server before I install it, and tell me if the resource check was inconclusive.

In practice

How Does One-click apps Work from Antigravity?

Antigravity starts from caution. An MCP tool you have not configured runs in Ask mode, so the agent pauses for your approval on each call it makes. A one-click install is a good test of that default, because it makes many calls: the catalogue search, the install form, the compatibility check, the install, then a run of status checks. You do not need to approve each of those by habit. In the permission policy you can allow single tools with a pattern like mcp(xcloud/tool_name), so the reading calls go through and the install call still asks.

In the agent panel you give the app and the server. Antigravity calls xCloud, shows you what the app needs and what the compatibility check found, and flags an inconclusive resource check when the server has no fresh monitoring reading. It then states the app, server and address and asks for your go-ahead. After the install call, the agent polls the status and tells you the phase it is in. A failure names its phase, and the agent reads the site's recent events before suggesting anything, because a server that is too small will not become big enough on a second try. Apps such as Nextcloud or Supabase that install only from the dashboard get a fit check and a pointer to Add site, One-Click Apps.

The same mcp_config.json entry, with serverUrl, serves the IDE, the command-line tool and the Antigravity 2.0 app, so you can start an install in one and ask about it in another. That helps for a job that finishes minutes after you asked. You can also ask a later session for the app's login details; the agent fetches credentials only on request and shows them once. Hosting Antigravity itself on an xCloud server is a different product with its own page.

Antigravity specific: Do not allow the whole server with mcp(xcloud/*) to save yourself the clicks. That pattern also skips Antigravity's prompt for stop and redeploy, which take an app offline or recreate its containers. xCloud still asks for confirmation, but you lose the second check. If the first sign-in did not finish, remember that Antigravity's OAuth ends with a pasted authorization code under Settings, Customizations, so an install that fails with an authentication error usually means that step was skipped.

What xCloud does for one-click apps

xCloud lists the one-click catalogue, checks whether an app fits a given server, installs it once you approve and reports each install phase until it finishes. Afterwards the agent can fetch the login details and stop, start or redeploy the app. A few apps install only from the dashboard, and the agent tells you where to click.

Find the app. The agent searches the catalogue by name or purpose and shows what it found. An empty catalogue means the list has not synced on that environment, so the agent never answers that an app does not exist from an empty list.
Read the install form. The agent reads the app's fields. Fields xCloud generates for you can be left out. For the address you choose a free xCloud staging hostname or your own domain, and a live domain needs the full site name.
Check the server fits. You name the server, or the agent lists yours and asks. The compatibility check covers the server stack, runtime, state, billing and RAM, CPU and disk against the latest monitoring snapshot. If monitoring data is missing the resource check was skipped, and the agent says the result is inconclusive.
Approve and install. The agent restates the app, the server and the address, and asks once. On your yes it sends the install with an explicit confirmation and an idempotency key, so a retried request cannot create a second copy.
Poll the install. The agent polls the install status every five to ten seconds until it is terminal. A failure names its phase: pre_install, install, post_install or provisioning, so you know where it stopped.
Hand over and manage. The agent gives you the URL. It fetches the login details only when you ask, shows them once in the reply and tells you to store them in a password manager. Later it can stop, start, restart or redeploy the app after your approval.

Reference

One-click apps Settings and Limits on xCloud

The facts Antigravity works within when it installs one-click apps. Where a row names the dashboard, that step stays yours to take there.

Setting or limit	What applies
Catalogue	Searchable by name. It holds hundreds of apps, and most run on a Docker server. Public facts such as supported stacks and minimum size come from the catalogue listing
Compatibility check	Per server: stack, runtime, server state, billing and RAM, CPU and disk. monitor_available set to false means the resource check was skipped, not passed
Too-small servers	A server that is too small stays too small. The agent suggests a larger server instead of retrying the install
Stack requirements	An app that needs another stack is refused with a 422 that reads "This app requires a ... server. This server is on the ... stack."
Dashboard-only installs	n8n, Supabase, Nextcloud, Mautic, LibreChat, Open WebUI, Ollama, Umami, WireGuard, phpMyAdmin and Site.pro. The API answers 404 for these eleven; install them from Add site, One-Click Apps in the dashboard
Address	Staging hostname for a free xCloud address, or go live with your own domain. A demo site promoted to a live domain cannot return to the demo address
Idempotency	The install carries an Idempotency-Key, so a retried request cannot create a duplicate site
Install phases	pre_install, install, post_install and provisioning. is_terminal marks the end, and failed_phase says where a failure happened
Credentials	Read on request and shown once in the reply. Some apps have none to read because you create the first admin inside the app
Lifecycle	Stop, start, restart and redeploy run synchronously. Stop takes the app offline and redeploy recreates its containers. Both answer 422 while an install is running or after a failed install
Agentic servers	An OpenClaw, Hermes, Paperclip or DeepSeek Harness server never takes a one-click app

Rules Antigravity has to follow

Installing, stopping and redeploying an app stop for your approval; browsing the catalogue and the compatibility check never change anything.
A missing resource reading is reported as inconclusive, never as a pass.
Login details are shown once, only when you ask, and never repeated in a summary or a later message.
For the eleven dashboard-only apps the agent checks that the server fits, then gives you the dashboard path instead of trying the install.
A failed install is not retried blindly: the agent names the failed phase and reads the site's recent events first.

Example prompts

What Can You Ask Antigravity to Do for One-click apps?

Type these as written and swap in your own repository, site and server names. Reads and routine actions such as backups, cache purges, PageSpeed scans and vulnerability scans run straight away; creating, deploying, updating, rebooting, deleting, buying or starting a broken-link scan stops and asks first.

Prompt

Check whether Immich fits my Amsterdam server before I install it, and tell me if the resource check was inconclusive.

Prompt

Install Uptime Kuma on the Frankfurt server on a staging hostname. State the app, server and address and wait for my approval.

Prompt

I want n8n on my Frankfurt server. Check that it fits, then tell me where to click to install it.

Prompt

Which one-click apps are compatible with my Frankfurt server?

Prompt

Search the one-click catalogue for a self-hosted blog and tell me what each result needs from a server.

Prompt

Install Uptime Kuma on the Frankfurt server on a staging hostname, wait until it is ready, then give me the login details.

Prompt

I want n8n on my Frankfurt server. Check that the server fits, then tell me where to click to install it.

Prompt

The Uptime Kuma install on the Frankfurt server failed. Which phase failed, and what do the recent events say?

Prompt

Redeploy the Ghost app on blog.example.com, but tell me what a redeploy does before you run it.

Antigravity and One-click apps: Frequently Asked Questions

What people ask before they let Antigravity install one-click apps through xCloud.

Why does Antigravity ask me to approve every step of a one-click install?

An MCP tool you have not configured runs in Ask mode, so each call pauses for approval. Allow the read tools one at a time with a pattern like mcp(xcloud/tool_name) and leave the install and lifecycle tools on ask.

Can Antigravity install n8n or Supabase from the agent panel?

No. Eleven apps, including n8n and Supabase, install only from the dashboard, and the API answers 404 for them. Antigravity can check that your server fits and then give you the path: Add site, One-Click Apps.

Can an agent install any app in the one-click catalogue?

Most of them. Eleven apps install only from the dashboard: n8n, Supabase, Nextcloud, Mautic, LibreChat, Open WebUI, Ollama, Umami, WireGuard, phpMyAdmin and Site.pro. For those the agent checks that your server fits and points you to Add site, One-Click Apps.

How does the agent know an app will fit my server?

It runs the compatibility check for that server, which covers the stack, runtime, server state, billing and the RAM, CPU and disk readings from the latest monitoring snapshot. If monitoring data is missing, the agent tells you the resource check was inconclusive.

What does a 422 during an app install mean?

Usually that the app needs a different server stack than the one you picked, and the message names both. Pick a server on the required stack. A 422 on stop, start or redeploy means an install is still running or the last install failed.

Where do the login details for a one-click app come from?

The agent can read them from xCloud when you ask and shows them once in the reply. Store them in a password manager. Some apps have no generated login because you create the first administrator inside the app.

Can an agent stop or restart a one-click app?

Yes. Stop, start, restart and redeploy are available, and they run straight away once you approve. Stop takes the app offline and redeploy recreates its containers, so the agent asks before either.

Other agents