WinCloud Open API and WinCloud MCP Server, by RBSHow to set up and fix common problems with the WinCloud MCP Server and the WinCloud Open API, and how to contact RBS.Effective: 22 October 2026
Last updated: 22 October 2026Choose the part you need:WinCloud MCP Server: for hotel staff using WinCloud in an AI assistant such as ChatGPT or Codex.
WinCloud MCP Server#
Ask an AI assistant questions about your hotel, such as bookings, rates and room status, and get answers from your live WinCloud data.Before you start#
Your WinCloud sign-in: Property ID, username and password. Your Property ID covers your hotels, which WinCloud calls locations.- An AI assistant: the Codex app, or a ChatGPT plan that lets you use plugins.
Set it up#
ChatGPT and Codex are both from OpenAI and share one plugin directory, so you find and install WinCloud the same way in each. The screenshots below are from the Codex app; where ChatGPT differs, the step says so.
1
Open Plugins
In the Codex app, select the plugins icon in the left sidebar. In ChatGPT, go to
chatgpt.com/plugins.
2
Find WinCloud
Find
WinCloud in the list of plugins.
3
Install the WinCloud plugin
Select
WinCloud, then
Install plugin. In ChatGPT, select the plus button.
4
Sign in to WinCloud
Your browser opens the
Sign in to WinCloud page. Enter your
Property ID,
username and
password, then select
Sign in.
5
Allow access
Under
Locations it can use, keep
All locations or choose the hotels the assistant can use. Check the list under
It will be able to, then select
Allow. Select
Deny to cancel.
If the page warns that the app "has not been checked by RBS", continue only if you started this connection yourself.6
Pick WinCloud in a chat
Start a new chat. In Codex, select
+ and choose
WinCloud under
Plugins. In ChatGPT, switch from
Chat to
Work, type
@ and select
WinCloud. Then type your question.
7
Read the answer
The assistant answers using your WinCloud data. You can ask follow-up questions in the same chat, or ask about another hotel by naming it.
Questions to try#
Replace Grand Hotel with your own hotel's name."Find bookings made this month at Grand Hotel."
"How many rooms are vacant and occupied right now at Grand Hotel?"
"List the room types at Grand Hotel whose name includes Deluxe."
"What are the room tariffs for December at Grand Hotel?"
Keep your assistant's approval setting on (Ask for approval in Codex), so you see each request before it runs.
Common problems#
| Problem | What to do |
|---|
| I cannot find WinCloud in the plugin list | Contact RBS Support. WinCloud may not be available to your account yet |
| The sign-in page shows an error | Check your Property ID, username and password, then try again |
| The assistant says "You don't have access to company …" | Your sign-in does not cover that hotel. Sign in again and choose it under Locations it can use. If it is not listed there, ask your RBS administrator for access |
| The assistant says it cannot answer questions about an area, for example rates | Your sign-in does not include that permission. Ask your RBS administrator to add it, then sign in again |
| The assistant does not use WinCloud to answer | Pick WinCloud in the chat, as in Pick WinCloud in a chat above, or mention WinCloud in your question |
| The assistant asks you to sign in again | Your sign-in has expired. Sign in and allow access again |
| The assistant says "The request could not be completed" | Wait a minute and try again. If it keeps happening, contact RBS Support |
| The assistant says "The WinCloud connection is not set up correctly" | Contact RBS Support |
WinCloud Open API#
For developers calling the WinCloud Open API directly.Check these first#
401 Unauthorized: your token has expired or is invalid. Get a new token and try once more. See Authentication. 403 Forbidden: your credentials lack the permission for that endpoint. Ask your RBS administrator. See Permissions. 404 Not Found: the record does not exist, or it belongs to another customer.
429 Too Many Requests: you asked for tokens too often. Wait, then reuse the token you already have.
Every status code is explained on General.What to include in your email#
The HTTP status and the errorCode or error_code
The environment (UAT or production) and the full URL you called
The date and time of the request, with your time zone
Your Client ID, but never your client secret
In the subject, write WinCloud MCP Server or WinCloud Open API, then describe the problem in a few lines.Never send passwords, client secrets, guest personal details or payment card details, in an email, a screenshot or a chat message. Describe the problem in general terms instead.
© 2026 RBS (Winsar Infosoft Private Limited). All rights reserved.