ChatGPT dots + xCloud

Install one-click apps with ChatGPT dots on xCloud

Installing one-click apps with a ChatGPT dot means asking your always-on OpenAI agent to search the xCloud catalogue, check that a server fits and install the app after your approval, then keep watching it and hand you the login.

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

Set up ChatGPT dots All ChatGPT dots guides

YouInstall Uptime Kuma on my Frankfurt server on a staging hostname, but check that it fits first.

oneclickApps_compatibilityread-only

AgentThe stack, runtime and server state pass. Frankfurt has no recent monitoring snapshot, so the RAM, CPU and disk check was skipped and the result is inconclusive. Install anyway on a free staging hostname?

YouYes, install it.

oneclickApps_installneeds approval

AgentThe install is accepted. I will follow it until it finishes and tell you here which phase failed if it does.

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

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

1
Create the xCloud MCP plugin in ChatGPT
Plugins are shared across your dot, ChatGPT, ChatGPT Work and Codex, so you set xCloud up once. In ChatGPT on the web, turn on Developer mode under Settings, Security and login, open the Plugins page, select the plus button and create an app named xcloud with this MCP server URL and OAuth as the authentication. Sign in with xCloud, tick the teams and choose Read-only or Full access. Then open your personal Plugins page, open xcloud and select the plus button to install it; until it is installed, your dot cannot see it. If ChatGPT already has the xcloud plugin installed, skip this step. 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 next step.
URL
```
https://app.xcloud.host/mcp
```
2
Check the plugin is connected for your dot
Open your dot's profile, then Customize and Plugins, and make sure xcloud is connected. The screen uses the shared ChatGPT plugin settings, so a plugin connected in ChatGPT appears here too. Then give your dot a first task that names xCloud.
Prompt
```
Using xcloud, who am I on xCloud, and which servers and sites do I have?
```
3
Add a custom rule for hosting changes
Under Customize, Custom rules, describe the action and choose Ask before taking action. Pre-approved means you asked for the action in your prompt. xCloud stops for confirmation on its own before it creates, deploys, updates, reboots or deletes anything, but a rule keeps the approval visible in your conversation and stops a scheduled task from proposing changes you did not ask for.
Prompt
```
Ask before taking action: anything that creates, deploys, updates, reboots or deletes a server or site on xCloud.
```

Check it worked

Then ask ChatGPT dots for the job itself, for example:

Prompt

Find a self-hosted uptime monitor in the xCloud one-click catalogue and check whether it fits my Frankfurt server. If the RAM, CPU and disk check was skipped, tell me the result is inconclusive.

In practice

How Does One-click apps Work from ChatGPT dots?

The one-click catalogue is large, and most of the work is deciding what fits where, which is a good job to hand a dot. Tell it what you want in your own words, such as a self-hosted uptime monitor for my Frankfurt server, and it searches with oneclickApps_index, reads the app with oneclickApps_show and runs oneclickApps_compatibility against the server you named. The check covers the stack, the runtime, the server state, billing and, when xCloud has a recent monitoring snapshot, RAM, CPU and disk. If the snapshot is missing, the dot should tell you the result is inconclusive and not a pass. It is worth writing that into a Custom rule so the dot never rounds it up.

The install is a write, so it is the step that waits for you. Your dot restates the app, the server and the address, you answer in the conversation, and it sends oneclickApps_install with an explicit confirmation and an idempotency key. It then follows oneclickApps_status every few seconds until the install is terminal, and a failure names its phase: pre_install, install, post_install or provisioning. Login details come from oneclickApps_credentials only when you ask, and the dot shows them once. A dot's conversation is kept, so treat that message like any password and move it into a password manager. Because the dot keeps working between conversations, you can leave it a standing job such as every Monday, read the status of my one-click apps and tell me if any has stopped.

Eleven apps never go through this path. n8n, Supabase, Nextcloud, Mautic, LibreChat, Open WebUI, Ollama, Umami, WireGuard, phpMyAdmin and Site.pro install only from the dashboard, where the API answers 404. Ask your dot about one of them and the useful thing it can do is the compatibility check plus the dashboard path, Add site, One-Click Apps. It will not attempt the install, and there is no point asking it to retry.

ChatGPT dots specific: Installing is a write action. OpenAI's help center says full MCP support with write actions is in beta on Business, Enterprise and Edu workspaces, and Pro accounts connect MCP apps with read and fetch permissions only. On Pro your dot can browse the catalogue and run the compatibility check, but the install needs a workspace on one of the other plans. Stop, restart and redeploy take the app offline or recreate its containers, so a scheduled status check should report a stopped app and leave the restart to you unless your rules say otherwise.

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

Find a self-hosted uptime monitor in the xCloud one-click catalogue and check whether it fits my Frankfurt server. If the RAM, CPU and disk check was skipped, tell me the result is inconclusive.

Prompt

Install Uptime Kuma on my Frankfurt server on a staging hostname. Show me the app, the server and the address first, wait for my yes, then follow the install and tell me which phase failed if it does.

Prompt

Every Monday at 9, check the status of the one-click apps on my Frankfurt server and message me any that have stopped. Do not restart anything without asking me.

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 dots and One-click apps: Frequently Asked Questions

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

Can my ChatGPT dot install n8n or Nextcloud on xCloud?

No. n8n, Nextcloud and nine other apps install only from the dashboard, because the API answers 404 for them. Your dot can check that your server fits and give you the path, Add site, One-Click Apps, but you do the install there.

Is it safe to let my dot read my one-click app login details?

Ask for them only when you need them. The dot shows the login once in its reply, and your ChatGPT conversation keeps that message, so move the password into a password manager straight away. Some apps have no generated login because you create the first administrator inside the app.

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