# Install one-click apps with ChatGPT on xCloud

> Use the xCloud developer-mode app in ChatGPT to check whether a one-click app fits your server, understand inconclusive results and install on approval.

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.

## How do you set up ChatGPT to install one-click apps on xCloud?

### 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?
```

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

## 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.

### Example session

**You:** Will Immich fit my Amsterdam server?
→ `oneclickApps_compatibility` (read-only)
**Agent:** The 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.
**You:** Understood. Install it on a staging hostname anyway.
→ `oneclickApps_install` (needs approval)
**Agent:** Installing. I will poll until it finishes and tell you the phase if it fails.

## 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.

Skill: `xcloud:deploy` · Toolsets: `oneclick-apps`, `catalog`, `servers`

1. **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.
2. **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.
3. **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.
4. **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.
5. **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.
6. **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.

## One-click apps reference

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

**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 can you ask ChatGPT to do?

- Using the xcloud app, will Immich fit my Amsterdam server? Tell me if any part of the check was skipped.
- 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.
- Using the xcloud app, show me the login details for the Uptime Kuma app on Amsterdam, once, and remind me where to store them.
- Which one-click apps are compatible with my Frankfurt server?
- Search the one-click catalogue for a self-hosted blog and tell me what each result needs from a server.
- Install Uptime Kuma on the Frankfurt server on a staging hostname, wait until it is ready, then give me the login details.
- Check whether Immich fits my Amsterdam server before I install it, and tell me if the resource check was inconclusive.
- I want n8n on my Frankfurt server. Check that the server fits, then tell me where to click to install it.
- The Uptime Kuma install on the Frankfurt server failed. Which phase failed, and what do the recent events say?
- Redeploy the Ghost app on blog.example.com, but tell me what a redeploy does before you run it.

## Frequently asked questions

### 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.

## One-click apps with other agents

- [Install one-click apps with Claude Code](https://xcloud.host/agents/claude-code/one-click-apps/)
- [Install one-click apps with Claude](https://xcloud.host/agents/claude/one-click-apps/)
- [Install one-click apps with Claude Cowork](https://xcloud.host/agents/claude-cowork/one-click-apps/)
- [Install one-click apps with Cursor](https://xcloud.host/agents/cursor/one-click-apps/)
- [Install one-click apps with Codex](https://xcloud.host/agents/codex/one-click-apps/)
- [Install one-click apps with OpenCode](https://xcloud.host/agents/opencode/one-click-apps/)
- [Install one-click apps with Hermes Agent](https://xcloud.host/agents/hermes-agent/one-click-apps/)
- [Install one-click apps with OpenClaw](https://xcloud.host/agents/openclaw/one-click-apps/)
- [Install one-click apps with Windsurf](https://xcloud.host/agents/windsurf/one-click-apps/)
- [Install one-click apps with GitHub Copilot](https://xcloud.host/agents/github-copilot/one-click-apps/)
- [Install one-click apps with Gemini CLI](https://xcloud.host/agents/gemini-cli/one-click-apps/)
- [Install one-click apps with ChatGPT dots](https://xcloud.host/agents/chatgpt-dots/one-click-apps/)
- [Install one-click apps with Grok](https://xcloud.host/agents/grok/one-click-apps/)
- [Install one-click apps with Grok Bot](https://xcloud.host/agents/grok-bot/one-click-apps/)
- [Install one-click apps with Kiro](https://xcloud.host/agents/kiro/one-click-apps/)
- [Install one-click apps with Antigravity](https://xcloud.host/agents/antigravity/one-click-apps/)
- [Install one-click apps with Zed](https://xcloud.host/agents/zed/one-click-apps/)

## More ChatGPT guides

- [ChatGPT and xCloud overview](https://xcloud.host/agents/chatgpt/)
- [Deploy from Git with ChatGPT](https://xcloud.host/agents/chatgpt/deploy-from-git/)
- [Run Docker apps with ChatGPT](https://xcloud.host/agents/chatgpt/docker-apps/)
- [Manage WordPress with ChatGPT](https://xcloud.host/agents/chatgpt/wordpress/)
- [Back up and stage sites with ChatGPT](https://xcloud.host/agents/chatgpt/backups-and-staging/)
- [Manage SSL and domains with ChatGPT](https://xcloud.host/agents/chatgpt/ssl-and-domains/)
- [Manage servers with ChatGPT](https://xcloud.host/agents/chatgpt/server-management/)
- [Troubleshoot a broken site with ChatGPT](https://xcloud.host/agents/chatgpt/troubleshooting/)
- [Speed up a slow site with ChatGPT](https://xcloud.host/agents/chatgpt/performance/)
- [Secure sites and servers with ChatGPT](https://xcloud.host/agents/chatgpt/security/)

## Related documentation

- [One-click apps on xCloud](https://xcloud.host/one-click-apps/)
- [Use one-click app templates in xCloud](https://xcloud.host/docs/how-to-use-one-click-app-templates-in-xcloud/)
- [Deploy n8n with one-click apps](https://xcloud.host/docs/deploy-n8n-with-xcloud-with-one-click-apps/)

Canonical: https://xcloud.host/agents/chatgpt/one-click-apps/
Last updated: October 2026. Keep a human in the loop: xCloud stops and asks before anything that creates, deploys, updates, reboots, deletes or buys.
Every agent guide: https://xcloud.host/agents/ · xCloud MCP: https://xcloud.host/mcp/ · Agent Skills: https://xcloud.host/ai-agent-skills/ · Setup script for agents: https://xcloud.host/agent-setup/prompt.md