ChatGPT + xCloud

Install one-click apps with ChatGPT on xCloud

Checking and installing one-click apps with ChatGPT means using the xCloud developer-mode app in a chat to ask whether a catalogue app fits your server, understand what the check could not verify, and install it after you confirm.

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

Set up ChatGPT All ChatGPT guides

YouWill Immich fit my Amsterdam server?

oneclickApps_compatibilityread-only

AgentThe stack, runtime and server state all pass. Amsterdam has no recent monitoring snapshot, so the RAM, CPU and disk check was skipped. That makes the result inconclusive, not a pass.

YouUnderstood. Install it on a staging hostname anyway.

oneclickApps_installneeds approval

AgentInstalling. I will poll until it finishes and tell you the phase if it fails.

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 ChatGPT to Install one-click apps on xCloud?

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

1
Turn on developer mode and open Plugins
In ChatGPT on the web, open Settings, Security and login and turn on Developer mode. Then open the Plugins page and select the plus button to create an app. OpenAI lists developer mode for Pro, Plus, Business, Enterprise and Education accounts on the web, but its help center puts full MCP support with write actions in beta on Business, Enterprise and Edu workspaces and gives Pro accounts read and fetch access only, so check your plan before you expect ChatGPT to deploy or update anything. That path is for a personal account. In a Business, Enterprise or Edu workspace the controls sit under Apps instead. On Business only an admin or owner can use Developer mode: they turn it on while creating the app from Workspace settings, Apps, Create, and publish it from Workspace settings, Apps. On Enterprise and Edu an admin or owner can also toggle Developer mode under Settings, Apps, Advanced settings, and a member granted developer access under Permissions and Roles turns it on there too and can create and test the app from their own Settings, Apps, Create, but only an admin or owner can publish it. An ordinary member cannot do this, so ask an admin to publish the xcloud app; then open Settings, Plugins, select xcloud, install it if offered and choose Connect, sign in to xCloud and pick the teams and access level, and only then start at the last step.
URL
```
https://chatgpt.com/plugins
```
2
Create the app with the xCloud MCP URL
Name the app xcloud, paste this as the MCP server URL and choose OAuth for authentication. xCloud supports dynamic client registration, so you do not need to create a client ID. Sign in with xCloud when the browser asks, tick the teams and choose Read-only or Full access.
URL
```
https://app.xcloud.host/mcp
```
3
Install the plugin and use it in a Work chat
Open your personal Plugins page, open xcloud and select the plus button to install it. Back on the ChatGPT homepage, switch the tab at the top from Chat to Work, start a new Work chat, type @ and pick xcloud; a plain Chat tab conversation does not offer the plugin. Then type a request like this one.
Prompt
```
Using the xcloud app, who am I on xCloud and which servers do I have?
```

Check it worked

Then ask ChatGPT for the job itself, for example:

Prompt

Using the xcloud app, will Immich fit my Amsterdam server? Tell me if any part of the check was skipped.

In practice

How Does One-click apps Work from ChatGPT?

ChatGPT suits the question you ask before any install: will this fit. You pick the xcloud plugin for the conversation with @xcloud in a Work chat, and ask whether Immich will run on your Amsterdam server. ChatGPT calls oneclickApps_compatibility and explains the answer in the chat. The honest edge case is a server with no recent monitoring snapshot. In that case the resource check was skipped, which is not the same as passing, and ChatGPT says the result is inconclusive and lists what it could verify, such as the stack and the server state, so you can decide whether to go ahead or look at the server first.

From there the chat can carry on to an install, using the steps in the job. ChatGPT reads the install form with oneclickApps_show, asks whether you want a free staging hostname or your own domain, and restates the app, the server and the address. OpenAI's developer mode asks for confirmation on write actions by default, and xCloud stops an install for your approval as well, so you may be asked to confirm in the chat and again in ChatGPT's own prompt. Read both. The idempotency key that xCloud requires means a retried request cannot create a second copy.

The important property of this client is where it connects from: ChatGPT reaches xCloud from OpenAI's servers, not from your machine, so the connection does not depend on your network, and you need no terminal or config file. The xcloud app sits under Drafts in ChatGPT's settings, where you can switch individual tools off, which is a clean way to keep a chat to browsing and checks. Login details, if you ask for them, appear once in the reply, so copy them into a password manager before you move on.

ChatGPT specific: If a chat starts answering about xCloud without calling it, the plugin was probably not picked with @xcloud in that conversation, or the tab is Chat rather than Work, so pick xcloud again before you trust an answer. After xCloud adds a tool, refresh the app's tool list under Drafts in settings. Choose Read-only on the xCloud approval screen if you only want checks, since an install needs Full access.

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 ChatGPT 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 ChatGPT 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 ChatGPT 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

Using the xcloud app, will Immich fit my Amsterdam server? Tell me if any part of the check was skipped.

Prompt

Using the xcloud app, install Uptime Kuma on the Amsterdam server on a free staging hostname. Tell me the app, server and address before you start.

Prompt

Using the xcloud app, show me the login details for the Uptime Kuma app on Amsterdam, once, and remind me where to store them.

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

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

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.

ChatGPT and One-click apps: Frequently Asked Questions

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

What does an inconclusive result mean when ChatGPT checks my server?

It means xCloud had no recent monitoring snapshot for that server, so the RAM, CPU and disk check was skipped rather than passed. ChatGPT reports what it did verify, such as the stack and the server state, and leaves the decision about installing anyway to you.

Does ChatGPT need my approval to install a one-click app?

Yes. xCloud stops an install for explicit confirmation, and ChatGPT's developer mode also asks before write actions. ChatGPT restates the app, the server and the address first, so check those before you accept the prompt.

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