Add WinCloud to Claude, ChatGPT, Codex or another AI assistant as a custom MCP server, sign in, and check it works. This takes about five minutes.
Before you start#
A WinCloud user account with access to the hotels you need, and the permissions for the tools you want to use. See Permissions. An AI assistant that supports custom MCP servers. The tabs below cover Claude, Claude Code, ChatGPT and Codex, with a fallback for other assistants.
The server address: https://api.wincloudone.com/mcp. The steps below write it as {mcp_url}.
Step 1: Add the server to your assistant#
Works in Claude on the web and in Claude Desktop. Every Claude plan can add a custom connector; the Free plan is limited to one.
1
Open the connector settings
On Pro and Max, go to
Customize → Connectors, select
+ Add, then
Add custom connector. On Team and Enterprise, an organisation owner goes to
Organization settings → Connectors → Add → Custom → Web.
2
Enter the server address
Enter a name, for example
WinCloud, and enter
{mcp_url} as the URL. Select
Continue.
3
Choose how to sign in
Under
Authentication, keep
Sign in now. Under
OAuth client, keep
Register automatically. Select
Add.
4
Connect
Open WinCloud in your connector list, select
Connect, then sign in as described in
Step 2. On Team and Enterprise, each member then finds WinCloud in their own connector settings and selects
Connect to sign in with their own account.
Step 2: Sign in and allow access#
Your assistant opens the WinCloud sign-in page in your browser. You sign in there with your own WinCloud user account, never in the assistant itself.1
Sign in to WinCloud
Enter your property ID, username and WinCloud password, then select
Sign in.
2
Review the permissions
The next screen lists what the assistant is asking to read. It shows only permissions your account already has. Under
Locations it can use, select the hotels the assistant may read. The screen may say the app registered itself and has not been checked by RBS. This is expected when you add WinCloud yourself; continue only if you started the connection.
3
Allow access
Select
Allow. Your browser returns to your assistant and the tools you are allowed to use appear. Select
Deny to cancel.
The server checks your sign-in before it runs any tool. If your sign-in expires, your assistant asks you to sign in again.
Step 3: Check the connection#
Ask your assistant: "Which hotels can I see in WinCloud?" If it lists your hotels and their company codes, the connection works. This check needs no particular permission.
Permissions#
Each permission is called a scope. Your sign-in includes the scopes your WinCloud account has been granted, and a tool is listed only when your sign-in includes its scope.| Scope | Tools | Lets you |
|---|
reservations:read | search_bookings, get_reservation, get_reservation_analytics | Read bookings and booking analytics |
rates:read | get_rate_plans, list_master_rates, get_rate_configuration, list_rate_templates, search_room_tariffs, list_room_types, list_rooms, list_room_features | Read rate setup, nightly tariffs and rooms |
inventory:read | get_inventory | See today's room status |
guests:read | search_guests, get_guest_reservations | Find guests and their stays |
| None | list_companies | List the hotels your sign-in covers |
For example, a sign-in with only rates:read lists the rate and room tools plus list_companies, and no others. list_companies needs no scope of its own, but you need at least one of the other scopes to connect at all.Your sign-in covers only the hotels your account can access. Asking for another hotel returns "You don't have access to company" followed by the company code.
An AI assistant can be steered by instructions hidden in the data it reads. This is called prompt injection. Answers can contain guest names and booking details. Keep your assistant's tool-approval setting on, and check what it does with the answers before you share them.